|
6 | 6 | - [Local setup on Windows](#local-setup-on-windows)
|
7 | 7 | - [Local setup using Docker (Recommended)](#local-setup-using-docker-recommended)
|
8 | 8 | - [Build your own docker image](#build-your-own-docker-image)
|
| 9 | + - [Have Bugs on Docker Image?](#have-bugs-on-docker-image) |
9 | 10 | - [Local Setup with Development Containers](#local-setup-with-development-containers)
|
10 | 11 | - [Local Setup (Legacy, no longer supported)](#local-setup-legacy-no-longer-supported)
|
11 | 12 | - [Deployment](#deployment)
|
@@ -76,6 +77,36 @@ $ docker compose up --build
|
76 | 77 |
|
77 | 78 | If you want to use a specific docker version, you can do so by changing `latest` tag to `your_version` in `docker-compose.yaml`. For example, you might have created your website on `v0.10.0` and you want to stick with that.
|
78 | 79 |
|
| 80 | +### Have Bugs on Docker Image? |
| 81 | + |
| 82 | +Sometimes, there might be some bugs in the current docker image. It might be version mismatch or anything. If you want to debug and easily solve the problem for yourself you can do the following steps: |
| 83 | + |
| 84 | +``` |
| 85 | +docker compose up -d |
| 86 | +docker compose logs |
| 87 | +``` |
| 88 | + |
| 89 | +Then you can see the bug! You can enter the container via this command: |
| 90 | + |
| 91 | +``` |
| 92 | +docker compose exec -it jekyll /bin/bash |
| 93 | +``` |
| 94 | + |
| 95 | +Then you can run the script: |
| 96 | + |
| 97 | +``` |
| 98 | +./bin/entry_point.sh |
| 99 | +``` |
| 100 | + |
| 101 | +You might see problems for package dependecy or something which is not available. You can fix it now by using |
| 102 | + |
| 103 | +``` |
| 104 | +bundle install |
| 105 | +./bin/entry_point.sh |
| 106 | +``` |
| 107 | + |
| 108 | +Most likely, this will solve the problem but it shouldn't really happen. So, please open a bug report for us. |
| 109 | + |
79 | 110 | ## Local Setup with Development Containers
|
80 | 111 |
|
81 | 112 | `al-folio` supports [Development Containers](https://containers.dev/supporting).
|
@@ -211,7 +242,7 @@ If you installed **al-folio** as described above, you can manually update your c
|
211 | 242 | # Assuming the current directory is <your-repo-name>
|
212 | 243 | $ git remote add upstream https://github.com/alshedivat/al-folio.git
|
213 | 244 | $ git fetch upstream
|
214 |
| -$ git rebase v0.14.2 |
| 245 | +$ git rebase v0.14.3 |
215 | 246 | ```
|
216 | 247 |
|
217 | 248 | If you have extensively customized a previous version, it might be trickier to upgrade.
|
|
0 commit comments