Jekyll
Table of Contents
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
{: .note .warning} 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
{: .note .info} 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.
{: .note .info} Installation varies based on your operating system. See our guides for OS-specific instructions.