Quickstart
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 2.5.0 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
.
- Change into your new directory.
- Build the site and make it available on a local server.
- 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.