rust-lang/rust-by-example

Render RBE to PDF with `mdbook-pandoc`

simonsan opened this issue 8 months ago · 0 comments

simonsan commented 8 months ago

Hey there,
@max-heller was a great help to comprehensive-rust and rust-patterns as they helped us set up rendering to PDF. I found these issues: https://github.com/rust-lang/rust-by-example/issues?q=is%3Aissue+pdf+is%3Aclosed stating that we should open another one with new information, when they come available. So here we are.

mdbook-pandoc has some pre-rendered examples in also of Rust-by-example and the book: https://github.com/max-heller/mdbook-pandoc?tab=readme-ov-file#rendered-books

Comprehensive Rust: https://google.github.io/comprehensive-rust/comprehensive-rust.pdf
Rust Design Patterns: https://rust-unofficial.github.io/patterns/rust-design-patterns.pdf

(At this point, I think it makes sense to write up a condensed tutorial how to add PDF support to an existing mdbook...)

Some Resources

Initial support PR: rust-unofficial/patterns#394
Adding download icon to menu bar: rust-unofficial/patterns@d96de40
Line wrapping in code blocks: rust-unofficial/patterns@3dd157b
Readme of mdbook-pandoc: https://github.com/max-heller/mdbook-pandoc?tab=readme-ov-file#getting-started