OurBigBook Docs
Reference to a non-first header of another file:
\x[h2-in-not-the-index]which renders as:
To make toplevel links cleaner, if the target header is the very first element of the other page, then the link does not get a fragment, e.g.: and not:while
\x[not-index] rendered as:<a href="not-index"<a href="not-index#not-index"\x[h2-in-not-the-index] is rendered with the fragment:<a href="not-index#h2-in-not-the-index"Reference to the first header of another file that is a second inclusion:
\x[included-by-not-index]which renders as:
Reference to another header of another file, with
full:\x[h2-in-not-the-index]{full}.which renders as:
Note that when full is used with references in another file in multi page mode, the number is not rendered as explained at: Section "\x full argument in cross file internal links".Reference to an image in another file:
\x[image-not-index-xi]{full}.which renders as:
Reference to an image in another file:
\x[image-figure-in-not-the-index-without-explicit-id]{full}.which renders as:
Remember that the ID of the toplevel header is automatically derived from its file name, that's why we have to use:
\x[not-index]which renders as:
instead of:\x[not-the-index]Reference to a subdirectory:
\x[subdir]
\x[subdir/h2]
\x[subdir/notindex]
\x[subdir/notindex-h2]which renders as:
Implemented at: github.com/ourbigbook/ourbigbook/issues/116Reference to an internal header of another file: h2 in not the index. By default, That header ID gets prefixed by the ID of the top header.
When using rather than:This is why IDs must be unique for elements across all pages.
--embed-includes mode, the cross file internal links end up pointing to an ID inside the current HTML element, e.g.:<a href="#not-index"><a href="not-index.html/#not-index">