BEGIN:VCALENDAR
METHOD:REQUEST
PRODID:Foxmail Tencent.Inc
VERSION:2.0
BEGIN:VEVENT
DTSTAMP:20100907T132433Z
DTSTART:20100907T133000Z
SUMMARY:Re: Re: [PHP-DOC] Fwd: Farewell CHM, hello EPUB!
UID:{CE56EA02-A4A1-479F-A0F9-0B52F8460378}
ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION;RSVP=TRUE;CN=pedram
salehpoor:MAILTO:pedram.salehp...@gmail.com
ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=NEEDS-ACTION;RSVP=TRUE;CN=Philip
Olson:MAILTO:phi...@roshambo.org
ATTENDEE;ROLE=OPT-PARTICIPANT;PARTSTAT=NEEDS-ACTION;RSVP=TRUE;CN=PHP Doc
umentation ML:MAILTO:phpdoc@lists.php.net
ORGANIZER;CN=honestqiao:MAILTO:honestq...@gmail.com
LOCATION:
DTEND:20100907T140000Z
DESCRIPTION:<?xml version="1.0" encoding="utf-8"?`>
<book>
<bookinfo>
<title>My EPUB book</title>
<author><firstname>Liza</firstname>
<surname>Daly</surname></author>
<volumenum>1234</volumenum>
</bookinfo>
<preface id="preface">
<title>Title page</title>
<figure id="cover-image">
<title>Our EPUB cover image icon</title>
<graphic fileref="cover.png"/>
</figure>
</preface>
<chapter id="chapter1">
<title>This is a pretty simple DocBook example</title>
<para>
Not much to see here.
</para>
</chapter>
<chapter id="end-notes">
<title>End notes</title>
<para>
This space intentionally left blank.
</para>
</chapter>
</book>
$ xsltproc /path/to/docbook-xsl-1.74.0/epub/docbook.xsl docbook.xml
Writing OEBPS/bk01-toc.html for book
Writing OEBPS/pr01.html for preface(preface)
Writing OEBPS/ch01.html for chapter(chapter1)
Writing OEBPS/ch02.html for chapter(end-notes)
Writing OEBPS/index.html for book
Writing OEBPS/toc.ncx
Writing OEBPS/content.opf
Writing META-INF/container.xml
$ echo "application/epub+zip" > mimetype
$ zip -0Xq my-book.epub mimetype
$ zip -Xr9D my-book.epub *
$ java -jar epubcheck.jar my-book.epub
No errors or warnings detected
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 wi
th
> education but it's worth noting that it's not easy, yet, and feels ge
ared
> towards mobile devices so far. I didn't try the Firefox plugin. Altho
ugh,
> 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 th
is
> 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 forma
ts,
>> 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 be
ing
>> outdated and AP Help spread anything but widely, lots of vendors hav
e
>> started providing documentation on Windows in PDF or HTML format.
>>
>> Building CHM-format documentation is a challenge of its own. I'll no
t 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 b
uilt
>> 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 My
SQL
>> 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 of
ten.
>> We've stopped shipping CHM with the MySQL Server on Windows months a
go
>> 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, l
et
>> 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 sc
reen
>> readers, mobile or not, and is fairly easy (and not resource-intensi
ve!)
>> 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 an
d
>> 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 Ma
nual
>> 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/d
oc
>>
>> 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
>>
>
>
.
SEQUENCE:0
PRIORITY:3
CLASS:
CREATED:20100907T132433Z
LAST-MODIFIED:20100907T132433Z
STATUS:CONFIRMED
TRANSP:OPAQUE
X-MICROSOFT-CDO-ALLDAYEVENT:FALSE
BEGIN:VALARM
ACTION:DISPLAY
DESCRIPTION:REMINDER
TRIGGER;RELATED=START:-PT00H15M00S
END:VALARM
END:VEVENT
END:VCALENDAR
