Rakudo.org

This is the source code for https://rakudo.org.

Installation

To install into rakudo.org dir in current directory run:

git clone https://github.com/rakudo/rakudo.org &&
cd rakudo.org &&
cpanm -vn --installdeps .

Optionally, copy the Rakudo Star, Rakudo, and NQP binaries into binaries/ directory. You can use a different directory, but ensure to change it accordingly in conf.conf file, under binaries_dir key.

mkdir binaries
cp -R ~/some-location-with-binaries/* binaries/

To start development server, run:

./morbo

To start production server, run:

./hyp

If you need to stop it entirely later, run hypnotoad app.pl --stop

The servers listen on localhost, port 4242: http://localhost:4242

The production server automatically updates itself using the update-rakudo.org.sh script. That script updates the git checkout on the server and hot-reloads hypnotoad. Some changes require a full restart of the application to function properly. If the website behaves strangely after a change, try a cold restart of hypnotoad by manually stopping the server and starting it again as described above.

SASS

Note that running the site requires sass - you can either install the sass binary (e.g. with gem install sass, or using the perl module CSS::Sass). Sass is not installed automatically using the cpanm command above.

Debug Aid

Some areas of the site are platform-specific (e.g. showing a download link to a .deb file if the visitor is using Ubuntu). You can force a view for a specific platform by using platform query parameter. See process_platform_specific_content() in assets/main.js for valid values.

LICENSE

See LICENSE file for the details of the license of the code in this repository.

This repository also contains code authored by third parties that may be licensed under a different license. Such files indicate the copyright and license terms at the top of the file. Currently these include:

• jQuery and jQuery UI libraries: Copyright 2015 jQuery Foundation and other contributors; MIT License
• The Camelia image is copyright 2009 by Larry Wall. Permission to use is granted under the Artistic License 2.0, or any subsequent version of the Artistic License.
• Cover template for Bootstrap, by @mdo
• OpenIconic icons are licensed under MIT License and its fonts are licensed under SIL OPEN FONT LICENSE Version 1.1.
• platform.js is licensed under MIT License
• Twitter footer icon by blk from ShareIcon, MIT License
• IRC people icon from ShareIcon
• Signed file icon is by Sergei Kokota from ShareIcon