jekyll/docs/_docs/index.md

title	permalink	redirect_from
Quickstart	/docs/	/docs/home/ /docs/quickstart/ /docs/extras/

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 {{ site.data.ruby.min_version }} or higher
• RubyGems
• GCC and Make

See [Requirements]({{ '/docs/installation/#requirements' | relative_url }}) for guides and details.

Instructions

1. Install all [prerequisites]({{ '/docs/installation/' | relative_url }}).
2. Install the jekyll and bundler [gems]({{ '/docs/ruby-101/#gems' | relative_url }}).

gem install jekyll bundler

3. Create a new Jekyll site at ./myblog.

jekyll new myblog

4. Change into your new directory.

cd myblog

5. Build the site and make it available on a local server.

bundle exec jekyll serve

6. Browse to http://localhost:4000{:target="_blank"}

{: .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.