Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 23 Oct 2015 22:29:58 -0600 (MDT)
From:      Warren Block <wblock@wonkity.com>
To:        m8r-qatwhq@mailinator.com
Cc:        freebsd-questions@freebsd.org
Subject:   Re: The FreeBSD Documentation Project: Is it just me or anyone is interested in reading the FAQ and Hand
Message-ID:  <alpine.BSF.2.20.1510232226490.27415@wonkity.com>
In-Reply-To: <20151023160313.9009FD5796@emkei.cz>
References:  <20151023160313.9009FD5796@emkei.cz>

next in thread | previous in thread | raw e-mail | index | archive | help
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.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.20.1510232226490.27415>