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
See Requirements for guides and details.
Instructions
- Install all prerequisites.
- Install the jekyll and bundler gems.
gem install jekyll bundler - Create a new Jekyll site at
./myblog.jekyll new myblog - Change into your new directory.
cd myblog - 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.