Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Awestruct built static website for
HTML JavaScript Ruby CSS ApacheConf

Merge pull request #336 from lucaswerkmeister/roadmapLinks

Roadmap: turn milestone names into links
latest commit 371b94222d
@gavinking gavinking authored
Failed to load latest commit information.
.settings Eclips settings file to default to UTF8
_config Remove encoding nonsense
_data awfull spelling
_ext Added xml hilighting
_layouts new content in community section
_partials footer: Updated copyright year
blog Added blog about UK JUG tour
code Some further explanation on installing `ant-junit.jar`
community link to vjbug presentation
documentation Roadmap: turn milestone names into links
eclipse Move the eclipse update site to a sub-directory
images Add Lucas Werkmeister to team
js Roadmap: turn milestone names into links
stylesheets adjustments for new safari (more space for code example)
.awestruct_ignore Ignore Gemfiles when publishing the site
.project missing .project file
404.html.haml #26 Add 404 page and .htaccess
Gemfile Update to awestruct 0.5.5 Add warning on the bundler >=0 not found error
Rakefile Update Rakefile to make rake usable and use local gem bundles
download-archive.html.haml More download links to 1.1 Broken link
favicon.ico Fix #65, using a copy rather than a symlink for the benefit of folks … update features pages
index.html.haml minor

layout title tab author
Building the website
Emmanuel Bernard

How to build

A bit of Git, a bit a Ruby and you will get your local version of served.


  • Get Git
  • Get Ruby > 2.1
  • If on Mac OS:
    • Get XCode (needed for compilation of native gems)
  • If on Linux:
    • Get libxslt-dev - eg via sudo apt-get install libxslt-dev (may be called libxslt1-dev for some distros)

Install Git to your system. GitHub's help page is a good starting point. Emmanuel's blog on Git tips and tricks is useful too.


Ensure Rake is installed

Make sure Rake is available. It is often installed per default.

rake --version

If you get "command not found":

gem install rake

Ensure Bundler is installed

Make sure Bundler is available. It manages your Ruby gems locally to the project and prevents version conflicts between different Ruby projects. To quote from the website:

Bundler provides a consistent environment for Ruby projects by tracking and installing the exact gems and versions that are needed.

bundle -v

If you get "command not found":

gem install bundler

Get the source

git clone

Setup awestruct

rake setup
rake check

Note that on existing installs, you might see the following error

/Users/alice/.rvm/rubies/ruby-2.1.2/lib/ruby/2.1.0/rubygems/dependency.rb:298:in `to_specs': Could not find 'bundler' (>= 0) among 8 total gem(s) (Gem::LoadError)
        from /Users/alice/.rvm/rubies/ruby-2.1.2/lib/ruby/2.1.0/rubygems/dependency.rb:309:in `to_spec'
        from /Users/alice/.rvm/rubies/ruby-2.1.2/lib/ruby/2.1.0/rubygems/core_ext/kernel_gem.rb:53:in `gem'
        from /Users/alice/.rvm/gems/ruby-2.1.2/bin/bundle:22:in `<main>'
        from /Users/alice/.rvm/gems/ruby-2.1.2/bin/ruby_executable_hooks:15:in `eval'
        from /Users/alice/.rvm/gems/ruby-2.1.2/bin/ruby_executable_hooks:15:in `<main>'
rake aborted!

It is due to a partial or corrupt installation of the bundles that you need to clear. Do either of these operations:

rake clean[all]
# if that fails, do
rm -fR .bundle _tmp _bin

Then run the rake setup command again.

Serve the site locally

rake preview

Point your browser to http://localhost:4242

Any change will be automatically picked up except for _partials files, _base.css and sometimes new blog entries.

Which other tasks exist in the Rake build file?

rake --tasks

This will list the available tasks with a short description

How to also include the spec and ceylon doc pages

Is that obsolete?

Use ./ This will clone or refresh the spec, language and compiler repos into _tmp and build the appropriate artifacts before pushing them to the site.

If you have already run ./ and don't wish to rebuild the spec and ceylondoc, use

./ --light

to simply copy them to the website structure. This is much faster.

If your changes are not visible...

Panic! Then completely regenerate the site via:

rake clean preview

If serving the site is slow...

On Linux, serving the file may be atrociously slow (something to do with WEBRick).

Use the following alternative:

  • Go in your ~/ directory.
  • Run rake gen
  • In parallel, go to the ~/ directory
  • Run python -m SimpleHTTPServer 4242

You should be back to millisecond serving :)


The content of this repository is released under Creative Commons Attribution Share-Alike 3.0 Unported (CC BY-SA 3.0). Sample code available on this website is released under Apache Software License 2.0.

By submitting a "pull request" or otherwise contributing to this repository, you agree to license your contribution under the respective licenses mentioned above.


This website uses:

Something went wrong with that request. Please try again.