Newton: Web Site
Newton uses Apache Forrest to generate this web site and the associated PDF manuals. Page source is managed in the Newton subversion repository.
Content structure
The main site content is in SVN under doc/content/xdocs, structured as follows:
- community
- Community information, like this document.
- concept
- Newton concepts.
- download
- Download links and release notes.
- example
- Newton examples and demos.
- reference
- Newton Reference material.
- task
- Task oriented pages, like HOWTOs.
- site.xml, tabs.xml
- These control the layout and content of the whole site and PDF documents.
The Developer Guide consists of content from concept, example, reference and task. When we have more reference information, we will split this into a separate manual.
Sample Content
Content can be written in XML, using the Forrest DTD, or in Open Office. Here are some sample documents:
- Forrest sample
- XML document source sample.xml
- Open Office sample
- ODT document source opendocument-writer.odt
- PDF sample
- Tests PDF rendering of Open Office document. It has to be done it two passes to render the embedded images correctly.
Building the Site
You need a local installation of forrest-0.8 and you should set the environment variable FORREST_HOME to point to it.
Change to the top-level doc directory and run ant. This will create the site in build/site.
The build script runs forrest in two passes to resolve images in Open Office documents. While you are developing new content, you can reduce the build time by using ant -Dpass=1.