Home

Awesome

Some Rust books conversion

The purpose of this repository is to try to provide PDF and EPUB vesions of Rust books. Currently, there is only an early attempt at converting the The Rust Programming Language, which you can look at here:

Second edition

(Last updated: 2017-06-11)

First edition

(Last updated: 2017-06-11)

Why?

Because these books are great but I personally prefer to read on a ereader than on computer screen. Plus my pet project is building yet another converter from Markdown books to PDF, EPUB and HTML converter from Markdown books to PDF, EPUB and HTML, so I wanted to know if it could work on this kind of books.

Status and what's next

The PDF and EPUB files are existing, so it somewhat works. They could be better, though. Inner links don't work. The toc is quite messy. There are probably a ton of quirks.

I'd also like to try to see how this works on other books. Later. Maybe.

How?

I used Crowbook, yet another converter from Markdown books to PDF, EPUB and HTML. The book configuration file is here.

If you want to play with that too, you'll need the Github version of crowbook, since I had to do some tweaking to get The Rust Lang Book to work under it.

$ git clone https://github.com/lise-henry/crowbook
$ cargo install

Then

$ git clone https://github.com/lise-henry/books/
$ cd books
$ crowbook trpl2.book
$ crowbook trpl1.book

Since the source files are in a git submodule you might need to do some git magic. Honestly, I am not sure of how that works so I won't be able to help you on that.

Keeping these versiong up to date should not be too difficult, as long as the structure of the Summary.md file in the source repository is mirrored to the trpl2.book file here.

License

The Rust Programming Language books are dual licensed under the Apache 2 and MIT License.

Other EPUB/PDF versions of Rust books

Other people have converted Rust books to PDF and EPUB: