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

{{PDF version|pdf file name without .pdf|size kb, number pages|file description}}

For example

{{PDF version|ROSE_Compiler_Framework|840 kb, 48 pages|ROSE_Compiler_Framework}}

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