This adds dynamic navigation of headers of the current page in the sidebar. This is intended to help the user see what is on the current page, and to be able to more easily navigate it. The "current" header is tracked based on the scrolling behavior of the user, and is marked with a small circle. This includes automatic folding to help keep it from being too unwieldy on a page with a lot of nested headers. This includes the `output.html.sidebar-header-nav` option to disable it. I'm sure there are tweaks, fixes, and improvements that can be made. I'd like to get this out now, and iterate on it over time to make improvements. |
||
|---|---|---|
| .. | ||
| headings | ||
| individual | ||
| languages | ||
| rust | ||
| last.md | ||
| prefix.md | ||
| README.md | ||
| suffix.md | ||
| SUMMARY.md | ||
Demo Book
This is a simple demo book, which is intended to be used for verifying and validating style changes in mdBook. This contains dummy examples of various markdown elements and code languages, so that one can check changes made in mdBook styles.
This rough outline is :
- individual : contains basic markdown elements such as headings, paragraphs, links etc.
- languages : contains a
hello worldin each of supported language to see changes in syntax highlighting - rust : contains language examples specific to rust, such as play pen, runnable examples etc.
This is more for checking and fixing style, rather than verifying that correct code is generated for given markdown, that is better handled in tests.