Skip to content

rakudo/rakudo.org

Repository files navigation

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: