Skip to content

Instantly share code, notes, and snippets.

@ssebelius
Created October 22, 2016 03:37
Show Gist options
  • Save ssebelius/2ca0ae75120a9af784c48286d79828c5 to your computer and use it in GitHub Desktop.
Save ssebelius/2ca0ae75120a9af784c48286d79828c5 to your computer and use it in GitHub Desktop.
1) Download RubyInstaller - http://dl.bintray.com/oneclick/rubyinstaller/rubyinstaller-2.3.1-x64.exe
2) Open the Ruby installer and select the "Add Ruby executables to your PATH" option
3) Install Ruby
4) Download the following file: http://dl.bintray.com/oneclick/rubyinstaller/DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe
5) Follow the instructions: https://github.com/oneclick/rubyinstaller/wiki/Development-Kit. Pay attention to "4. Run Installation Scripts"
![capture](https://cloud.githubusercontent.com/assets/3046398/19616641/85aba072-97cd-11e6-94f1-59b62ba1c3d7.PNG)
6) Open the command prompt - start => "command prompt"
7) Enter "ruby -v" to make sure ruby is installed
C:\Users\Scott> ruby -v
ruby 2.3.1p112 (2016-04-26 revision 54768) [x64-mingw32]
8) Download the following file: https://github.com/rubygems/rubygems/releases/download/v2.2.3/rubygems-update-2.2.3.gem
9) Move the downloaded file to the C:\ drive
10) Follow the instructions here for "INSTALLING USING UPDATE PACKAGES"
http://guides.rubygems.org/ssl-certificate-update/
11) In the command prompt: gem install bundler
12) Download the documentation_source.zip file and extract to a folder
13) Navigate in the command prompt to the folder
14) Enter in the command prompt: "bundle install"
15) If you run: "bundle exec middleman" you should see the following:
E:\Versus\developer-documentation-master>bundle exec middleman
== The Middleman is loading
Please add the following to your Gemfile to avoid polling for changes:
gem 'wdm', '>= 0.1.0' if Gem.win_platform?
Please add the following to your Gemfile to avoid polling for changes:
gem 'wdm', '>= 0.1.0' if Gem.win_platform?
== View your site at "http://Scott-PC.local:4567", "http://192.168.1.68:4567"
== Inspect your site configuration at "http://Scott-PC.local:4567/__middleman",
"http://192.168.1.68:4567/__middleman"
16) In the web browser go to http://localhost:4567 and you should see the docs
17) To stop the process type "Ctrl + C" in the command prompt
While you are editing and making changes you can keep the middleman server running. Just reload the page and the changes should show up.
If you want to build the changes run "bundle exec middleman build". This will build the files into HTML in the `build` folder.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment