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.