To generate the config.yml file to be used later in this Stepģ Edit the generated config.yml file to include installed Rubies. Run the following commands ruby dk.rb init Install the Ruby development kit from the same location above and extract it to path such as c:\devkit.
I used the portable version available hereġ Install the Ruby from and install it to path such as C:\rubyĢ Download “DEVELOPMENT KIT” installer that matches the Windows architecture and the Ruby version just installed. Python : I strongly recommend using 2.7.5 as opposed to version 3.Ruby & Ruby Development Kit : Can be installed from here.
This prefer when I am working on my office laptop which has Windows 7 installed on it.įollowing packages are required to setup Jekyll on Windows: Jekyll can also be made to run on Windows Operating System. Please see this article for more updated and authoritative source of instructions. Otherwise only the default localhost will work.Update (26/06/14): This article is bit outdated and no longer deemed official instuctions to get Jekyll running on Windows. If you want to further test your work on other local machines use The default will start a server on port 4000, which can be accessed in your web browser at localhost:4000. It is recommended to define server options in your _config.yml. Or if you want jekyll to watch for file changes To simultaneously test the generated HTML website run Jekyll with the -serve flag. To generate a static HTML website based on your Textile or Markdown documents run jekyll. usr/lib/ruby/2.7.0/rubygems/core_ext/kernel_require.rb:83:in `require': libruby.so.2.7: cannot open shared object file: No such file or directory - /home//.gem/ruby/2.7.0/extensions/x86_64-linux/2.7.0/psych-3.3.0/psych.so (LoadError) Gem-2.7 might throw errors of missing libraries, like the following. Troubleshooting gem-2.7 is missing various libraries To use an alternate style or create your own review the explanation on GitHub. The date defined in the filename will be used as the published date in the post. To use the default naming convention each file should be saved with the year, month, date, post titleĪnd end with the *.md or *.textile depending on the markup language used (e.g. The content of each blog post will be contained within a file inside of the _posts directorys. This is a basic template for each of your posts. YAML Front Matter blocks of each file (see: Creating a Post). This is a basic template for your website's general layout. This is a basic template for your index.html, which is used to render your website's index page.
For a full explanation check GitHub.Īdditionally, each file besides /_layouts/layout.html requires a YAML Front Matter heading. Next you need to create templates that Jekyll can process. Once you have configured your _config.yml to your liking you need to create the files that will be processed by Jekyll to generate the website.
Full explanation and a default configuration can be found on It includes numerous configuration settings, which may also be called as flags. The _config.yml file stores configuration data. Note: McGraw has also setup a more extensive default file structure on GitHub. | `-arch-linux-usb-install-and-rescue-media.textileĪ default file structure is available from Daniel McGraw's Jekyll-Base page on GitHub. | |-early-userspace-in-arch-linux.textile Additionally, you can try out Markdown using Gruber's online conversion tool.Ī default Jekyll directory tree looks like the following, where "." denotes the root directory of your Jekyll generated website. If you are unfamiliar with Markdown, Gruber's website presents anĮxcellent introduction. Then add the following line to your _config.yml. You can install RDiscount with Rubygems as root or through ruby-rdiscount package. A Perl and a Python implementation of MarkdownĬan be found in the official repositories, while numerous other implementations are available in theĪdditionally, it has been implemented in C as Discountīy David Parsons and a Ruby extension was written by Ryan TomaykoĪs RDiscount. Markdown is a markup language and text-to-HTML conversion toolĭeveloped in Perl by John Gruber. It is recommended that you install the current stable version 4.2.2 by gem install RedCloth -version 4.2.2.
Note: RedCloth, a module for using the Textile markup language in Ruby, fails to install with gcc 4.6.0 (see: RedCloth Ticket 215 and 219).