Much of the publishing process is automated: Write: * Develop stories in "content.wiki". The file is (almost) an instance of the HWN data type, defined in utils/publish.hs (if you want to understand the 'almost', look at the 'tweak' function in utils/publish.hs). * Urls are in [http://a.b.c/ text] wiki format. * You can use the planethaskell, gmane, and quotes tools (all in util) to help you gather material. Read the source of each tool for usage and examples. * Preview the issues with "make" which dumps rendered .txt, .tex, .html and .wiki files in the top level dir. "make show" will render the issue and then open the .html file in w3m. * pdf frontpage can be viewed with "make pdf" When complete: * Don't forget to write an editorial (if desired) * Check urls: urlcheck *.html * Generate: ./publish -p which moves the .html, .tex, .wiki and .pdf versions into the archives/ (suitable for email and sequence.complete.org), and also the wiki versions (Old_news.html and News.html). This also runs the spell checker, which requires aspell installed. The issue number will be extracted (and then incremented) from 'issue' (with -p) * The date comes from the current date. * Check the archives/*.pdf file, and regenerate archives/*.tex until it all fits on one pdf page. Publish: * Html: + upload archives/yyyymmdd.html to sequence.complete.org (you must already have an account, and need special privileges to post the HWN, talk to John Goerzen (CosmicRay)) - log in - Create content > Story - use a title like "Haskell Weekly News: Month day, year" - choose "Haskell Weekly News" from Categories list - choose "General News" from Type list - paste archives/yyyymmdd.html into the body field (the xclip utility can help with this) - under "Input format", choose "Full unfiltered HTML" - under "URL path settings", enter "hwn/yyyymmdd" (without the quotes) - under "Publishing options", select "Published" and "Promoted to front page" * Email summary and url to lwn@lwn.net: The October 31, 2006 edition of the Haskell Weekly News is online. This week we see a number of community documentation and maintenance efforts, and the appearance of indexed data types in GHC. * Email: + archives/yyyymmdd.txt to haskell@haskell.org + be sure to send in a plain text format, don't use mime/alternative parts (careful, some mailers do this automatically without your knowledge) * For good issues, post url to programming.reddit.com, suggested title: "Haskell Weekly News: headline summary" Record: * darcs whatsnew -sl * darcs add * darcs record --all * darcs tag * darcs push