Get Ruby 1.9.3 (part of the RVM install if you follow that path - see below)
Get RubyGems 1.3.6 or above
Get GNU Wget 1.14
If on Linux, you might need to install stuff for nokogiri (
sudo yum install libxml libxml-devel libxslt libxslt-devel)
If on Linux, you need to install node.js for execjs (sudo yum install nodejs)
If on Mac OS, get XCode (needed for native gems)
Ruby like many other platforms has its dependency hell. We do recommend you use RVM to isolate your ruby runtimes as well as dependencies (gems). The RVM steps are optional though. If you are not going to use RVM have a look at the different installations options you have.
Note: This installation varies per OS, see details on rvm.io.
\curl -sSL https://get.rvm.io | bash is the simplest and no root allowed)
Note that for rvm to be activated you need to run as a login shell. When running
rvm it should tell you if
you are running in a proper terminal/login.
Set up the isolated environment for the site
# Do *not* run these as root. # The purpose of using rvm is to have non-root, user isolated and reproducible gem/ruby environment rvm install 1.9.3 rvm use 1.9.3 rvm gemset create jbosstools-website
Note: the project has a
.rvmrc file which will be used by rvm when you
jbosstools-website directory. This file will assume you have
the above installed.
Next, let’s retrieve the website.
git clone https://github.com/jbosstools/jbosstools-website cd jbosstools-website
If you see a message like this:
Gemset 'jbosstools-website' does not exist, 'rvm gemset create jbosstools-website' first, or
Then it is because you have rvm installed and forgot to run the rvm setup above.
This next step might take some time - it is installing all the required dependencies.
# do *not* run these as root gem install bundler bundle install
Note that if someone updates Awestruct or any dependent gem via the
management, you need to rerun
If you see a message like
Wait for a message like
[2014-01-06 11:48:01] INFO WEBrick::HTTPServer#start: pid=24294 port=4242to appear in the console (can take a few tens of seconds)
Open your browser to http://localhost:4242
Any change will be automatically picked up except for changes to
_partials files and changes in front-matters.
You might see warnings at startup like
That’s ok, it’s not your fault ;) It’s related to some Awestruct limitations.
You can install the livereload extension to get instant refresh in your browser when pages are regenerated by running guard.
The dependencies should already be installed by the Gemfile thus you just need to start guard:
# run these as root gem install guard guard-livereload guard start
Install the LiveReload extension in your browser and click on the button next to the Location to activate the extension.
Chrome users can install the v.2.0.9 extension from the Chrome Marketplace.
Firefox users should use v. 2.0.9 or newer of the LiveReload extension available from here. If you hit an issue where the browser disconnects just after it has connected, which means the server cannot push refresh commands to it, you are using an old plugin and should update it.
Using you local site, you can have a look at our survival guide to editing this website to get you started.
On Linux, serving the file may be atrociously slow (something to do with WEBRick).
Use the following alternative:
Go in your
awestruct --auto -P development
In parallel, go to the
python -m SimpleHTTPServer 4242
You should be back to millisecond serving :)
The content of this repository is released under TBD. Sample code available on this website is released under TBD.
By submitting a "pull request" or otherwise contributing to this repository, you agree to license your contribution under the respective licenses mentioned above.