Bug 11979 - Create EPUB version of docs
Summary: Create EPUB version of docs
Status: RESOLVED FIXED
Alias: None
Product: General Docs
Classification: Documentation
Component: docs-general (show other bugs)
Version: unspecified
Hardware: All Multiple
: Medium enhancement
Target Milestone: Future
Assignee: Unassigned
QA Contact:
URL:
Whiteboard:
Depends on: 13874
Blocks:
  Show dependency tree
 
Reported: 2017-08-25 06:47 UTC by Adam Hunt
Modified: 2021-04-22 14:11 UTC (History)
7 users (show)

See Also:
OS type for building Yocto: ---
Type of Regression: ---
Verified:
Documentation change: No (bug/feature does not impact docs)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Adam Hunt 2017-08-25 06:47:56 UTC
Personally, I would find it very useful to have EPUB versions of the documentation available in addition to the existing HTML and PDF versions.

I spend a lot of time reading content on my ebook reader for a number of reasons: it's easier on my eyes, the device rarely needs to be charged, and, as much as I hate to say it, it works even after a total system meltdown.
Comment 1 Leonardo Sandoval Gonzalez 2017-08-31 14:40:15 UTC
(In reply to comment #0)
> Personally, I would find it very useful to have EPUB versions of the
> documentation available in addition to the existing HTML and PDF versions.
> 
> I spend a lot of time reading content on my ebook reader for a number of
> reasons: it's easier on my eyes, the device rarely needs to be charged, and,
> as much as I hate to say it, it works even after a total system meltdown.

It would be good if you advice on tools to convert pdf/html to epub/mobi. I have used calibre on other docs with partial success.
Comment 2 Scott Rifenbark 2017-09-25 15:55:02 UTC
Back-burner stuff... I can look at some solutions when I get some time.

Scott
Comment 3 Randy MacLeod 2020-04-16 07:38:54 UTC
If we switch the docs to Sphinx then this would happen automatically.
Comment 4 Michael Opdenacker 2021-04-22 14:11:18 UTC
This issues is resolved by the switch to Sphinx.
Just run "make epub"!

I'm also reading the manuals on my ebook reader (KOBO).

There's one issue with the size of images, though:
https://bugzilla.yoctoproject.org/show_bug.cgi?id=14356

And the absence of such documents on https://docs.yoctoproject.org/:
https://bugzilla.yoctoproject.org/show_bug.cgi?id=14357

Closing this bug as the rest is being taken of.