Local development

Using Dev Container and Visual Studio Code

1. Install Dev Container extension

2. Press shift+command+p and type "Open folder in container"

3. Select "From 'Dockerfile'"

4. Click "OK"

5. Click "OK"

6. Wait (this can take a few minutes for the first build)

7. In the VSCode, open the terminal and type

   bundle update
   bundle install
   bundle exec jekyll serve --livereload --baseurl ''
   

8. Visit localhost:4000

9. You can now modify the posts in VSCode and see the changes instantly in your browser

References

• Developing inside a Container
• How to use Develop Jekyll (and GitHub Pages) locally using Docker containers

Directly on local machine

Note: You might face Ruby and Jekyll version conflicts when installing dependencies directly on your machine. Using Docker containers is a good way to separate your different projects environments.

bundle install
bundle exec jekyll serve --livereload

References

• Testing your GitHub Pages site locally with Jekyll

License

This theme is licensed under the MIT license © JeffreyTse.