Welcome to polygen-docs, the "Polygen Documentation Revival" project.
Table of Contents
The Polygen Meta Language Spec (Live HTML preview links):
polygen-spec_EN.html— Englishpolygen-spec_IT.html— Italian
/archived/— archived copies of every document release./docs-src/— markdown source files and build toolchain.CONTRIBUTING.md— Contributors' Guidelines.LICENSE— GNU GPLv2 license.polygen-spec_EN.html— latest version of PML Spec (English).polygen-spec_IT.html— latest version of PML Spec (Italian).validate.sh— (for contributors) validates code styles consistency of source files (requires EClint).
The goal of this project is to gather all Polygen related documentation into a centralized repository for easier maintainance. All documents are written in markdown and converted to HTML through a customized toolchain leveraging pandoc, PP macros, Highlight and pandoc-crossref.
The pre-existing Polygen manual has been republished under the new title Polygen Meta Language Spec. The translation of the English manual is now complete, and both the Italian and English documents have been revised for this new edition.
This project is maintained by Tristano Ajmone and Polygen's author Alvise Spanò.
The manuals are released under the same license of Polygen: GNU GPL version 2 (or above).
Many thanks to Riccardo Bastianini for his great contribution in revising the text of the English edition and pointing out problematic code examples.
The toolchain for the creation of Polygen documents reuses some third party resources, all comptabile with the GPLv2 license.
For a full list of credits, and their licenses, see:
This section resumes the latest changes to the repository structure and its toolchain.
For a Changelog of the PML Spec documents, see archived/README.md.
In preparation for the v1.1.1 release of the documents, we've polished the repository and carried out some improvements:
- Documentation toolchain:
- Updated the third party dependencies to their latest versions:
- pandoc
v2.10.1. - pandoccrossref
v0.3.7.0a. - PP
v2.14.1. - Highlight
v3.57. - GitHub HTML5 Pandoc Template
v2.2.
- pandoc
- Switched from Ruby Sass to Dart Sass.
- Replaced with onchange the defunct multiwatch tool.
- Replaced the
conv_EN.shandconv_IT.shscripts withconvert.sh, a unified builder taking as parameter a supported locale (en|it) orall.
- Updated the third party dependencies to their latest versions:
- Repository improvements:
- Enforced code styles consistency via EditorConfig settings.
- Enabled Travis CI code styles validation of every commit and PR via EClint.
- Added Contributor's Guidelines.
Creation of the repository and first release (v1.1.0) of the new PML Spec documents, ported from HTML to Markdown sources.
The following third party tools versions are used to build the HTML documents:
- pandoc
v2.1. - pandoc-crossref
v0.3.0.0. - PP
v2.2.2. - Highlight
v3.42. - GitHub HTML5 Pandoc Template
v2.0.