init Anerist
The "ansible" branch contains a somewhat reusable ansible configuration. Later, it should be converted to a more distributable format.
Clone it at https://github.com/immanetize/anerist .
The Aneristic Principle is that of APPARENT ORDER; the Eristic Principle is that of APPARENT DISORDER. Both order and disorder are man made concepts and are artificial divisions of PURE CHAOS, which is a level deeper that is the level of distinction making.
—A monkey
Anerist is a collection of Python scripts for buildbot. It processes documentation of a variety of formats and generates a website frontend for browsing all processed docs.
Builder roles
For each known markup format, Anerist provides three types of BuildFactories for processing.
Validation
A validation factory ingests changes from VCS and builds the document to test them. It may integrate unit tests such as those offered by emender.
If a build is successfully validated, new strings are generated for translation and pushed to a translation platform, currently Zanata.
Integration
An integration factory pulls translations from a centralized translation platform like Zanata and tests them. If the translated document is built successfully, the translations are committed to version control.
Production
A production factory builds the content in a format designed for web viewing and pushes it to a central location for later processing by the Assembler.
The Assembler
The Assembler processes a directory containing all production builds of all known documentation. It does not yet exist.