Default: false
If true place the HTML output under the out directory at out/html.
For example:
ourbigbook hello.bigb
would be placed under:
out/html/hello.html
instead of ./hello.html.
Advantages:
  • the source tree becomes cleaner, especially when using -S, --split-headers which can produce hundreds of output files from a single input file
  • if you want to track several .html source files in-tree, you don't need to add an exception to each of of them on the .gitignore as:
    *.html
    !/main.liquid.html
Disadvantages:
  • you have to type more to open each output file on the terminal
Generally we recommend starting out without this option, and enabling it as the project grows and you feel like the .html floating around in-tree are starting to annoy you too much.
This option is always forced to false when --outdir <outdir> is given.

Ancestors