From owner-freebsd-doc@FreeBSD.ORG Sun Mar 20 20:47:55 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8FCD41065672; Sun, 20 Mar 2011 20:47:55 +0000 (UTC) (envelope-from drulavigne@sympatico.ca) Received: from bay0-omc2-s24.bay0.hotmail.com (bay0-omc2-s24.bay0.hotmail.com [65.54.190.99]) by mx1.freebsd.org (Postfix) with ESMTP id 7D3258FC14; Sun, 20 Mar 2011 20:47:55 +0000 (UTC) Received: from BAY151-W4 ([65.54.190.125]) by bay0-omc2-s24.bay0.hotmail.com with Microsoft SMTPSVC(6.0.3790.4675); Sun, 20 Mar 2011 13:47:55 -0700 Message-ID: X-Originating-IP: [70.26.38.224] From: Dru Lavigne To: , Date: Sun, 20 Mar 2011 20:47:55 +0000 Importance: Normal In-Reply-To: <4D865AFB.7070105@FreeBSD.org> References: <70FE330E-E1DF-4E2C-AC41-2C5475B00971@gmail.com>, <4D865AFB.7070105@FreeBSD.org> MIME-Version: 1.0 X-OriginalArrivalTime: 20 Mar 2011 20:47:55.0285 (UTC) FILETIME=[16930C50:01CBE740] Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: Subject: RE: Creating epub version of handbooks X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 20 Mar 2011 20:47:55 -0000 > Am 20.03.11 19:33=2C schrieb Damjan Marion: > >=20 > > Hi=2C > >=20 > > I want to create epub version of handbooks. I tried to convert sgml to = docbook xml and then apply epub XSLT. > >=20 > > When I try to do "make FORMATS=3Dxml" in handbook directory or use sx/o= sx i got hundreds of errors (some of them listed below).=20 > >=20 > > Am I doing something wrong or xml creation is broken? > > your approach is a lot like mine when I first tried converting the > FreeBSD documentation set for an epub version. I'll be presenting a > possible solution (more like a migration path) at this years BSDCan: >=20 > http://www.bsdcan.org/2011/schedule/events/224.en.html >=20 > To answer your question: the problem is that there are countless > FreeBSD-specific entities (like &os=3B which translates to "FreeBSD" in > the output document) that need to be converted for the XML version of > DocBook. We are still using an older version of DocBook that is based on > SGML in the Doc project that AFAIK can not yet produce XML output. For > epub creation=2C the source file must be in XML format. Work is in > progress to convert not only these entities that cause these errors=2C bu= t > also to move to an newer version of DocBook that is XML-based. However=2C > this takes time because XML is more strict and we also need to make > modifications to our documentation build infrastructure (makefiles and > such) once we are at a pure XML-based doc set. Sounds like a great talk=2C Benedict! I'll have to catch it. If it's any help=2C Damjan=2C I used calibre and sigil when creating the ep= ub version of the PC-BSD Handbook. Calibre converted the pdf to epub format= and sigil cleaned it up. Calibre warns that manual cleanup will still be n= eeded after conversion=3B in practice=2C the conversion process randomly in= serts figures into the middle of nearby paragraphs and ordered and unordere= d lists need to be adjusted so they render properly. I had to use the Linux= or Windows version as the FreeBSD port for calibre fails and I haven't had= a chance yet to figure out what causes the error to submit a PR. The FreeB= SD port of sigil works fine. Cheers=2C Dru =