A description of the process used to build articles on dev-archive.net

Tina Holmboe

• Before starting your edit the first time, check out a local copy of the repository: svn co svn+ssh://cssnu@login.extra.greytower.net/dev-archive.net. This will create a local copy of both the stage and production trees.
• Prior to begin (daily) work, update: svn up on the root level of the local copy created in (1).
• Make necessary changes. Remember to update the wmake.def file, and use svn add when adding files. See also svn help for other file handling tools.
• Check in local copy: svn ci -m "change details". This will updated http://stage.dev-archive.net
• The script ./bin/postCommit.sh will be run:
  1. wmake -t all is run with ./wmake.def as configuration, producing XHTML 1.1 files in /tmp/dev-archive.net/.
  2. Various silly links in the Awstats index file is corrected by way of sed.
  3. ./bin/updateIndex.pl5 is run. This will update the front page with an index of the last five updated documents, their authors and timestamp; as well as a list of abbreviations, quotations, and articles sorted by author.
  4. ./bin/createSitemap.pl5 is run. This will create a Google sitemap file in XML format in /tmp/dev-archive.net/
  5. The sitemap from (3) is gzip-compressed.
  6. ./bin/xhtml2html.pl5 is run. This will produce HTML 4.01 Strict files in /web/stage.dev-archive.greytower.net/root/. Images and CSS are copied into place during step 1.
  7. ./bin/xhtml2atom.pl5 is run. This will produce RSS/Atom data in /web/dev-archive.greytower.net/dev-archive.atom.
  8. Static files - the Google sitemap and the Atom feed - will be moved to the webroot.
  9. Permissions are corrected.
• Verify that your updates are correct on http://stage.dev-archive.net before proceeding.
• Run rsync -tav --exclude=env --exclude=wmake.def --exclude=robots.txt --exclude=test/ --exclude=awstats/ --exclude=bin/ --exclude=\*~ --exclude=.svn . ../prod/
• cd ../prod. If changes are made to wmake.def, do cp ../stage/wmake.def . and edit the wmake-file to remove all references to stage - it should be only one such, near the top.
• Do svn add on any file added to the stage-repository.
• Give the command svn ci -m "change statement for production here" - this will check in the production version, and update http://www.dev-archive.net.

Last modified 29^th of July 2007

webmaster@dev-archive.net