OurBigBook Docs
The following IDs are reserved:
-: reserved as a path component anywhere in an ID, in both static and web output. This forbids-,-/child,parent/-, andparent/-/child._out: forbidden as the first component of an ID, to protect local build output..git: forbidden as the first component of an ID, to protect Git metadata.index: reserved to prevent collisions with the home page'sindex.html. This check also applies to headers inside scopes.
Other uses of hyphens, such as
my-article, and leading underscores, such as _toc and _1, are allowed. _out and .git are allowed in nested IDs such as parent/_out and parent/.git.OurBigBook uses the
-/ namespace for generated IDs. For example:- the table of contents uses the fixed ID
-/toc - elements without an explicit ID may receive automatically generated IDs of type
-/1,-/2and so on
If you use a reserved ID, you will get an error message such as:
error: tmp.bigb:3:1: The ID path component "-" is reserved for website routes: "-/toc"