When a link is an internal path link this has the following effects:
- the correct relative path to the file is used when using nested scopes with
-S,--split-headers. For example, if we have:then in split header mode,= h1 == h2 {scope} === h3 \a[index.js]h3will be rendered toh2/h3.html.Therefore, if we didn't do anything about it, the link toindex.jswould render ashref="index.js"and thus point toh2/index.jsinstead of the correctindex.js.Instead, OurBigBook automatically converts it to the correcthref="../index.js" - the
_rawdirectory prefix is added to the link - existence of the file is checked on compilation. If it does not exist, an error is given.