These are the source files of the articles published on http://perl5maven.com/ Copyright Gabor Szabo except where the =author field explicitly shows someone else. FORMAT ------- The format has evolved from POD, HTML and Docbook. It is now a mess. I know. I'll have to clean that up. The overview: In the header there are =key value pairs of meta information. The text between =abstract start =abstract end is displayed on the front pages and is included in the RSS/Atom feed. For internal titles <h2> is used <hl></hl> stands for highlight and usually code-snippets inside the text are marked with these. Other imporant pieces are marked with <b></b> Code snippets are wrapped in <code lang="perl"> </code> PROMOTION ---------- When articles are published they are posted to Google+, Twitter and sometimes even to Facebook. They are also posted on LinkedIN. An e-mail is sent out to the people who registered on the Perl 5 Maven site. Many of the articles are included the Perl Weekly newsletter. Once in a while I post a link to Reddit ( http://www.reddit.com/ ) but I'd rather see others post there if they find the article worth the mention. The same with Hacker News: https://news.ycombinator.com/ SEO explained in 5 words ------------------------ "Get links from trusted sources" ~ Jon Morrow The best promotion is if people find it worth to mention one of the articles in a blog post or in some other form. CONTRIBUTIONS ------------- (both article writers and translators, please read option 2 here: http://support.google.com/webmasters/bin/answer.py?hl=en&answer=1408986 and add the perl5maven.com site to the list of where you contribute. An add an 128x128 image of you to the img/ folder. TRANSLATIONS - LOCALIZATION --------------------------- There is the beginning of a Brazilian Portuguese translation in the https://github.com/szabgab/br.perl5maven.com repository. *) The file names (that become the URLs) should be in LOCAL_LANGUAGE, but use only ASCII characters. Transliterated to English. (I am not sure in this. Maybe a better thing would be to use LOCAL_LANGUAGE in the URLs?) http://support.google.com/webmasters/bin/answer.py?hl=en&answer=182192 *) The file names should more-or-less match the title of the page, they can contain words separated with dashes. *) Please add the header to each file (the meta information) including the planned publication date *) The links in the page should be working. If there is already a translation for the target page then link there, if it only exists in English then please use full URLs including the hostname http://perl5maven.com/ *) Please update the hidden(!) section of the perl-tutorial.tt to include the links to the entries. *) The text listing the author and the translator are added by the system and are driven from the header tags =author and =translator *) Each author and translator has to have an entry in the authors.txt file listing a nickname (\w characters only), The full name, the name of the image file containing their picture, link to their G+ profiles. *) Each author and translator needs to provide a picture in jpg or png format approximately 128x128 pixel size (an Avatar) to be shown at the bottom of each article *) Each author and translator should set up authorship by linking their Google+ profile to the CC.perl5maven.com site. (e.g. br.perl5maven.com for the Brazilian Porguguese translators) See http://support.google.com/webmasters/bin/answer.py?hl=en&answer=1408986