If given and true, forces a the link to be an external link.
Otherwise, the external is automatically guessed based on the address given as explained at Section 3. "External link".
Common use cases for the
external
argument is to link to non OurBigBook content in the current domain, e.g.:- link to the domain root path for Subdirectory deployments
- link non OurBigBook subdirectories. E.g., github.com/cirosantilli/cirosantilli.github.io/blob/master/index.bigb was rendered at cirosantilli.com, and contains links
\a[markdown-style-guide]{external}
to cirosantilli.com/markdown-style-guide, whose source lives in a separate non-OurBigBook repository: github.com/cirosantilli/markdown-style-guide/