Closed noatamir closed 1 year ago
copied from temporary transition repo "discover-handbook" https://github.com/numfocus/DISCOVER-handbook/issues/6
according to jupyter book documentation, references to sections and docs can be adding a label role like this:
(About=)
# About
then reference the "About" section anywhere in the cookbook as either {ref}
or as About\
[](About)
. In fact since this is a document it could also be referenced using the {doc}
directive or markdown as [](./About.md)
, see: Reference Content Files.
Most of the pages have Jekyll style metadata like this at the top of each page:
Jbook uses different metadata, need to research more, but it's built on top of Sphinx, so is similar. May not need them at all because jbook automatically creates table of contents and sections from markdown headers like
# Childcare
automatically.