Add building of E-book formats to the toolchain and provide E-book builds

[cryzed]

Hey, it would be awesome if you could also provide E-Book formats. I know that one of Rust by Example's biggest feature is the "run example" feature, but it'd be naive to assume that's the only way people use it. I for example really like to just glance at the very well-documented code snippets along with the description and learn that way. Having this on my Kindle would be neat.

Same by the way goes for The Rust Programming Language Book, although some unofficial builds are available (which I assume are outdated by now).

I tried to run the provided Rust code to generate the SUMMARY.md on my own, but the paths within the executable seem to be hardcoded for *nix environments (or I'm doing something else wrong):

flow_control: os error
scope: os error
custom_types: os error

This is why it would be great if you could simply add building the E-book formats to the toolchain and keep them up-to-date with the website.

[steveklabnik]

We have an issue open in the main repo about the official book already :)

I'm not sure what the best way to provide these would be. Maybe we can have Travis do it somehow?

On Dec 30, 2015, 08:54 -0500, Chris Braunnotifications@github.com, wrote:

Hey, it would be awesome if you could also provideE-Book formats(https://github.com/GitbookIO/gitbook#output-formats). I know that one of Rust by Example's biggest feature is the "run example" feature, but it'd be naive to assume that's the only way people use it. I for example really like to just glance at the very well-documented code snippets along with the description and learn that way. Having this on my Kindle would be neat.

Same by the way goes forThe Rust Programming Language Book(https://github.com/steveklabnik/rustbook), although some unofficial buildsare available(https://killercup.github.io/trpl-ebook/)(which I assume are outdated by now).

—
Reply to this email directly orview it on GitHub(#684).

[mdinger]

I think I tried this once before but it didn't work for some reason. I would've been interested in the pdf but I don't think I put a lot of time into it. Also, we're on an older version of gitbook so the instructions provided there might not be accurate anymore.

[mdinger]

It does work. You go here, install the binary and tell gitbook to generate the pdf and ebooks. However, it royally botches the runnable examples when they're displayed.

To make this work, you'd probably have to create a stage2 just for exports like this and disable the special formatting and such that the runnable examples require. Then it would probably work correctly. Seems like a nuisance.

[steveklabnik]

since we've ported to mdBook, this is now a duplicate of https://github.com/azerupi/mdBook/issues/88

[hustcer]

I have just made a epub version of Rust by Example, if anyone need it just download from here: https://github.com/hustcer/open-books/blob/main/Rust%20By%20Examples.epub