`include` does not work in SUMMARY.md

rust-lang / mdBook

Create book from markdown files. Like Gitbook but implemented in Rust

https://rust-lang.github.io/mdBook/

Mozilla Public License 2.0

17.67k stars 1.61k forks source link

`include` does not work in SUMMARY.md #2287

Open nicholashaydensmith opened 8 months ago

nicholashaydensmith commented 8 months ago

Problem

This is a reopening of issue #1116

I think this feature would provide the most natural way to support auto-generated documentation. One could autogen a whole tree of md's and then a snippet TOC that gets included in SUMMARY.md.

colommar commented 7 months ago

Hello! I have a question. Some articles in the mdbook don't have obvious signs indicating the order of the chapters, so how can I make sure that they are in order when automatically generating the README.md file? Or is random generation sufficient.

deerchao commented 1 month ago

This feature would be really useful.

jplwill commented 3 weeks ago

Agreed, I'd really like to see this happen.