OurBigBook CLI (`ourbigbook` executable)

OurBigBook CLI is the executable program called ourbigbook which comes when you install npm install ourbigbook. It is the main command line utility of the OurBigBook Project.

Its functionality will also be exposed on GUI editor support such as Visual Studio Code to make things nicer for non-technical users.

The main functionalities of the executable are to:

convert OurBigBook Markup files to HTML files or other formats
The HTML files can then be either viewd from your filesystem on a browser, or uploaded and hosted very cheaply or for free so that others can see it, e.g. on GitHub Pages.
publish your content, either to OurBigBook Web or as a static website

Or if you are a programmer: OurBigBook CLI is a Static Wiki generator that can be invoked from the command line with the ourbigbook executable.

OurBigBook CLI is how cirosantilli.com is published.

OurBigBook Web takes as input the exact same format of OurBigBook Markup files used by OurBigBook CLI. TODO support/improve import/export to/from OurBigBook Web, see also: -W, --web.

The OurBigBook CLI calls the OurBigBook Library to convert each input file.

Convert a .bigb file to HTML and output the HTML to a file with the same basename without extension, e.g.:

ourbigbook hello.bigb
firefox out/html/hello.html

Files named README.bigb are automatically converted to index.html so that they will show on both GitHub READMEs and at the website's base address:

ourbigbook README.bigb
firefox out/html/index.html

Convert all .bigb files in a directory to HTML files, e.g. somefile.bigb to out/html/somefile.html:

ourbigbook .

The HTML output files are placed right next to each corresponding .bigb.

The output file can be selected explicitly with: --outfile <outfie>.

Output to stdout instead of saving it to a file:

ourbigbook --stdout README.bigb

In order to resolve cross file references, this actually does two passes:

first an ID extraction pass, which parses all inputs and dumps their IDs to the ID database
then a second render pass, which uses the IDs in the ID database