Rendered Rust Book example

[afranke]

The README has a link to a rendered PDF of the Rust Book. This ouput doesn’t very LaTeX-y, unlike e.g. the Cargo Book one. How was this result achieved?

Also, the Ferris images on page 8 don’t appear. Not sure whose fault it is, so I didn’t file an issue for it.

[max-heller]

Hi Alexandre, the sample books are rendered by #[test]s in lib.rs -- in particular, this one for the Rust book:

mdbook-pandoc/src/lib.rs

Lines 1596 to 1607 in 24b1beb

	#[test]
	#[ignore]
	fn rust_book() {
	let logs = MDBook::load(BOOKS.join("rust-book"))
	.config(Config {
	hosted_html: Some("https://doc.rust-lang.org/book/".into()),
	..Config::pdf()
	})
	.build()
	.logs;
	insta::assert_snapshot!(logs);
	}

Config::pdf() mainly just configures fonts and page margins, which may be what makes it not look very "LaTeX-y":

mdbook-pandoc/src/lib.rs

Lines 512 to 540 in 24b1beb

	fn pdf() -> Self {
	toml! {
	keep-preprocessed = false
	[profile.pdf]
	output-file = "book.pdf"
	to = "latex"
	pdf-engine = "lualatex"
	[profile.pdf.variables]
	documentclass = "report"
	mainfont = "Noto Serif"
	sansfont = "Noto Sans"
	monofont = "Noto Sans Mono"
	mainfontfallback = [
	"NotoColorEmoji:mode=harf",
	"NotoSansMath:",
	"NotoSerifCJKSC:",
	]
	monofontfallback = [
	"NotoColorEmoji:mode=harf",
	"NotoSansMath:",
	"NotoSansMonoCJKSC:",
	]
	geometry = ["margin=1.25in"]
	}
	.try_into()
	.unwrap()
	}

It probably makes sense to point to this config from the README but I wasn't sure of the best way to do so without having the link/config go stale eventually.

[afranke]

Config::pdf() mainly just configures fonts and page margins, which may be what makes it not look very "LaTeX-y":

Indeed! The fonts and margins are usually what gives away the use of LaTeX. Thanks.

[max-heller]

unlike e.g. the Cargo Book one

Could you elaborate on this?

[afranke]

Huh. I don’t know what I was looking at yesterday, but the Cargo book I just downloaded now also has that styling. Sorry about the confusion.

[max-heller]

Also, the Ferris images on page 8 don’t appear.

I think the issue here is that the Ferris images are in <img> tags, which pandoc doesn't parse as an image from markdown. This will need a preprocessing pass to convert them to Markdown's ![]() image syntax

[max-heller]

Implemented in #124!