From 283dfa3b732357fea06df89992a961bfc2e085ae Mon Sep 17 00:00:00 2001 From: tomjohnson1492 Date: Wed, 23 Mar 2016 23:07:59 -0700 Subject: [PATCH] color fix for sidebar, also added instructions for installing jekyll on windows --- _data/sidebars/mydoc_sidebar.yml | 4 ++ _data/urls.yml | 19 ++++++ css/customstyles.css | 7 ++- index.md | 2 +- mydoc/mydoc_install_jekyll_on_windows.md | 79 ++++++++++++++++++++++++ 5 files changed, 107 insertions(+), 4 deletions(-) create mode 100644 mydoc/mydoc_install_jekyll_on_windows.md diff --git a/_data/sidebars/mydoc_sidebar.yml b/_data/sidebars/mydoc_sidebar.yml index 52b3f76..7c61738 100644 --- a/_data/sidebars/mydoc_sidebar.yml +++ b/_data/sidebars/mydoc_sidebar.yml @@ -221,6 +221,10 @@ entries: url: /mydoc_install_dependencies/ output: web, pdf + - title: Install Jekyll on Windows + url: /mydoc_install_jekyll_on_windows/ + output: web, pdf + - title: Tag archives output: web items: diff --git a/_data/urls.yml b/_data/urls.yml index 6bb3ada..5e8e608 100644 --- a/_data/urls.yml +++ b/_data/urls.yml @@ -4,6 +4,18 @@ + + + + + +mydoc_homepage: + title: "Get started" + url: "/documentation-theme-jekyll/" + link: "Get started" + + + mydoc_release_notes_50: title: "5.0 Release notes" url: "/documentation-theme-jekyll/mydoc_release_notes_50/" @@ -298,6 +310,13 @@ mydoc_install_dependencies: +mydoc_install_jekyll_on_windows: + title: "Install Jekyll on Windows" + url: "/documentation-theme-jekyll/mydoc_install_jekyll_on_windows/" + link: "Install Jekyll on Windows" + + + mydoc_tag_archives_overview: diff --git a/css/customstyles.css b/css/customstyles.css index 87248a1..e8e2c9e 100644 --- a/css/customstyles.css +++ b/css/customstyles.css @@ -378,14 +378,15 @@ a.accordion-toggle, a.accordion-collapsed { color: #f5f5f5; } -/*.nav > li.active > a {*/ -/*background-color: #347DBE;*/ -/*}*/ +.nav > li.active > a { +background-color: #347DBE; +} .nav li a { font-size: 12px; line-height: 18px; padding: 2px 10px; + background-color: #f1f1f1; } .nav > li > a { diff --git a/index.md b/index.md index ff2dea8..964de1d 100644 --- a/index.md +++ b/index.md @@ -9,7 +9,7 @@ These instructions will help you get started quickly with the theme. The other t ## Make sure you can build a vanilla Jekyll site first -To get up and running with this theme, make sure you can build a vanilla jekyll site first. See the [Jekyll docs](http://jekyllrb.com/). If you're in Windows, you might want to [install Jekyll using Chocolately](https://www.google.com/search?q=install+jekyll+using+chocolately). +To get up and running with this theme, make sure you can build a vanilla jekyll site first. See the [Jekyll docs](http://jekyllrb.com/). If you're in Windows, you'll need to install Ruby and Ruby Dev Kit first. See {{site.data.urls.mydoc_install_jekyll_on_windows.link}} for details. ## Build this theme diff --git a/mydoc/mydoc_install_jekyll_on_windows.md b/mydoc/mydoc_install_jekyll_on_windows.md new file mode 100644 index 0000000..37ac026 --- /dev/null +++ b/mydoc/mydoc_install_jekyll_on_windows.md @@ -0,0 +1,79 @@ +--- +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 %} + + +## 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. +3. Extract Ruby onto your **C** drive in a folder called something like **RubyDevKit**. +3. Browse to the **RubyDevKit** location on your C drive using your Command Line Prompt. +3. Type `ruby dk.rb init` +3. 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. In the downloaded theme, *delete* the existing **Gemfile** and **Gemfile.lock** files. +1. Type `gem install bundler`. +2. Browse to the documentation-jekyll-theme directory. +3. Type `bundle init` +4. Open the Gemfile in a text editor. +5. Paste in the following: + + ``` + # A sample Gemfile + source "https://rubygems.org" + + gem 'wdm', '>= 0.1.0' if Gem.win_platform? + gem 'jekyll', '~> 3.1', '>= 3.1.2' + ``` + +6. Save and close the file. +7. Type `bundle install`. + +## Serve the Jekyll site + +1. Browse to the documentation-jekyll-theme directory. +2. Type `jekyll serve` +3. Go to the preview address in the browser. (Make sure you include the `/` at the end.)