Skip to content

Latest commit

 

History

History
178 lines (139 loc) · 4.42 KB

install-awestruct.adoc

File metadata and controls

178 lines (139 loc) · 4.42 KB

Install Awestruct

In this tutorial, we will:

  1. Install RVM

  2. Setup a Ruby gemset

  3. Install Awestruck

  4. Check the version of Awestruct via the commandline

Check Your Ruby version

$ ruby --version
# ruby 1.9.3p848 (2013-11-22 revision 40747) [x86_64-linux]
Important
You must use the 32-bit version of Ruby 1.9.3 on Windows.
Windows install steps:
  1. Download Ruby Installer from http://tiny.cc/ruby193win

  2. Run installer, select default location

  3. Check "Add Ruby executables to your PATH"

  4. Configure RubyGems:

    (echo install: --no-rdoc --no-ri) > C:\ProgramData\gemrc
    (echo update: --no-rdoc --no-ri) >> C:\ProgramData\gemrc

Install RVM

If you’re using Linux or OSX, open a Terminal window and type the following commands:

Linux and OSX
$ \curl -L https://get.rvm.io -o rvm-installer
$ bash rvm-installer --ruby=2.0.0
Windows

Use Ruby as normal. Skip any RVM steps.

Tip
The RVM equivalent for Windows is named pik.

Create and use a new Ruby gemset (RVM only)

On the commandline, type:

$ rvm use 2.0.0@writeadapt --create
Tip
If you want to use Ruby 1.9.3, replace 2.0.0 with 1.9.3.

Install Awestruct

On the commandline, type:

$ gem install tilt --version 1.4.1
$ gem install awestruct --version 0.5.4.rc3
$ gem install asciidoctor
Console output
Successfully installed tilt-1.4.1
1 gem installed

HEADS UP! Haml 4.0 has many improvements, but also has changes that may break
your application:

* Support for Ruby 1.8.6 dropped
* Support for Rails 2 dropped
* Sass filter now always outputs <style> tags
* Data attributes are now hyphenated, not underscored
* html2haml utility moved to the html2haml gem
* Textile and Maruku filters moved to the haml-contrib gem

For more info see:

http://rubydoc.info/github/haml/haml/file/CHANGELOG.md

Successfully installed haml-4.0.4
Building native extensions.  This could take a while...
Successfully installed nokogiri-1.5.10
Successfully installed rb-fsevent-0.9.3
Building native extensions.  This could take a while...
Successfully installed ffi-1.9.3
Successfully installed rb-inotify-0.9.2
Successfully installed rb-kqueue-0.2.0
Successfully installed listen-1.1.6
Successfully installed sass-3.3.0.rc.2
Successfully installed multi_json-1.8.2
Successfully installed compass-core-1.0.0.alpha.13
Successfully installed chunky_png-1.2.9
    Compass is charityware. If you love it, please donate on our behalf at http://umdf.org/compass Thanks!
Successfully installed compass-1.0.0.alpha.13
Successfully installed compass-960-plugin-0.10.4
Successfully installed bootstrap-sass-3.0.2.1
Successfully installed zurb-foundation-4.3.2
Successfully installed mime-types-1.25
Successfully installed rest-client-1.6.7
Successfully installed ruby-s3cmd-0.1.5
Successfully installed rack-1.5.2
Successfully installed awestruct-0.5.4.rc3
20 gems installed

Successfully installed asciidoctor-0.1.4
1 gem installed

Check version of Awestruct

On the commandline, type:

$ awestruct --version
Console output
Awestruct: 0.5.4.rc3
http://awestruct.org/

Next: Setup a new website project with Awestruct