Content structure #
romero uses the SUMMARY.md file at the root of the sources to know what
pages to include, in what order they should appear, what their hierarchy and
where the source files are.
Please see the sub-pages of this documentation for specific documentation on how the file is formatted. As an example, here’s the markdown source for this website, with the resulting nav as rendered to the left:
# fa-book Documentation## Getting started- [fa-book-open Romero Documentation](gs/README.md)- [fa-square-binary Compilation](gs/compilation.md)- [fa-bolt Quickstart](gs/quickstart.md)- [fa-glasses Compatibility with mdbook](gs/compatibility.md)## Creating content- [fa-folder-tree Content structure](cc/contentstructure.md) - [Sections](cc/cs/sections.md) - [Sub-Sections](cc/cs/subsections.md) - [Main pages & sub pages](cc/cs/main-sub-pages.md) - [Draft pages](cc/cs/draft.md) - [Icons](cc/cs/icons.md)- [fa-file-lines Markdown](cc/markdown.md) - [Paragraphs](cc/md/paragraphs.md) - [Headings](cc/md/headings.md) - [Unordered lists](cc/md/ul.md) - [Ordered lists](cc/md/ol.md) - [Task lists](cc/md/tl.md) - [Quotes](cc/md/quotes.md) - [Admonitions](cc/md/admonitions.md) - [Code blocks](cc/md/code.md) - [Includes](cc/md/includes.md) - [Images](cc/md/images.md) - [Tables](cc/md/tables.md) - [D2 diagrams](cc/md/d2.md) - [OpenAPI](cc/md/openapi.md) - [Math & Tex](cc/md/math.md) - [Footnotes](cc/md/footnotes.md) - [Smart Punctuation](cc/md/smart.md) - [Strikethrough](cc/md/strikethrough.md) - [Definition Lists](cc/md/definition-lists.md) - [Links](cc/md/links.md)## Command line- [fa-folder-plus init](cli/init.md)- [fa-server serve](cli/serve.md)- [fa-trowel-bricks build](cli/build.md)- [fa-broom clean](cli/clean.md)## Renders- [fa-code HTML](renders/html.md) - [Configuration](renders/html/configuration.md) - [Table of Contents](renders/html/toc.md) - [Search](renders/html/search.md) - [Text Fragment Linking](renders/html/text-linking.md) - [Themes](renders/html/themes.md)- [fa-file-code HTML Single Page](renders/html-single.md) - [Configuration](renders/html-single/configuration.md)# fa-book-atlas Guides- [fa-palette Writing a Custom Theme](guides/custom-theme.md)
100%