https://github.com/crowdagger/books
Tries to provide PDF and EPUB versions of various (maybe) Rust books
https://github.com/crowdagger/books
Last synced: over 1 year ago
JSON representation
Tries to provide PDF and EPUB versions of various (maybe) Rust books
- Host: GitHub
- URL: https://github.com/crowdagger/books
- Owner: crowdagger
- License: apache-2.0
- Created: 2017-03-27T06:05:28.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-08-14T18:10:38.000Z (almost 8 years ago)
- Last Synced: 2025-02-27T12:16:45.494Z (over 1 year ago)
- Language: Shell
- Homepage:
- Size: 25.5 MB
- Stars: 99
- Watchers: 16
- Forks: 14
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# Some Rust books conversion
The purpose of [this repository](https://github.com/lise-henry/books)
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*](https://github.com/rust-lang/book), which you
can look at here:
## Second edition
(Last updated: 2017-06-11)
* PDF: [A4](http://lise-henry.github.io/books/trpl2-a4.pdf), [Letter](http://lise-henry.github.io/books/trpl2-letter.pdf), [A5](http://lise-henry.github.io/books/trpl2.pdf)
* [EPUB](http://lise-henry.github.io/books/trpl2.epub)
## First edition
(Last updated: 2017-06-11)
* PDF: [A4](http://lise-henry.github.io/books/trpl1-a4.pdf), [Letter](http://lise-henry.github.io/books/trpl1-letter.pdf), [A5](http://lise-henry.github.io/books/trpl1.pdf)
* [EPUB](http://lise-henry.github.io/books/trpl1.epub)
## 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](https://github.com/lise-henry/crowbook) 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](https://github.com/lise-henry/crowbook), yet another
converter from Markdown books to PDF, EPUB and HTML. The [book
configuration file](https://github.com/lise-henry/books/blob/master/trpl2.book) 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](https://github.com/rust-lang/book) is mirrored
to the `trpl2.book` file here.
## License
[*The Rust Programming Language*](https://github.com/rust-lang/book)
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:
* [Killercup provides PDF and EPUB versions of *The Rust Programming
Language* and of *The rustonomicon*](https://killercup.github.io/trpl-ebook/).