From owner-freebsd-questions@freebsd.org Sat Oct 24 04:30:05 2015 Return-Path: Delivered-To: freebsd-questions@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id E5B53A1C119 for ; Sat, 24 Oct 2015 04:30:05 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "wonkity.com", Issuer "wonkity.com" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id A3514623 for ; Sat, 24 Oct 2015 04:30:05 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.15.2/8.15.2) with ESMTPS id t9O4Twhl078720 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Fri, 23 Oct 2015 22:29:58 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id t9O4TwaE078717; Fri, 23 Oct 2015 22:29:58 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Fri, 23 Oct 2015 22:29:58 -0600 (MDT) From: Warren Block 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 In-Reply-To: <20151023160313.9009FD5796@emkei.cz> Message-ID: References: <20151023160313.9009FD5796@emkei.cz> User-Agent: Alpine 2.20 (BSF 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Fri, 23 Oct 2015 22:29:58 -0600 (MDT) X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 24 Oct 2015 04:30:06 -0000 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.