Default:
false
For example:
would be placed under:
instead of
ourbigbook hello.bigb
out/html/hello.html
./hello.html
.Advantages:Disadvantages:
- 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
- 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.Implemented at: github.com/ourbigbook/ourbigbook/issues/163