Jekyll is a static site generator. It takes text written in your favorite markup language and uses layouts to create a static website. You can tweak the site’s look and feel, URLs, the data displayed on the page, and more.
Prerequisites
Jekyll requires the following:
- Ruby version ** or higher
- RubyGems
- GCC and Make
If you want to use Github Pages, here are the dependencies
Instructions
- Create a new Jekyll site at
./mysite
.
cd ~/github/
jekyll new mysite
- Change into your new directory.
cd mysite
- Build the site and make it available on a local server.
bundle exec jekyll serve
- Browse to http://localhost:4000
If you are using Ruby version 3.0.0 or higher, step 5 may fail. You may fix it by adding webrick
to your dependencies: bundle add webrick
Pass the --livereload
option to serve
to automatically refresh the page with each change you make to the source files: bundle exec jekyll serve --livereload
If you encounter any errors during this process, check that you have installed all the prerequisites in Requirements. If you still have issues, see Troubleshooting.
Installation varies based on your operating system. See our guides for OS-specific instructions.