ROSE Compiler Framework/TODO

What is missing (so you can help if you want)

How to backup/mirror this wikibook?
Just in case this website is down, how to download a backup of this wiki book?

How to set up a mirror wiki website containing the wikibook of ROSE?

Maintain the print version
It is possible that new chapters are added but they are not reflected in the one-page print version. So periodical synchronization is needed by including more chapters or re-arranging their order in the one-page print version.

Observations:
 * A print version is similar to a source file with included contents, each included chapter will have a first level of heading
 * Because the first level heading (=) is used by the print version page to include all chapters, all included pages/chapters should NOT contain any first level heading.

With the basic understanding of how this work, you can now edit the print version's wiki page:
 * Print version

More at: http://en.wikibooks.org/wiki/Help:Print_versions

Maintain the better pdf file
The pdf version automatically generated from the print version page is rudimentary. It has no table of content and pagination etc.

So we used a manual process to generate better pdf file. We need to occasionally repeat this process to have a up-to-date and better pdf file.

Here are the manual steps:
 * Use your web browser to open and save the print version to your own computer as "web page complete"
 * use the HTML-compatible word processor of your choice to open the html file, convert html to a format the word processor, and add paginate the book.
 * In Microsoft Word, this can done by
 * opening the saved HTML file
 * saving it to a word file
 * adding table of content by selecting Insert > Field > Index and Tables > TOC or Preferences-> Table of contents for Word 2012 or later.
 * adding page numbers to the footer
 * save it to a pdf file with a name like ROSE_Compiler_Framework.pdf
 * upload to wikibooks

To add a link to your wikibook page, insert

For example

More background about pdf verions: at: http://en.wikibooks.org/wiki/Help:Print_versions

Documentation Alternatives
1. Google Docs: comments, different output formats, easy collaboration 2. AsciiDoc