How do you combine the autogenerated part today?

If I understand you correctly you could include empty md-files as placeholders for the html files and once mdbook generated the html you could replace the html file generated by mdbook by the ones that tool generates.
Would this solve the problem?

Yes it would solve my issue but the problem arise when i do a mdbook serve as it systematically replaces the generated HTML by the empty file in the output directory, which is very annoying. My suggestion to ignore the file in the summary would fix this issue ... Also there is no way to hook into the serve process to fix the generated part with a script myself.

I made a pr that adds a way for me to hook into the serve process and run a script. Works perfectly 😄 Now we wait for a review...

Thanks for the suggestion! However, this seems like a duplicate of #919.

I don't think making the webserver hookable is an approach I would want to take. The webserver is intended only for local development, and thus any integration wouldn't be appropriate for deployment.

If I understand correctly, this should not make the webserver hookable. This would add a post-processing step that runs after all the output-processors ran.

If I understand correctly, this should not make the webserver hookable. This would add a post-processing step that runs after all the output-processors ran.

Yes that is the intended use.

I don't think making the webserver hookable is an approach I would want to take. The webserver is intended only for local development, and thus any integration wouldn't be appropriate for deployment.

To be more clear, the problem with the serve command is i can't easily make my post process step run after the watcher rebuilds the book. But its way simpler for build mdbook build && ./post-build.sh
In my pr #2620 I added a way to do exactly that only for the serve command. I might also add pre-build command.

This would allow use cases like including generated markdown and html in the book:

./include-generated-md-files.sh && \ # include md files in the src directory
mdbook build && \
./include-generate-html-files.sh # patch the html files in the book

and

mdbook serve --pre-build "./include-generated-md-file.sh" --post-build "./include-generated-html-files.sh"

I actually have a case that might be similar to this. In the https://mdbooks.code-maven.com/ project all the md files are generated by an external program. Because of that the src folder is listed in .gitignore the watch does not get triggered.

So I run cargo run -- --report && mdbook build report

Where cargo run -- --report builds the md files in the report/src folder.

This conversation now encouraged me to try to setup a different way so I ran

cargo watch -s "cargo run -- --report && mdbook build report"

and this seem to solve the problem for me.

(And I just noticed that cargo watch is now archived: https://github.com/watchexec/cargo-watch so maybe I'll need another solution.)