Skip to content
HTML Perl CSS JavaScript Makefile Shell
Find file
Latest commit b476ad6 Apr 29, 2016 @zoffixznet zoffixznet Make link finder smarter
Commit 061cbe2 suggests not restricting <link>s by text/html will give bogus URLs, but some blogs do not have text/html

README.md

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
Something went wrong with that request. Please try again.