94 lines
3.4 KiB
Markdown
94 lines
3.4 KiB
Markdown
---
|
|
title: Install Jekyll on Windows
|
|
permalink: /mydoc_install_jekyll_on_windows/
|
|
keywords: jekyll on windows, pc, ruby, ruby dev kit
|
|
sidebar: mydoc_sidebar
|
|
---
|
|
|
|
{% comment %}
|
|
|
|
## Install Chocolately
|
|
|
|
1. Go to **Start** and type **cmd**.
|
|
2. Right-click the Command Line Prompt and select **Run as Administrator.**
|
|
3. Copy the following code:
|
|
|
|
```
|
|
@powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin
|
|
```
|
|
4. Right-click in the Command Line Prompt and select **Paste**.
|
|
5. Press **Enter**.
|
|
6. Close the Command Line Prompt.
|
|
|
|
## Install Ruby
|
|
|
|
1. Go to **Start** and type **cmd**.
|
|
2. Right-click the Command Line Prompt and select **Run as Administrator.**
|
|
3. Type the following:
|
|
|
|
```
|
|
choco install ruby -y
|
|
```
|
|
3. Press **Enter**.
|
|
4. Close the Command Line Prompt.
|
|
|
|
{% endcomment %}
|
|
|
|
{{site.data.alerts.tip}} For a better terminal emulator on Windows, download <a href="https://sourceforge.net/projects/console/">Console</a>. This terminal allows you to create tabs and gives you more functionality. {{site.data.alerts.end}}
|
|
|
|
## Install Ruby
|
|
|
|
1. Go to [RubyInstaller for Windows](http://rubyinstaller.org/downloads/).
|
|
2. Under **RubyInstallers**, download and install one of the Ruby installers (usually one of the first two options).
|
|
3. Double-click the downloaded file and proceed through the wizard to install it.
|
|
|
|
## Install Ruby Development Kit
|
|
|
|
1. Go to [RubyInstaller for Windows](http://rubyinstaller.org/downloads/).
|
|
2. Under the **Development Kit** section near the bottom, download one of the **For use with Ruby 2.0 and above...** options (either the 32-bit or 64-bit version).
|
|
3. Move your downloaded file onto your **C** drive in a folder called something like **RubyDevKit**.
|
|
4. Extract the compressed folder's contents into the folder.
|
|
5. Browse to the **RubyDevKit** location on your C drive using your Command Line Prompt.
|
|
|
|
{{site.data.alerts.tip}} To see the contents of your current directory, type <code>dir</code>. To drill into a directory, type <code>cd foldername</code>, where "foldername" is the name of the folder you want to enter. To move up a directory, type <code>cd ../</code>. To move into your user's directory, type <code>/users</code>.{{site.data.alerts.end}}
|
|
|
|
6. Type `ruby dk.rb init`
|
|
7. Type `ruby dk.rb install`
|
|
|
|
If you get stuck, see the [official instructions for installing Ruby Dev Kit](https://github.com/oneclick/rubyinstaller/wiki/Development-Kit).
|
|
|
|
## Install Bundler
|
|
|
|
1. Using the command line, browse to the folder where you downloaded the Jekyll theme.
|
|
2. Delete the existing **Gemfile** and **Gemfile.lock** files:
|
|
|
|
```
|
|
del Gemfile
|
|
del Gemfile.lock
|
|
```
|
|
|
|
1. Install Bundler: `gem install bundler`
|
|
3. Initialize Bundler: `bundle init`
|
|
|
|
This will create a new Gemfile.
|
|
|
|
4. Open the Gemfile in a text editor. You may need to use your File Explorer and browse to the directory, and then open the Gemfile in a text editor such as Notepad.
|
|
|
|
5. Remove the existing contents and paste in the following:
|
|
|
|
```
|
|
source "https://rubygems.org"
|
|
|
|
gem 'wdm'
|
|
gem 'jekyll'
|
|
```
|
|
|
|
6. Save and close the file.
|
|
7. Type `bundle install`.
|
|
|
|
## Serve the Jekyll site
|
|
|
|
1. Browse to the jekyll theme directory.
|
|
2. Type `jekyll serve`
|
|
3. Go to the preview address in the browser. (Make sure you include the `/` at the end.)
|