Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Awestruct built static website for ceylon-lang.org
Ruby JavaScript Shell
branch: M1_IDE

This branch is even with ceylon:M1_IDE

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
_config
_data
_ext
_layouts
_partials
bin
blog
code
community
documentation
eclipse/updatesite
images
js/sh
stylesheets
.gitignore
.htaccess
404.html.haml
README.md
download.md
index.html.haml

README.md

layout title tab author
code
Building the website
code
Emmanuel Bernard

How to build ceylon-lang.org

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

Infrastructure

  • get Git
  • get Ruby 1.8
  • if on Mac OS, get XCode (needed for native gems)

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.

Install Awestruct, a Ruby based site generator.

gem install awestruct 
#or
sudo gem install awestruct

The Awestruct version known to work is 0.2.3

sudo gem install awestruct --version 0.2.3

Get the website source from GitHub.

git clone git@github.com:ceylon/ceylon-lang.org.git

Serve the site locally

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

How to also include the spec and ceylondoc pages

Use ./build-site.sh. 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 ./build-site.sh and don't wish to rebuild the spec and ceylondoc, use

./build-site.sh --light

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

If your changes are not visible...

If for whatever reason you make some changes which don't show up, you can completely regenerate the site:

awestruct -d --force

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 ~/ceylon-lang.org directory.
  • Run awestruct --auto -P development
  • In parallel, go to the ~/ceylon-lang.org/_site directory
  • Run python -m SimpleHTTPServer 4242

You should be back to millisecond serving :)

License

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.

Something went wrong with that request. Please try again.