From owner-freebsd-questions@freebsd.org  Sat Oct 24 15:56:31 2015
Return-Path: <owner-freebsd-questions@freebsd.org>
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 7BBC4A1D39B
 for <freebsd-questions@mailman.ysv.freebsd.org>;
 Sat, 24 Oct 2015 15:56:31 +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 3E176E8
 for <freebsd-questions@freebsd.org>; Sat, 24 Oct 2015 15:56:30 +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 t9OFuTwF050030
 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Sat, 24 Oct 2015 09:56:29 -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 t9OFuTvA050027;
 Sat, 24 Oct 2015 09:56:29 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sat, 24 Oct 2015 09:56:29 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: "Michael B. Eichorn" <ike@michaeleichorn.com>
cc: m8r-qatwhq@mailinator.com, 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: <1445700703.13154.46.camel@michaeleichorn.com>
Message-ID: <alpine.BSF.2.20.1510240948260.33608@wonkity.com>
References: <20151023160313.9009FD5796@emkei.cz>
 <alpine.BSF.2.20.1510232226490.27415@wonkity.com>
 <1445700703.13154.46.camel@michaeleichorn.com>
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]); Sat, 24 Oct 2015 09:56:29 -0600 (MDT)
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions/>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 24 Oct 2015 15:56:31 -0000

On Sat, 24 Oct 2015, Michael B. Eichorn wrote:
> On Fri, 2015-10-23 at 22:29 -0600, Warren Block wrote:
>>
>> 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_Infrastructure

Not really hands, but specifics.  What is the best source format for 
conversion?  Are there command-line tools for conversion that would not 
bloat our doc toolchain too much?  Is the best way to use another XSL 
transformation like the one that produces the HTML version?  Is there an 
existing set of stylesheets for a DocBook to EPUB transformation that 
could be used?

So it comes up, but either other projects have a higher priority, or 
volunteer motivation is lacking, or both.  Help with this is welcome.