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). -
Edit
prod/env
and set update=no -
Make necessary changes. Remember to update the
wmake.def
file, and usesvn add
when adding files. See alsosvn 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:-
wmake -t all
is run with./wmake.def
as configuration, producingXHTML 1.1
files in/tmp/dev-archive.net/
. - Various silly links in the Awstats index file is corrected by way of sed.
-
./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. -
./bin/createSitemap.pl5
is run. This will create a Google sitemap file in XML format in/tmp/dev-archive.net/
- The sitemap from (3) is gzip-compressed.
-
./bin/xhtml2html.pl5
is run. This will produceHTML 4.01 Strict
files in/web/stage.dev-archive.greytower.net/root/
. Images and CSS are copied into place during step 1. -
./bin/xhtml2atom.pl5
is run. This will produce RSS/Atom data in/web/dev-archive.greytower.net/dev-archive.atom
. - Static files - the Google sitemap and the Atom feed - will be moved to the webroot.
- 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 towmake.def
, docp ../stage/wmake.def .
and edit the wmake-file to remove all references tostage
- 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.