Giter Club home page Giter Club logo

raku.org's Introduction

raku.org

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

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

Multilingual translation

Chinese translation.

Guidelines

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 Raku audience.

  • If you have a Raku blog, get it included in the https://planet.raku.org feed. See the github 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 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 (Edge), and Safari. Please test layout changes. Lacking actual browsers to test in, you can use browsershots.org or browserstack.com.

  • 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.

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

Build

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:

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

Tip: if you remove source/archive directory, mowyw generation will run a lot faster. Useful for checking frequently-made changes.

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

raku.org's People

Contributors

2colours avatar abh avatar alexdaniel avatar alexey-t avatar ash avatar ccworld1000 avatar coke avatar froggs avatar hankache avatar jj avatar josiahdahl avatar lizmat avatar moritz avatar nxadm avatar patrickbkr avatar pmichaud avatar raiph avatar ranguard avatar raydiak avatar rba avatar rspier avatar stmuk avatar sumanstats avatar tbrowder avatar timbunce avatar timo avatar timtoady avatar trosel avatar tyil avatar zoffixznet avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

raku.org's Issues

Some Feedback

Fished out from https://news.ycombinator.com/item?id=10331008

  • Would be nice to make the intro copy more informative. Like: why would I want to use it as a developer? What does it look like compared to my favorite language?
  • Really like the examples, especially since I haven't done much with Perl 6. However, like Perl 5, it still looks like parseable line noise to the untrained eye. Would be nice to have some better explanations to go along with the code. Maybe not right on the homepage, but at least linked into it.
  • Would like to see the "For Newcomers" links on the "Documentation" page on the homepage.
  • This Issue: #36
  • The page looks fine. I think the "Fun" and "Whatever" pages could be merged. The front page should probably explain more why someone would want to use the language.
  • That said though, none of this is going to matter unless there's a good tutorial. Nothing currently available is cutting it as a tutorial.

move perl.org link on homepage.

perl.org is linked to off the Perl in "perl community" - I would recommend we move this link to be on "Perl 5", instead, earlier in the paragraph.

Remove links to the wiki

The wiki was setup a long time ago before we had any infrastructure; there's a lot of stale information there that we keep up to date on perl6.org itself.

  • remove any links to the wiki from perl6.org
  • cleanup the front page of the wiki so it has a link to perl6.org (+ camelia if you like), and a note that the wiki is "no longer actively maintained, please use perl6.org to look for information about perl 6"

#col1, #col2 div elements layout at < 972px;

The div elements with id #col1 and #col2 have a natural breakpoint at 971px. This causes the layout to look poor for these elements.
In the case of smartphones the two div elements overflow the device and are unreadable.

Perl6 FAQ - update information

Hi!

There is some information in the Perl 6 FAQ here: http://www.perl6.org/archive/faq.html

For example: "That said, there is a release date for Rakudo: In Q2 2010 Patrick Michaud will release a useful and usable (but not feature complete) Perl 6 compiler".
2010 has already passed, but I honestly don't know about this Topic. Did the release happen? Does anybody know? Otherwise, we could just remote the section and Point to pugs & parrot.

Also, planetsix.perl.org which is linked in section "Is there a release date set for perl 6.0 ?" is dead. Is it just down or can we remove it fro the list?

perl6.org should have source code on the front page

Here I am, a lapsed Perl programmer curious about Perl 6, and I'd like to see how the language is shaping up. Have you tried starting from the home page and seeing the minimal number of clicks you need to see actual code? I counted 4 (home page -> getting started -> examples -> category -> pl file)

Having code on the home page and above the fold, even if it's a trivial example, is an expectation that most developers would have of a programming language website in 2015.

High ideals definition

About this sentence in the homepage:

Like her world-famous big sister, Perl 6 intends to carry forward the high ideals of the Perl community.

It looks like that some people would be curious and would like to know more about these high ideals. Maybe high ideals could point on a place where these things have already been said clearly.

Add more to the Downloads page in regards to Installation

https://perl6.org/downloads/

There should be a canonical way to install and upgrade rakudo star. The more detail we give here, the easier it will be to help troubleshoot installation issues.

  • Have separate headings for each major platform
    • Mac section should discuss homebrew and whether that is a recommended method
    • Explain where things are installed and how to add them to your path
  • Do not include rakudobrew if it continues to be fiddly
  • Modern languages almost require a package manager of some sort. Include explanation / link to zef on this page?
  • Most of all, assume that the user is a beginner

Update community page

https://perl6.org/community/

  • Add link to perl6weekly
  • Make sure the mailing lists are still being maintained / used?
  • Add a whole block section about how to contribute
    • Help with docs
      • show an example of how to Fork the docs repo, add an example, and submit a PR
    • Help with education resources
      • write tutorials
      • blog about your learning experience with Perl 6
      • blog about a module or script you wrote in perl 6
      • contribute to exercism.io
    • Help with ecosystem
      • link to state of the ecosystem document and most wanted modules document
      • write modules

Make code samples runnable/editable in the browser

At the YAPC::NA Perl 6 hackathon someone (@Util maybe?) had the suggestion that the code samples on the front page of perl6.org should be runnable/editable. I believe the glot.io API could be used for this and @zoffixznet has already implemented such functionality on his site.

Resources Tab Nav Issues

When clicking on resources tab, the Documentation tab also shows up as active page.

untitled

Marking for Hacktoberfest.

The fix, I believe, involves replacing the doc nav marker with res and changing it to res in in the nav file as well.

Also, for consistency, easier maintenance, and lesser confusion, it's worth renaming the documentation directory to resources as it's now called, fixing the link in the nav, and pinging one of the site admins (I can do it when PR is ready) to add an .htaccess redirect to the new page.

Mention Matrix as an alternative to using webchat.freenode

Page in question: https://perl6.org/community/irc

I was reading this article and realized something. There are not many matrix users right now, and I see only 10 users on perl6 channel. However, it's a great way to make people stay. Once you join a channel it won't leave automatically when you close your browser, in fact you'll stay forever online and you'll be getting messages that were sent while your devices were off.

The link will look like this: https://riot.im/app/#/room/#freenode_#perl6:matrix.org
And those who are using Riot through the browser will have to click one button to join the channel. Those who don't have an account will have to create it, but I think that by mentioning this we should only be focusing on those who already have it.

And those who use desktop or phone apps will have to click “Room directory” and type #perl6:freenode.org in there.

Assigning myself so that I won't forget about this issue. But please free to work on it.

Hack on a compiler fails to mention rakudo

Hack on a Compiler

Hacking on Perl 6 innards is a lot easier than you would think, thanks to NQP, or Not Quite Perl. NQP is a subset of Perl 6 that is much smaller and simpler. The idea is to get NQP running on various backends (javascript, java, moar, etc) and then bootstrap the real deal (Perl 6) on top of NQP! Even if you don't know Perl6, you can get up to speed fairly fast with this NQP learning course.

Everything else in this section, it's correct not to mention Rakudo, but this is clearly about hacking on the Rakudo compiler.

More -Ofun

The -Ofun page looks quite empty, especially with the new page re-design.

It looks ugly.

No offense here, but, the splatter of colors really doesn't look very pleasing; atleast to me and several others I know of.

If you guys agree, I can definitely try to make it look better with a monochromatic color scheme, smooth background and bright buttons and such.

FSCK errors in repo

$ git clone https://github.com/perl6/perl6.org
Cloning into 'perl6.org'...
remote: Counting objects: 6355, done.
error: object 552c801ce329aab35ec7a165998e114da4edbd8e: zeroPaddedFilemode: contains zero-padded file modes
fatal: Error in object
fatal: index-pack failed

Here are the settings in my ~/.gitconfig that I believe are causing git to catch these issues:

[transfer]
    fsckObjects = true
[fetch]
    fsckObjects = true
[receive]
    fsckObjects = true

Fix DNS server configuration

Every sub-domain resolves and points to design.perl6.org

% dig anything.perl6.org

; <<>> DiG 9.8.4-rpz2+rl005.12-P1 <<>> anything.perl6.org
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 24305
;; flags: qr rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0

;; QUESTION SECTION:
;anything.perl6.org. IN A

;; ANSWER SECTION:
anything.perl6.org. 3600 IN A 213.95.82.53

;; Query time: 151 msec
;; SERVER: 208.67.222.222#53(208.67.222.222)
;; WHEN: Sat May 23 19:56:17 2015
;; MSG SIZE rcvd: 52

Synopsis

on https://perl6.org/specification/

move Synopsis to the 2nd entry, not the first. change the description to "historic Perl 6 design documents"

Also, change to "Synopses" since we have more than one.

Up-to-date rakudo release notice

Main page says:

Perl 6 Language Version 6.c and Perl 6 Rakudo Star 2016.04 Released!

But we already have 2016.07. Can we somehow ensure that it is always showing the proper information? For example, it may be part of the release process.

Split compilers into 2 sections.

We have one active compiler, and a bunch of others.

Let's have two sections; one with just rakudo, and another with a new heading, like "Historical Compilers" - in that section we can remove all the "not actively developed" tags.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.