gitea-pages/mydoc/mydoc_install_jekyll_on_windows.md

title, permalink, keywords, sidebar

title	permalink	keywords	sidebar
Install Jekyll on Windows	/mydoc_install_jekyll_on_windows/	jekyll on windows, pc, ruby, ruby dev kit	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
   

4. Press Enter.

5. Close the Command Line Prompt.

{% endcomment %}

{{site.data.alerts.tip}} For a better terminal emulator on Windows, download Console. This terminal allows you to create tabs and gives you more functionality. {{site.data.alerts.end}}

Install Ruby

1. Go to RubyInstaller for Windows.
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.

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 dir. To drill into a directory, type cd foldername, where "foldername" is the name of the folder you want to enter. To move up a directory, type cd ../. To move into your user's directory, type /users.{{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.

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
   

3. Install Bundler: gem install bundler

4. Initialize Bundler: bundle init

   This will create a new Gemfile.

5. 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.

6. Remove the existing contents and paste in the following:

   source "https://rubygems.org"
   
   gem 'wdm'
   gem 'jekyll'
   

7. Save and close the file.

8. 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.)