> For the complete documentation index, see [llms.txt](https://ykkim.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ykkim.gitbook.io/wiki/resources/jekyll.md).

# Jekyll

## Jekyll on Windows

{% embed url="<http://jekyllrb.com/docs/installation/windows/>" %}

While Windows is not an officially-supported platform, it can be used to run Jekyll with the proper tweaks

### Installing Ruby and Jekyll <a href="#installing-ruby-and-jekyll" id="installing-ruby-and-jekyll"></a>

#### Installation via RubyInstaller <a href="#installation-via-rubyinstaller" id="installation-via-rubyinstaller"></a>

The easiest way to install Ruby and Jekyll is by using the [RubyInstaller](https://rubyinstaller.org/) for Windows.

RubyInstaller is a self-contained Windows-based installer that includes the Ruby language, an execution environment, important documentation, and more.

We only cover RubyInstaller-2.4 and newer here. Older versions need to [install the Devkit](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit) manually.

1. Download and install a **Ruby+Devkit** version from [RubyInstaller Downloads](https://rubyinstaller.org/downloads/). Use default options for installation.
2. Run the `ridk install` step on the last stage of the installation wizard. This is needed for installing gems with native extensions. You can find additional information regarding this in the [RubyInstaller Documentation](https://github.com/oneclick/rubyinstaller2#using-the-installer-on-a-target-system)
3. Open a new command prompt window from the start menu, so that changes to the `PATH` environment variable becomes effective. Install Jekyll and Bundler using `gem install jekyll bundler`
4. Check if Jekyll has been installed properly: `jekyll -v`

\`\`

\`\`

## Windows Subsystem for Linux Installation Guide for Windows 10 <a href="#windows-subsystem-for-linux-installation-guide-for-windows-10" id="windows-subsystem-for-linux-installation-guide-for-windows-10"></a>

{% embed url="<https://docs.microsoft.com/en-us/windows/wsl/install-win10>" %}

In order to use the `wsl --install` simplified install command, you must:

* Join the [Windows Insiders Program](https://insider.windows.com/getting-started)
* Install a preview build of Windows 10 (OS build 20262 or higher).
* Open a command line window with Administrator privileges

Once those requirements are met, to install WSL:

* Enter this command in the command line you've opened in Admin mode: `wsl.exe --install`
* Restart your machine

The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for files to de-compress and be stored on your PC. All future launches should take less than a second.

You will then need to [create a user account and password for your new Linux distribution](https://docs.microsoft.com/en-us/windows/wsl/user-support).