azawawi / perl6.org

Source code for https://perl6.org/

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

It is rendered with mowyw every 15 minutes, so updates to the repository should also result in an update of perl6.org. If not, talk to moritz on #perl6.

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

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

• Be nice.

• Don't hesitate to link to pages you wrote yourself, if they are helpful to a broader Perl 6 audience.

• If you have a Perl 6 blog, get it included in the planetsix.perl.org feed instead. Talk to [Coke] on #perl6.

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

  • user's viewport is small (e.g. 800x600)
  • user resizes window

• We use Bootstrap3 and jQuery. Whenever possible, please use the facilities these frameworks provide, instead of rolling out something custom.

• We use SASS in style.scss to generate style.css. You can do that by running sass style.scss:style.css inside the source directory (add --watch flag to make it watch for changes and re-generate the CSS file). CSS is still valid SASS; if you don't know SASS, just write plain CSS. If you cannot run sass, please add your changes to style.css and ping @zoffixznet to add your styles to style.scss.

• We support the current and previous major releases of Chrome, Firefox, Internet Explorer, and Safari. Please test layout changes. Lacking actual browers to test in, you can use browsershots.org or browserstack.com.

• We spell "Perl 6" consistently with a non-breaking space. If you don't already have one, go get an editor with decent Unicode support.

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

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

To run this site locally:

• Install the following modules:

  cpanm App::Mowyw Text::VimColor Plack

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

  mowyw
  plackup
  

• Open http://localhost:5000/index.html in your browser