A Pandoc-based framework for improving the authoring and reviewing experience of C++ proposals for WG21.
In short, you write your papers in Markdown with various C++ proposal-specific extensions, and the framework produces the paper either in HTML or PDF.
The detailed documentation is written with the framework itself (see MANUAL.md), and published as a user's guide in HTML and PDF:
The framework has rendering tests and per-paper Makefile layout tests under tests. The expected HTML and LaTeX output for the rendering tests is checked in under tests/expected.
From the repository root:
make check # run rendering and paper.mk testsFrom tests, the following commands are available:
cd tests
make check # run rendering and paper.mk tests
make expected # overwrite the checked-in HTML/LaTeX expected/ output
make heading.html # build a specific test case into generated/heading.html
make # build all of the test cases in all formats into generated/
make html # build all of the test cases in HTML format into generated/
make latex # build all of the test cases in LaTeX format into generated/
make pdf # build all of the test cases in PDF format into generated/make check verifies that the rendered HTML and LaTeX have not changed, and
also checks the per-paper Makefile layout. If a rendering change is expected,
run make expected, review the diff, and check in the updated files under
tests/expected.
Distributed under the Boost Software License, Version 1.0. See LICENSE.md.