Bug 11979

Summary: Create EPUB version of docs
Product: [Documentation] General Docs Reporter: Adam Hunt <voxadam>
Component: docs-generalAssignee: Unassigned <unassigned>
Status: RESOLVED FIXED QA Contact:
Severity: enhancement    
Priority: Medium CC: akuster808, kristi, leonardo.sandoval.gonzalez, mark.morton, michael.opdenacker, randy.macleod, srifenbark
Version: unspecified   
Target Milestone: Future   
Hardware: All   
OS: Multiple   
Whiteboard:
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: No (bug/feature does not impact docs)
Bug Depends on: 13874    
Bug Blocks:    

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.