search

rust-embedded / book

Documentation on how to use the Rust Programming Language to develop firmware for bare metal (microcontroller) devices
https://docs.rust-embedded.org/book/
Apache License 2.0
1.08k stars 171 forks source link

epub/mobi/pdf version #132

Open asdfhjkl opened 5 years ago

asdfhjkl commented 5 years ago

First of all, thanks to all contributors for your great effort!

I wonder if I'm overlooking something but is there no downloadable version of this book? If not, how hard is it to compile a pdf/epub/mobi myself?

adamgreen commented 5 years ago

You might be able to click the printer icon in the upper right hand corner to print the document and then save it to a PDF instead of actually sending it to a printer. This works for me on macOS but it doesn't produce a ToC, just the pages of content.

I see that there is an open issue in the mdBook project for this.

asdfhjkl commented 5 years ago

I'm sorry for the late reply. Your suggestion works. I actually tried that before opening this issue but for some reason I got the impression that only the first page would be printed, which is wrong.

ildar commented 4 years ago

what about other e-book formats? epub, fb2 ? please reopen

ildar commented 3 years ago

@asdfhjkl ?

asdfhjkl commented 3 years ago

I don't know what the proper etiquette is for reopening issues, so let me say sorry in advance if this irks somebody. But since I apparently have the ability to reopen the issue and ildars question seems valid, I'll reopen it.

ryankurte commented 3 years ago

hey @ildar, @asdfhjkl, as far as i know nothing much has changed. we continue to use mdBook to generate the docs outputs, the open issue for epub/other outputs via mdBook remains https://github.com/rust-lang/mdBook/issues/88, and the top right corner print -> to pdf option is still about the easiest approach as far as i know.

there is an mdbook-epub plugin that may be worth a look (and mdbook-latex though from the docs this appears to immature just yet), if the former works convincingly we could probably add this to our CI infrastructure (and if you were up to trying it out and opening a PR if it works well enough that would be excellent).

with respect to multiple ebook formats, i think it is unlikely that we will opt to generate more than one ebook type, you may be better served by an app like calibre-ebook to convert between formats.

ildar commented 3 years ago

pdf: I suggest that adding the link to Print → to PDF to the 1st chapter would satisfy people. epub: Again, a link in the 1st chapter to the "EPUB" file would be ideal. If it's half-baked, then it's more or less ok also.

ildar commented 3 years ago

I'd like to see the ebook/epub links for all the books on this topic. Especially on this page: https://docs.rust-embedded.org/