OurBigBook Docs
Outputs as OurBigBook Markup, i.e. the same format as the input itself!
While using
-O bigb is not a common use case, the existence of this format has the following applications:- automatic source code formatting e.g. with
--format-source. The recommended format, including several edge cases, can be seen in the test file test_bigb_output.bigb, which should be left unchanged by abigbconversion. - manipulating source code on OurBigBook Web to allow editing either individual sections separatelly, or multiple sections at once
- this could be adapted to allows us to migrate updates with breaking changes to the source code more easily. Alternatively on OurBigBook Web, we might just start storing the AST instead of source, and just rendering the source whenever users want to edit it.
Can be tested interactively with:
ourbigbook --no-db -O bigb --stdout --log=ast-simple test_bigb_output.bigbOne important property of the
bigb conversion is that is must not alter the AST, and therefore neither the final output, in any way.One good test is:
ourbigbook index.bigb &&
mv _out/html/index.html _out/html/old.html &&
ourbigbook --format-source index.bigb &&
ourbigbook index.bigb &&
diff -u _out/html/old.html _out/html/index.htmlThis was tracked at: github.com/ourbigbook/ourbigbook/issues/83