Sources for the http://perl.pt website.
-
Add a new file in the posts directory:
src/posts
, the file name is used to create the URL for the new post. -
Use Markdown notation (basic introduction) to create the post.
-
Clone the header of other posts files so that everything gets generated correcly, something like:
<blank line>
# Title
<blank line>
yyyy-mm-dd, por Author <e-mail>
<blank line>
<Text goes here>
After this you can write whatever you want. HTML weaved in you post is also ok.
-
Do not forget to proofread your post. Use a spell checker.
-
Push the changes to the repository, open a pull request, ...
-
If you need an image in your post, commit the image to the
src/imgs
directory and use an absolute path for it, eg:/imgs/myimage.png
. If you want to use a generic icon, as the APPP Onion logo, the Camelia butterfly or other, check if there is one already on theimgs
folder, and try to reuse it. -
The currently used MarkDown to HTML converter does not support code blocks surrounded by a line of back-ticks. Instead, indent the code block using spaces.
-
Wait for the next build of the site.
perl6
, Rakudo Star is a good option (how-to-get-rakudo)- the markdown converter used for now is written in Perl 5, so you need Text::Markdown installed, this will be upgraded to a Perl 6 module soon-ish
- the following Perl 6 modules are required (check panda to install modules):
Once you have everything set up correctly just run;
$ perl6 build.p6
And the site will be generated in a dist/
directory.