HugoSilvaSantos.github.io

Local Development With Docker

Build Docker Image

docker build -t pages-env .

Run Docker Container And Serve The Site

docker run --rm -it \
  -p 4000:4000 \
  -v "$(pwd)":/site \
  -e JEKYLL_GITHUB_TOKEN=example_token \
  pages-env

Browse to http://127.0.0.1:4000 after the container boots to view the site.

Notes

• Mounting the project directory (-v "$(pwd)":/site) lets Jekyll pick up edits without rebuilding the image.
• If you omit JEKYLL_GITHUB_TOKEN, the page still builds but omits the repository list (and the template will show an info message instead).
• Set JEKYLL_GITHUB_TOKEN to a personal access token (read-only scope) if you want the site.github repository data to render locally; omit it to preview layout only.