Jekyll uses the Minima theme by default, but this can easily be changed. For example, the Jekyll website you are currently on uses the domain name, so that’s the url value used for this website. The url setting is what Jekyll uses to determine the domain name of your website.
If your blog or website will be at, enter /blog as the baseurl. For example, if your Jekyll website will be at, leave the baseurl blank. The baseurl setting is only used if your blog or website is not going to sit at the root of your domain name. twitter_username : jekyllrb github_username : jekyll # Build settings theme : minima plugins : - jekyll-feed Baseurl and Url blog url : " " # the base hostname & protocol for your site, e.g. baseurl : " " # the subpath of your site, e.g. It will appear in your document head meta (for Google search results) and in your feed.xml site description. Title : Your awesome title email : description : >- # this means to ignore newlines until "baseurl:" Write an awesome description for your new site here. You can now close the command prompt and open up a fresh one, because now that we have Ruby installed, it’s time to install Jekyll! In the new command prompt, execute the command: Running ridk install to setup MSYS2 and the development toolchain Simply enter 1 in the command prompt to install the MSYS2 base installation. You’ve almost installed Ruby on Windows! Once finished the installation wizard, you should see a command prompt to setup MSYS2 and the development toolchain. Completing the Ruby+DevKit with MSYS2 Setup Wizard On the last step, you’ll want to keep the option “Run ‘ridk install’ to setup MSYS2 and development toolchain.” checked.
Make sure to download a recent Ruby+DevKit version and use the default options in the installation wizard.
Jekyll is written in Ruby as a gem, so to run Jekyll on Windows we’ll first need to download and install RubyInstaller for Windows.
You’ll also need Visual Studio Code (or a similar code editor), Git for Windows (or your favorite Git client) and a GitHub account if you would like to use GitHub Pages. In order to follow along with this tutorial, you’ll need to be using a recent version of the Windows operating system. Jekyll is easy to install on macOS and Linux, but there are a few extra steps required to be able to use Jekyll on Windows. Simply write your blog posts in Markdown and if you choose to host your website using GitHub Pages, you can use Git to commit and push your changes to publish new posts or pages. Jekyll has no admin interface, only source files that you can build using a CLI (command line interface) to create a static website. With Jekyll you don’t need to worry about all of that. Why am I and thousands of other bloggers deciding to move to a static site generator? It’s a no-brainer! Why should we install security updates, manage plugins and tune the performance of a website so our pages load fast? Blogging should be all about the writing!
Nearly a year ago I migrated from the popular blogging platform WordPress to the static site generator Jekyll.
How to Create a Blog Using Jekyll and GitHub Pages on Windows If that doesn’t help or you are using an older template, please try installing webrick globally using gem install webrick or adding it to your project Gemfile using bundle add webrick in the project directory.How to Create a Blog Using Jekyll and GitHub Pages on Windows - Kilt and Code Kilt and Code First, the CB template “Gemfile” includes webrick, so make sure you are using bundle exec jekyll s. On Windows it may appear as if nothing is happening for a very very long time, since the terminal does not provide a progress bar, be patient!ĭebugging Note: if you have Ruby version 3.0+ and Jekyll version 4.2.0 or less, when using Jekyll you may encounter an error in your terminal including “cannot load such file – webrick (LoadError)”. This process will take awhile as Gem installs all the dependencies and builds extensions. Because Jekyll is a complex Gem with many dependencies, they recommend using Bundler to keep everything in working order. Bundler is a Ruby utility to manage dependencies on per project basis. This will install the Gems “Jekyll” and Bundler.