Repository files navigation

This is the source code forhttps://raku.org.

It is rendered withmowywevery 15 minutes, so updates to the repository should also result inan update ofhttps://raku.org

Chinese translation.

Here are some guidelines that you should respect when changing this site:

• Only link to up-to-date information. Feel free to delete outdatedinformation — it is often more confusing than helpful.

• Be nice.

• Don't hesitate to link to pages you wrote yourself, if they are helpful toa broader Raku audience.

• If you have a Raku blog, get it included in thehttps://planet.raku.org feed.See thegithub repo

• If you intend to change the layout, consider what happens when:

  • user's viewport is small (e.g. mobile device)
  • user resizes window

• We useBootstrap3 andjQuery. Whenever possible, please use the facilitiesthese frameworks provide, instead of rolling out something custom.

• We useSASS instyle.scss to generatestyle.css. You can do that by runningsass style.scss:style.css insidethesource directory (add--watch flag to make it watch for changesand re-generate the CSS file). CSS is still valid SASS; if youdon't know SASS, just write plain CSS. If you cannot runsass, pleaseadd your changes tostyle.css and ping @zoffixznet to add your stylestostyle.scss.

• We support the current and previous major releases of Chrome, Firefox,Internet Explorer (Edge), and Safari. Please test layout changes. Lacking actualbrowsers to test in, you can usebrowsershots.orgorbrowserstack.com.

• Speaking of which, all pages are served as UTF-8.

• If you create a new page, please link to the URLwithout the".html" extension.

• When referenced the first time in a section, use Raku®, but Rakudo™ or Camelia™.

To run this site locally:

• Install the following modules:

  cpanm App::Mowyw Text::VimColor Plack IO::Socket::SSL HTML::Template::Compiled Mojolicious

• Run the following commands to populate the./online folder and launch a local web server for testing:

  mowywplackup

• Openhttp://localhost:5000/index.html in your browser

Tip: if you removesource/archive directory,mowyw generation will run alot faster. Useful for checking frequently-made changes.

SeeLICENSE 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. Suchfiles 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 theArtistic License 2.0, or any subsequent versionof the Artistic License