search

saltstack / salt

Software to automate the management and configuration of any infrastructure or application at scale. Install Salt from the Salt package repositories here:
https://docs.saltproject.io/salt/install-guide/en/latest/
Apache License 2.0
14.22k stars 5.49k forks source link

Provide a MOBI version of the Docs #5734

Closed EugeneKay closed 7 years ago

EugeneKay commented 11 years ago

Please provide a MOBI version of the Offline documentation for compatibility with the Kindle series of ereaders. Converting an ePub comes out usable, but has notable formatting issues and is not a "drag and drop" solution, and PDF is unsupported on the eInk family. Double extra bonus karma points if they could be provided as a $0.00 ebook on the Amazon Kindle store for auto-updating goodness.

thatch45 commented 11 years ago

Are you familiar with an easy way to generate this from sphinx?

s0undt3ch commented 11 years ago

I tried using https://bitbucket.org/charlax/sphinx, split the changes into a separate builder, but no real success:

      in file: <dl>     line: 0000076
Warning(inputpreprocessor):W29004: Forcefully closed opened Tag: <dl>
      in file: <dl>     line: 0000076
Warning(inputpreprocessor):W29004: Forcefully closed opened Tag: <dd>
      in file: <dl>     line: 0000083
Warning(inputpreprocessor):W29004: Forcefully closed opened Tag: <dl>
      in file: <dl>     line: 0000083
Warning(inputpreprocessor):W29010: Tag rejected due to being used in unauthorized scope: <dd>
      in file: <dl>     line: 0000087
Warning(inputpreprocessor):W29010: Tag rejected due to being used in unauthorized scope: <dl>
      in file: <dl>     line: 0000088
Warning(inputpreprocessor):W29010: Tag rejected due to being used in unauthorized scope: <dd>
      in file: <dl>     line: 0000089
Error(core):E1003: Unknown error in class String.
Error(parsing):E3013: More number of characters are hidden using display:none than allowed limit. Limit: 10000  in file: 10000 line: 10000

There's also a success story here. I've added a comment to see if his mobi builder was public.

Let's see if I get a reply.

s0undt3ch commented 11 years ago

I'm a little further, but not there yet:

https://gist.github.com/s0undt3ch/887036455fbe5e5218c1

What's done so far: https://github.com/s0undt3ch/salt/tree/features/mobi-doc

Can't seem to find any info about the errors kindlegen is giving me.

jacobhammons commented 9 years ago

@EugeneKay I picked this back up again to see if there is any progress around tools, but there hasn't been much in the spinx > mobi tools arena. The latest version of kindlegen isn't converting our epub either.

What does work is Calibre, http://calibre-ebook.com/, which seems to be the preferred tool to convert eBooks for all the different readers already.

Are you OK if we close this with the recommendation that users download Calibre to get an ebook in a different format? I don't see an easy way for us to provide and test a mobi file with any consistency. Thanks!

EugeneKay commented 9 years ago

My understanding is that the direct Sphinx creation of a Mobi is failing, but an ePub-to-Mobi conversion is working OK, via Calibre? I'd prefer to leave it open with a low-to-none priority, as Kindle docs are a great thing. I can put a bit of time into seeing about making it work, or possibly volunteering to do a manual convert+verify for each Release version. If you think it's better Closed, that's fine by me too ;-)

Reiner030 commented 9 years ago

There is also a command line converting call available so it can be created automatically? http://manual.calibre-ebook.com/generated/en/ebook-convert.html

UtahDave commented 7 years ago

We'll close this until sphinx creation of mobi files improves.

Arupbakshi commented 1 year ago

I face the problem in kindle conversion, please help if any one knows

Error | E1003: Unknown error in class String. Error | E3013: More number of characters are hidden using display:none than allowed limit. Limit: 10000  in file: 10000 line: 10000 Notice | W14028: Following file does not exist :   ../fonts/SourceSansPro-Bold.eot?#iefix Status | Book conversion failed.