Project Aon

Jon >

1. Verify that all outstanding issues have been addressed
   • Errata
2. Comment Period
   • gblint
   • spellchecked?
   • all images (including action chart)?
3. Update local svn repo
   • svn status
   • svn update
4. Update the publication date in the XML file
5. Commit change
   • cd project-aon
   • export AONDIR=`pwd`
   • svn commit -m"..."
6. Generate XHTML versions
   • export LANGS=en
   • ./common/scripts/build-xhtml.sh 05sots
     • omit book code to build all
     • ./common/scripts/list-bookcodes-by-series.sh lw | xargs -L 1 ./common/scripts/build-xhtml.sh
     • Xalan is in libxalan2-java package on Debian/Ubuntu
7. Generate SVG graph
   • ./common/scripts/build-svg.sh 05sots
     • omit book code to build all
     • ./common/scripts/list-bookcodes-by-series.sh lw | xargs -L 1 ./common/scripts/build-svg.sh
8. Generate ebooks
   • cd common/epub
   • make 05sots
     • to build all: make all-english
9. Merge to svn trunk
   • cd $AONDIR
   • svn update
   • svn merge ^/trunk
   • check all merged trunk changes
   • svn commit -m"Merge trunk changes to hestangor-2024"
   • svn switch ^/trunk
   • svn merge ^/branches/hestangor-2024
   • rebuild, test, etc. as necessary
   • svn commit -m"Merge hestangor-2024 changes to trunk"
10. Create tag of published XML
    • svn copy ^/trunk ^/tags/2024-11-folmarn -m"Publish Folmarn 2024 updates"
    • svn delete ^/branches/hestangor-2024 -m"Delete hestangor-2024 branch"
11. Copy files to staging area
    • cd $AONDIR
    • mkdir tmp
    • cd tmp
    • ../common/scripts/copy-all-formats.sh 05sots
      • Note: It's possible to specify more than one book
      • ../common/scripts/copy-all-formats.sh 05sots 06tkot
      • ../common/scripts/list-bookcodes-by-series.sh lw gs | xargs ../common/scripts/copy-all-formats.sh
12. Upload staged data to server
    • Chose method:
      • scp -r en projectaon@projectaon.org:projectaon.org/
      • rsync -rtPz en projectaon@projectaon.org:projectaon.org/
    • standard to ~/projectaon.org/en/xhtml/lw/05sots/
    • simplified to ~/projectaon.org/en/xhtml-simple/lw/
    • simplified to ~/projectaon.org/en/xhtml-less-simple/lw/05sots/
    • graph to ~/projectaon.org/en/svg/lw/
    • epub to ~/projectaon.org/en/epub/lw
    • fb2 to ~/projectaon.org/en/fb2/lw
    • lrf to ~/projectaon.org/en/lrf/lw
    • mobi to ~/projectaon.org/en/mobi/lw
    • pdb to ~/projectaon.org/en/pdb/lw
13. Verify that all of the uploads work correctly
    • In the staging area:
      • find en -type f -print0 | xargs -0 md5sum > staging.md5
      • scp -r staging.md5 projectaon@projectaon.org:projectaon.org/
    • On the web server:
      • cd ~/projectaon.org/
      • md5sum -c staging.md5 | grep -v 'OK$'
      • rm -i staging.md5
14. Clean up staging area
    • cd $AONDIR/tmp
    • rm -r staging.md5 en
    • cd ..
    • rmdir tmp
15. Create All of the Books package
    [Note: this script is hard coded for English books]
    • cd ~/projectaon.org/
    • ~/bin/compress-all.sh
    • mv all-books.* en/pub/
16. If this is a new series
    • review the public site to ensure that all of the text is appropriate
      • Main.All of the Books
17. If this is a new book…
    • update the base package
    • update the new StatsKeeper book list
    • update StatsKeeper2
    • add its own page to Main and Books
    • update Progress
    • update Assignments
    • http://www.projectaon.org/editor/scripts/index.js
18. If this is a revision…
    • ensure that all links are present (e.g. the simple format and the flowchart) and accurate
    • cd projectaon.org/en/xml
    • svn update
19. Public Notification
    • (obsolete) update book's Bibliography page
    • (obsolete) revision date on book's page
    • file sizes on the Site.FileSizes page
      • ~/bin/load-file-sizes.sh
    • revision date on the Site.BookRevisionDates page
    • What's New
    • FAQ list of unpublished books
    • Google group
    • (obsolete) Topica
    • blog
20. Report back to PA volunteer list