# Install Jekyll and Bundler gems through RubyGems gem install jekyll bundler # Create a new Jekyll site at ./myblog jekyll new myblog # Change into your new directory cd myblog # Build the site on the preview server bundle exec jekyll serve # Now browse to http://localhost:4000
If you encounter any unexpected errors during the above, please refer to the troubleshooting page or the already-mentioned requirements page, as you might be missing development headers or other prerequisites.
gem install jekyll bundler installs the jekyll and bundler gems through RubyGems. You need only to install the gems one time — not every time you create a new Jekyll project. Here are some additional details:
bundleris a gem that manages other Ruby gems. It makes sure your gems and gem versions are compatible, and that you have all necessary dependencies each gem requires.
Gemfile.lock files inform Bundler about the gem requirements in your site. If your site doesn’t have these Gemfiles, you can omit
bundle exec and just run
bundle exec jekyll serve, Bundler uses the gems and versions as specified in
Gemfile.lockto ensure your Jekyll site builds with no compatibility or dependency conflicts.
jekyll new <PATH> installs a new Jekyll site at the path specified (relative to current directory). In this case, Jekyll will be installed in a directory called
myblog. Here are some additional details:
jekyll new .If the existing directory isn’t empty, you can pass the
jekyll new . --force.
jekyll newautomatically initiates
bundle installto install the dependencies required. (If you don’t want Bundler to install the gems, use
jekyll new myblog --skip-bundle.)
jekyll newuses a gem-based theme called Minima. With gem-based themes, some of the directories and files are stored in the theme-gem, hidden from your immediate view.
jekyll new myblog --blank
jekyll new, type
jekyll new --help.
When in doubt, use the
helpcommand to remind you of all available options and usage, it also works with the
jekyll help newor
jekyll help build.
Building a Jekyll site with the default theme is just the first step. The real magic happens when you start creating blog posts, using the front matter to control templates and layouts, and taking advantage of all the awesome configuration options Jekyll makes available.
© 2008–2018 Tom Preston-Werner and Jekyll contributors
Licensed under the MIT license.