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 git directory
   • git status
   • git pull origin master
   • git pull origin develop
4. Update the publication date in the XML file
5. Commit change
   • cd project-aon
   • export AONDIR=`pwd`
   • git add $AONDIR
   • git commit
6. Generate XHTML versions
   • export LANGS=en
   • ./common/scripts/build-xhtml.sh 05sots
     • omit book code to build all
     • 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
8. Generate ebooks
   • cd common/epub
   • make 05sots
     • to build all: make all-english
9. Merge to master branch
   • git push origin develop
   • git checkout master
   • git merge develop
10. Create tag of published XML
    • git tag -a 29thos-20200103
11. Publish changes and new tag
    • git push origin master --tags
12. 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
13. Upload staged data to server
    • scp -r 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
14. 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$'
15. Clean up staging area
    • cd $AONDIR/tmp
    • rm -r en
    • cd ..
    • rmdir tmp
16. 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/
17. If this is a new series
    • review the public site to ensure that all of the text is appropriate
      • Main.All of the Books
18. If this is a new book…
    • update the base package
    • update the new StatsKeeper book list
    • update StatsKeeper2
    • scp $AONDIR/en/xml/05sots.xml projectaon@projectaon.org:projectaon.org/en/xml/
    • ~/bin/load-file-sizes.sh
    • add its own page to Main and Books
    • update Progress
    • update Assignments
    • http://www.projectaon.org/editor/scripts/index.js
19. If this is a revision…
    • ensure that all links are present (e.g. the simple format and the flowchart) and accurate
20. 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
21. Report back to PA volunteer list