Resources: Contacts: * ONLamp: chromatic * Pugs, Pugs repo: Audrey Tang * Useperl: Chris Nandor * Perl6 announce: URLs: * ONLamp: http://www.oreillynet.com/mt/ * Pugs: http://www.typepad.com/t/app/weblog * Useperl: http://use.perl.org/~yournickhere/journal Further notes: * Mail::Summary::Tools is used in the instructions. Obtain a copy from CPAN. You may find that you wish to create a configuration file to avoid repetition in the instructions included below. It is probably worth reading the documentation to understand the text file it produces for editing. * Markdown is used in the summaries. Here is a brief introduction: [link name](http://www.google.com) `foo` = C `foo` = F _foo_ = I *foo* = B * To include references to RT, use * To cross-link to a thread also included in the summary, use * If a thread should not be included in the summary, add the header 'hidden: this is the reason why it is excluded'. * Editor's information for use.perl.org is: http://use.perl.org/editorguidelines.shtml The mailing list is: use.perl-editors-subscribe@perl.org ################################################################# One-time: * Get an ONLamp account--use the contact email. Then, on the 'Create a new entry on this weblog' page, click 'Customize the display of this page', enable 'Text Formatting' and save. * Get guest author access to the Pugs Typepad blog (using the contact email). Then, in the 'Create a post' page, click on 'Customize the display of this page', enable 'Extended Post' in the Custom 'Post Screen Configuration' and save. * Create a useperl account, then request admin access using the contact email. * Subscribe to perl6-announce. * Check out the Pugs repository. svk co http://svn.pugscode.org/pugs/docs/summaries * Get a commit-bit to the Pugs repository (ask on freenode#perl6) * Create a cronjob to run mirror_nntp every 6 hours ################################################################# Weekly: Basic process: 1. Have mboxes created. ~/bin/mirror_nntp 2. Copy proto.yaml. 3. Import new threads. mailsum create -v -pdr -f 'august 1' -t 'august 19' -o 08-19.yaml -i p6_mailboxes/*.mbox 4. Create a text file (don't use --save to edit in place). mailsum edit --save --hidden --links --posters --dates --misc 08-19.yaml > 08.19.txt 5. Add summaries. 6. Import text file if required. mailsum edit --load -i 08-19.yaml < 08-19.txt 7. Repeat steps 2-5 as needed; you will be warned of new and out-of-date threads. Remove 'out-of-date' from the message headers when you have updated it. 8. Create a text file, spell check it, and import it. mailsum edit --save 08-19.yaml > 08.19.txt 9. Edit headers and footers in the yaml file. Typically, the header contains an interesting quote from the week's summaries. 10. Commit the file to the Pugs repository. 11. Generate standard HTML for ONLamp and Pugs. mailsum tohtml --body_only --compact 08-19.yaml > ~/.htdocs/pugs.html 12. Generate special HTML for Useperl. mailsum tohtml --body_only --compact --h2 p,b --h3 p,i 08-19.yaml > ~/.htdocs/useperl.html 13. Generate text for Perl6 announce. mailsum totext -s 08-19.yaml > 08-19-out.txt 14. Post. ONLamp posting: * 'Create a new entry on this weblog' * Put the section of HTML which appears between

tags in 'Title' * Select category 'Technical' * In 'Entry Body', paste the 'This week on the Perl 6 mailing lists' section * In 'Extended Entry', paste the remainder of the HTML * Add to 'Keywords' the following: 'perl perl6 summary' * Set 'Post Status' to 'Published' * Set 'Text Formatting' to 'None' * Preview the post, adjust as needed, and Save Pugs posting: * Click on 'Create a post' * Put the section of HTML which appears between

tags in 'Title' * Select category 'Summary' * In 'Entry Body', paste the 'This week on the Perl 6 mailing lists' section * In 'Extended Entry', paste the remainder of the HTML * Add to 'Keywords' the following: 'perl perl6 summary' * Set 'Post Status' to 'Published' * Set 'Text Formatting' to 'None' * Preview the post, adjust as needed, and Save Useperl posting: * Click on 'Write in journal' * Put the section of HTML which appears between

tags in 'Subject' * Select 'Summaries' for 'Journal Topic' * Select 'Comments Enabled' * Paste the entire HTML excluding the

section in to 'Entry' * Enable 'Submit' (allow this journal to be submitted as a story) * Preview the post, adjust as needed, and Save * At the top of the page (Admin section), click on 'X Submissions' * Click on the title of your post. Note that only short titles are allowed; check the title for truncation. * Remove from 'Intro Copy' all but 'This week on the Perl 6 mailing lists' section * Select preview * Paste the removed text in to 'Extended Copy' * Preview the post, adjust as needed, and Save Notes: There will be a delay of about 15 minutes before the story is visible. There is a 65535 character limit for posts; longer posts will have to be split. Perl6 announce posting: * Correct any bullet point or numbered lists in the text * Write a letter to perl6-announce@perl.org * Put the header in the subject line, and the rest of the text in the body