Single webpage / pdf / epub / mobi #218

hjr3 · 2016-08-23T02:28:43Z

Is there the possibility of having a version of the Book in a single web page or pdf format? I want to search across the chapters and having them be separate links makes this difficult to do so.

carols10cents · 2016-08-23T12:50:30Z

There is https://github.com/killercup/trpl-ebook, but I'm not sure if @killercup has tried the scripts on the new book yet.

This would be nice to have, but we probably won't get to it until after we get the book printed... actually an ebook/pdf would probably be a side effect of that as well :)

But we'd love help getting @killercup's scripts or some other method to work in the meantime!

carols10cents · 2017-02-20T19:02:18Z

Also see https://github.com/azerupi/mdBook/issues/29

steveklabnik · 2017-02-20T19:05:40Z

Oh also, the print button in the upper right gives you a single page.

carols10cents · 2017-03-27T00:04:22Z

o.O Why did I link to mdbook issue #29... I should have linked to https://github.com/azerupi/mdBook/issues/88

adamvoss · 2017-04-07T22:18:34Z

Not a helpful final solution, but for anyone looking wanting something right now, I had decent success getting Calibre to convert the HTML to a book, though there were some manual steps. Here is a copy at 072e7d7.

The Rust Programming Language - 072e7d7ad8fe4e269455561da5d2bbf3bfa460b8 .epub.zip

jasonwilliams · 2017-04-28T09:30:50Z

Whoever has done the single webpage / print long version (with the whole thing) thank you, i can now read it all without worrying about net connection for every chapter.

Is it possible to have the single page option not tied to print? So my tablet doesn't ask me if i want to print it out every time i press it?

Would love to see a generated PDF option now so i can download it.

carols10cents · 2017-04-28T13:41:45Z

@Jayflux You'll want to follow https://github.com/azerupi/mdBook/issues/88 for progress on that, basically we're using mdBook so we're capable of doing whatever mdBook is, and mdBook doesn't have support just yet :)

michelboaventura · 2017-05-21T00:17:48Z

To read the book on my Kindle I've just build it and convert the print.html version to a mobi file using kindlegen. Works flawless.

sorin-davidoi · 2018-01-16T09:09:55Z

mdBook has support for building as epub in master.

singalen · 2018-12-06T21:56:23Z

mdBook 0.2.2 didn't build an epub for me. mdbook-epub complained that it needs mdbook 0.1.0, but sees 0.2.2.

@sorin-davidoi are you sure standalone mdbook can generates epubs?

Here's what worked for me:

# add empty `[output.epub]` section to `book.toml`.
cargo install mdbook-epub
cargo install mdbook --vers "^0.1.0" --force
mdbook build

Profit!

Maybe mdbook-epub just needs to be recompiled with mdbook 0.2.2.

iBooks claimed the epub is invalid, but I was able to open it in a third-party reader.

sorin-davidoi · 2018-12-06T22:04:20Z

@singalen Looks like it can't generate them standalone, don't know why I had the impression that it did. Sorry for the confusion.

rams3s · 2019-02-26T02:52:36Z

Following on @singalen solution, here is what worked for me:

# add empty `[output.epub]` section to `book.toml`.
cargo install mdbook-epub
mdbook-epub --standalone

salomvary · 2019-05-22T09:57:35Z

@rams3s solution worked for me. I was confused a bit by the lack of output from mdbook-epub and the fact that is finishes so fast:) The epub book will be under book/epub. iBooks complains but it works fine with Calibre and Kindle.

rams3s · 2019-05-23T16:22:14Z

It's still WIP but I've recently been working on a project to generate epubs of all official rust documentation nightly. Here is the link: https://rams3s.github.io/rust-ebookshelf/

kaizhang16 · 2019-10-15T02:52:44Z

Hello everyone, I have generated the epub and pdf version by pandoc inspired by rust-lang/rust#20866 (comment). And here is the links:

Hope it helps.

liuchong · 2019-10-15T02:56:56Z

Hello everyone, I have generated the epub and pdf version by pandoc inspired by rust-lang/rust#20866 (comment). And here is the links:

https://github.com/kaizhang91/book/blob/feature-epub-and-pdf/assets/The-Rust-Programming-Language-2019-10-13.epub

https://github.com/kaizhang91/book/blob/feature-epub-and-pdf/assets/The-Rust-Programming-Language-2019-10-13.pdf

Hope it helps.

Thank big god 🐃

josephmate · 2020-03-23T21:26:52Z

@rams3s : I tried out the epub from your website but a lot of the code samples look like this once you get deeper into the book:

Copy and paste:

Filename: src/main.rs

{{#rustdoc_include ../listings/ch02-guessing-game-tutorial/listing-02-01/src/main.rs:all}}

Screenshot:

mabl · 2020-06-11T21:17:56Z

Hello everyone, I have generated the epub and pdf version by pandoc inspired by rust-lang/rust#20866 (comment).

For everybody having issues with these:

The EPUB is not valid and can cause issues, especially on Kobos. See HTML files are not valid Michael-F-Bryan/mdbook-epub#29
The rustdoc_include markup does not work, as reported. I raised an issue in #rustdoc_include does not work Michael-F-Bryan/mdbook-epub#30, but I'm not sure if this is the right place.

bs2kbs2k · 2020-08-14T09:53:35Z

Hello everyone, I hacked together scripts to automatically convert the source .md files to a .epub ebook. Place the 3 files here in the src directory(filename matters) and excute the .sh file by bash make_epub.sh. The .epub file will appear at tmp/TRPL.epub. I think it'll work on other books but I'm not sure.
EDIT: The TOC is broken currently.
EDIT: It's fixed now.

bs2kbs2k · 2020-08-14T10:10:48Z

ADDITION: I hacked together a script to automatically setup the script and run it. just run

curl -L https://git.io/JJ5yS | bash -- /dev/stdin <insert arguments to pandoc here - I use "--toc --toc-depth=2">

cdennison · 2020-11-29T17:36:33Z

Here's what I've tried.

TLDR tried above and got this which was pretty good
https://github.com/cdennison/TRPL/blob/master/TRPL.epub

Downloading existing book (ideal) but can't find anything up-to-date other than https://wherebooks.ga/share.php?q=The+Rust+Programming+Language+(Covers+Rust+2018)+-+Steve+Klabnik&i=https://m.media-amazon.com/images/I/81+7ai0wJ5L._AC_UY327_FMwebp_QL65_.jpg which recommends entering my CC into a fraudulent P2P sharing site.
Use mdBook epub plugin which failed https://github.com/Michael-F-Bryan/mdbook-epub
Error: Incompatible mdbook version, expected 0.3.7 but got 0.4.4

And 0.3.7 doesn't appear to be in available

cargo install mdbook-epub --vers 0.3.7
    Updating crates.io index
error: could not find `mdbook-epub` in registry `https://github.com/rust-lang/crates.io-index` with version `=0.3.7`

Tried script above got the following error and a bunch of warnings but appeared to give a pretty good epub. Uploaded her for others https://github.com/cdennison/TRPL/blob/master/TRPL.epub
File "../prep.py", line 22 print('failed processing',fname,file=sys.stderr)

bs2kbs2k · 2020-12-22T01:39:56Z

   `  File "../prep.py", line 22 print('failed processing',fname,file=sys.stderr)`

That looks like an issue with your system python being 2 rather than 3 - should be fixed now.

Also, I have made a new repo with a lot of rust books automatically generated - https://github.com/bs2kbs2k/RustBooks.

miranquil · 2021-01-28T15:51:41Z

Under macOS, open the official document(example) by Safari and press the print button on upper right, select PDF -> Save as PDF.

This exports the pages perfectly with all contents exported. The only shortage is lacking of the outline data.

intjelic · 2021-07-20T13:31:50Z

This thread is garbage. Full of comments promoting broken solutions and people not understanding the issue.

If conversion to PDF is claimed to be supported, the bare minimum would be to include the outline/toc at the beginning. Printing a book without it makes it impossible to navigate easily.

And yeah, you're not teaching anyone anything by saying you can convert an HTML page to PDF.

carols10cents · 2021-07-20T15:49:52Z

Saying "this thread is garbage" is rude and unnecessary.

…

On Tue, Jul 20, 2021, 9:32 AM Jonathan De Wachter ***@***.***> wrote: This thread is garbage. Full of comments promoting broken solutions and people not understanding the issue. If conversion to PDF is claimed to be supported, the bare minimum would be to include the outline/toc at the beginning. Printing a book without it makes it impossible to navigate easily. And yeah, you're not teaching anyone anything by saying you can convert an HTML page to PDF. — You are receiving this because you commented. Reply to this email directly, view it on GitHub <#218 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AABPKURTS2AJE3EVTM5XH6DTYV3FDANCNFSM4CNJ7F4Q> .

intjelic · 2021-07-20T16:38:38Z

Agree. At least, the next reader is warned and won't waste time trying the non-solution of above.

carols10cents · 2021-07-20T17:06:20Z

Thinking about this some more, this issue shouldn't even be open. This repo is MIT licensed, provided as-is. The print view provides the whole book on a single page that can be printed as PDF for free.

If you want a fully-featured PDF/mobi/epub of the book, nicely typeset and containing a table of contents and an index, you may purchase that at https://nostarch.com/Rust2018. In case you think I'm trying to make money, Steve and I donate all our profits from the book to Black Girls Code.

If you want to help us have PDF/mobi/epub support for free, and help all books using mdbook have that support for free, go help with mdbook. If a version of mdbook is released that has better PDF/mobi/epub support, we will upgrade and provide that.

Therefore, there's nothing left for this issue to address.

carols10cents added the Online only label Aug 23, 2016

carols10cents added this to the No particular chapter milestone Aug 23, 2016

carols10cents added Enhancement E-help-wanted labels Aug 23, 2016

carols10cents modified the milestones: all, No particular chapter Dec 29, 2016

carols10cents added blocked upstream Blocked on a change that needs to happen in a different repo first and removed E-help-wanted labels Mar 22, 2017

carols10cents mentioned this issue Mar 27, 2017

Instructions to compile to EPUB/MOBI (2nd edition) #569

Closed

carols10cents changed the title ~~Single webpage / pdf~~ Single webpage / pdf / epub / mobi Mar 27, 2017

steveklabnik mentioned this issue Sep 27, 2017

Use gitbook.com to create a pdf version #940

Closed

kaajo mentioned this issue Aug 26, 2018

CI/CD of html/epub e-books #1501

Closed

singalen mentioned this issue Dec 6, 2018

Any way to get this book on a e-reader? #1503

Closed

carols10cents mentioned this issue Feb 21, 2019

Share the book with pdf/epub/mobi formats #1828

Closed

steveklabnik mentioned this issue Feb 12, 2020

better pdf support #2254

Closed

This was referenced May 9, 2020

Index #1241

Closed

Consider providing the web version offline #1565

Closed

Developing web-offline and mobile app version of this book #2268

Closed

atc0005 mentioned this issue Jun 23, 2020

Generate fresh copy of "The Rust Programming Language" book atc0005/notes#20

Open

carols10cents closed this as completed Jul 20, 2021

rust-lang locked as too heated and limited conversation to collaborators Jul 20, 2021

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Single webpage / pdf / epub / mobi #218

Single webpage / pdf / epub / mobi #218

hjr3 commented Aug 23, 2016

carols10cents commented Aug 23, 2016

carols10cents commented Feb 20, 2017

steveklabnik commented Feb 20, 2017

carols10cents commented Mar 27, 2017

adamvoss commented Apr 7, 2017

jasonwilliams commented Apr 28, 2017

carols10cents commented Apr 28, 2017

michelboaventura commented May 21, 2017

sorin-davidoi commented Jan 16, 2018

singalen commented Dec 6, 2018 •

edited

Loading

sorin-davidoi commented Dec 6, 2018

rams3s commented Feb 26, 2019

salomvary commented May 22, 2019

rams3s commented May 23, 2019

kaizhang16 commented Oct 15, 2019 •

edited

Loading

liuchong commented Oct 15, 2019 •

edited

Loading

josephmate commented Mar 23, 2020

mabl commented Jun 11, 2020

bs2kbs2k commented Aug 14, 2020 •

edited

Loading

bs2kbs2k commented Aug 14, 2020 •

edited

Loading

cdennison commented Nov 29, 2020 •

edited

Loading

bs2kbs2k commented Dec 22, 2020

miranquil commented Jan 28, 2021 •

edited

Loading

intjelic commented Jul 20, 2021

carols10cents commented Jul 20, 2021 via email

intjelic commented Jul 20, 2021

carols10cents commented Jul 20, 2021

Single webpage / pdf / epub / mobi #218

Single webpage / pdf / epub / mobi #218

Comments

hjr3 commented Aug 23, 2016

carols10cents commented Aug 23, 2016

carols10cents commented Feb 20, 2017

steveklabnik commented Feb 20, 2017

carols10cents commented Mar 27, 2017

adamvoss commented Apr 7, 2017

jasonwilliams commented Apr 28, 2017

carols10cents commented Apr 28, 2017

michelboaventura commented May 21, 2017

sorin-davidoi commented Jan 16, 2018

singalen commented Dec 6, 2018 • edited Loading

sorin-davidoi commented Dec 6, 2018

rams3s commented Feb 26, 2019

salomvary commented May 22, 2019

rams3s commented May 23, 2019

kaizhang16 commented Oct 15, 2019 • edited Loading

liuchong commented Oct 15, 2019 • edited Loading

josephmate commented Mar 23, 2020

mabl commented Jun 11, 2020

bs2kbs2k commented Aug 14, 2020 • edited Loading

bs2kbs2k commented Aug 14, 2020 • edited Loading

cdennison commented Nov 29, 2020 • edited Loading

bs2kbs2k commented Dec 22, 2020

miranquil commented Jan 28, 2021 • edited Loading

intjelic commented Jul 20, 2021

carols10cents commented Jul 20, 2021 via email

intjelic commented Jul 20, 2021

carols10cents commented Jul 20, 2021

singalen commented Dec 6, 2018 •

edited

Loading

kaizhang16 commented Oct 15, 2019 •

edited

Loading

liuchong commented Oct 15, 2019 •

edited

Loading

bs2kbs2k commented Aug 14, 2020 •

edited

Loading

bs2kbs2k commented Aug 14, 2020 •

edited

Loading

cdennison commented Nov 29, 2020 •

edited

Loading

miranquil commented Jan 28, 2021 •

edited

Loading