title | permalink | redirect_from | lastmod | |||
---|---|---|---|---|---|---|
Jekyll |
/docs/jekyll/ |
|
2021-12-06T01:41:06.227Z |
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.
Jekyll requires the following:
- Ruby version {{ site.data.ruby.min_version }} or higher
- RubyGems
- GCC and Make
See [Requirements]({{ '/docs/installation/#requirements' | relative_url }}) for guides and details.
- Install all [prerequisites]({{ '/docs/installation/' | relative_url }}).
- Install the jekyll and bundler [gems]({{ '/docs/ruby-101/#gems' | relative_url }}).
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{:target="_blank"}
{: .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]({{ '/docs/installation/#requirements' | relative_url }}). If you still have issues, see [Troubleshooting]({{ '/docs/troubleshooting/#configuration-problems' | relative_url }}).
{: .note .info} Installation varies based on your operating system. See our [guides]({{ '/docs/installation/#guides' | relative_url }}) for OS-specific instructions.