The FreeBSD Documentation Project: Is it just me or anyone is interested in reading the FAQ and Hand

[Michael B. Eichorn]

On Fri, 2015-10-23 at 22:29 -0600, Warren Block wrote:
> On Fri, 23 Oct 2015, John via freebsd-questions wrote:
> 
> > I've been reading long articles, web pages on the Kindle for years
> > and 
> > have no problems converting most HTML pages to Kindle format.
> > However, 
> > I just learned the FAQ and Handbook are not plain simple [Single
> > HTML] 
> > files converting fine with default settings with Calibre to ebook,
> > but 
> > in 'XML DocBook' format (never heard of it before) which convert to
> > an 
> > ebook containing its main content in a table with Calibre conversion 
> > (with default settings), which less so readable.
> 
> Sorry, having trouble following the question.  The documentation
> sources 
> are in DocBook XML.  Several output file formats are generated from 
> those sources, including split ("chunked") HTML, single HTML, PDF, and 
> other formats.  The HTML documents have a link at the start to choose 
> the single or split form.
> 
> > The reason I'm asking if it is only my interest, or, perhaps can be
> > in 
> > the interest of many is, if the latter, then it would be useful to 
> > make information on how to get the documentation in Kindle or EPUB 
> > format more clearly visible on the page - or, perhaps even offer 
> > direct downloads - , as I guess more people are familiar with these -
> > and maybe even find them more useful - than 'XML DocBook.'
> 
> We should offer EPUB formats.  I do not have a device that uses them, 
> but understood they could be created from PDFs.

EPUB is a known project that is just awaiting the hands to do it:

https://wiki.freebsd.org/IdeasPage#EPUB_Support_in_Documentation_Build_In
frastructure
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/x-pkcs7-signature
Size: 5761 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-questions/attachments/20151024/e796bb87/attachment.bin>