hey guys,
I just commited the patch to support epub in PhD. Its not perfect and epubcheck is returning a lot of xhtml errors. I used the most basic structure of the .opf and .ncx files and a build.sh file is been created to build the .epub I tried with the firefox plugin, it takes ages to render in my machine, but its working. $ phd -d .manual.xml -f epub -P PHP or you can use the partial rendering $ phd -d .manual.xml -f epub -P PHP -p <id> There are a lot of things to fix, but I'm sure we can add this in the next release of PhD --Moacir de Oliveira 2010/9/7, honestqiao <honestq...@gmail.com>: > Adobe Digital Editions and epubreader for firefox haven't problems for > chinese. > > But epub hasn't build in search index. > ADE use grep file for search. > epubreader for firefox hasn't search function. > > > > > > > > > 2010-09-07 > > > > honestqiao > > > > 发件人： pedram salehpoor > 发送时间： 2010-09-07 02:25:11 > 收件人： Philip Olson > 抄送： PHP Documentation ML > 主题： Re: [PHP-DOC] Fwd: Farewell CHM, hello EPUB! > > I hope it will not have problems about right to left languages. > Regards, > Pedram >> >> We may as well do this too. >> >> I immediately downloaded the EPUB version from mysql.com and spent 5 >> minutes >> trying to open it on my Mac, and failed. Sure this can be overcome with >> education but it's worth noting that it's not easy, yet, and feels geared >> towards mobile devices so far. I didn't try the Firefox plugin. Although, >> the MySQL epub download appears to be missing an .epub file but I don't >> know >> the topic. >> >> Regardless of my epub ignorance, I think it's a good idea to offer this >> alternative via PhD. I vaguely remember it coming up before, but now >> forget. >> >> Regards, >> Philip >> >> Begin forwarded message: >> >>> From: Brett Bieber <brett.bie...@gmail.com> >>> Date: September 6, 2010 6:10:38 AM PDT >>> To: PEAR Doc List <pear-...@lists.php.net> >>> Subject: [PEAR-DOC] Fwd: Farewell CHM, hello EPUB! >>> >>> An interesting announcement here ― I know we've had plenty of issues >>> with our CHM manuals, and maybe this is something we should consider. >>> I would be in favor of an epub format for our manual. >>> >>> >>> ---------- Forwarded message ---------- >>> From: Stefan Hinz <stefan.h...@oracle.com> >>> Date: Mon, Sep 6, 2010 at 4:31 AM >>> Subject: Farewell CHM, hello EPUB! >>> To: annou...@lists.mysql.com >>> >>> >>> For a long time, the MySQL Documentation Team has been providing CHM >>> files for most MySQL documentation we publish. Like many other formats, >>> CHM-format docs can be downloaded from http://dev.mysql.com/doc. CHM >>> (Compiled HTML Help) has been the de facto standard help file format on >>> Windows since 1997, but the technology behind it is outdated and has all >>> kinds of quirks. The successor format introduced with Windows Vista is >>> AP Help, but it hasn't taken off in practice so far. So, with CHM being >>> outdated and AP Help spread anything but widely, lots of vendors have >>> started providing documentation on Windows in PDF or HTML format. >>> >>> Building CHM-format documentation is a challenge of its own. I'll not go >>> into details here, so let me just state that it requires a dedicated >>> Windows box (or VM), and while it can be automated using Power Shell >>> commands, there's no way to find out whether or not a CHM file was built >>> correctly, except by manual inspection. This makes it different from all >>> other documentation formats where technical QA is done (successfully) in >>> an automated fashion. >>> >>> With the increasing complexity and size of our documentation (the MySQL >>> 5.1 Manual contains more than 1.6 million words now!), providing CHM has >>> become more and more of a pain, because builds tend to break more often. >>> We've stopped shipping CHM with the MySQL Server on Windows months ago >>> because we simply couldn't guarantee that the help file shipped with the >>> software would work. Also, we're running short on hardware resources, so >>> we'd rather stop wasting the resources we have on building a format >>> that's of limited use, anyway. >>> >>> This is why we'll stop providing CHM for any of the documentation we >>> publish. >>> >>> To alleviate potential pains anyone might have with this decision, let >>> me tell you that we've started providing EPUB-format docs. EPUB (see >>> http://en.wikipedia.org/wiki/EPUB) is an open standard format for screen >>> readers, mobile or not, and is fairly easy (and not resource-intensive!) >>> to compile. Thanks to Lenz for suggesting to build EPUB! >>> >>> Go to http://dev.mysql.com/doc to grab MySQL documentation in EPUB >>> format. To read EPUB on desktop machines, I use a Firefox add-on, >>> unsurprisingly called epubreader, which loads EPUB documents fast and >>> renders them nicely. That said, please be aware that EPUB can't do >>> anything about the fact that the MySQL Reference Manual is huge, so >>> downloading it to a mobile device can take a while. The MySQL 5.1 Manual >>> is currently a whopping 15 MB! >>> >>> See also: http://blogs.sun.com/mysqlf/entry/farewell_chm_hello_epub >>> >>> -- >>> Cheers, >>> >>> Stefan Hinz <stefan.h...@sun.com>, MySQL Documentation Manager >>> >>> Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc >>> >>> ORACLE Deutschland B.V.& Co. KG >>> Registered Office: Riesstr. 25, 80992 Muenchen, Germany >>> Commercial Register: Local Court Of Munich, HRA 95603 >>> >>> General Partner: ORACLE Deutschland Verwaltung B.V. >>> Rijnzathe 6, 3454PV De Meern, Niederlande >>> Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697 >>> Managing Directors: Juergen Kunz, Marcel van de Molen, >>> Alexander van der Ven >>> >>> -- >>> MySQL Announce Mailing List >>> For list archives: http://lists.mysql.com/announce >>> To unsubscribe: >>> http://lists.mysql.com/announce?unsub=brett.bie...@gmail.com >>> >>> >>> >>> >>> -- >>> Brett Bieber >>> >>> -- >>> PEAR Documentation List Mailing List (http://pear.php.net/) >>> To unsubscribe, visit: http://www.php.net/unsub.php >>> >> >> > . >
