+++ /dev/null
-----------------------------------------------------------------------\r
- README file for the DocBook XSL Stylesheets\r
-----------------------------------------------------------------------\r
-\r
-These are XSL stylesheets for transforming DocBook XML document\r
-instances into .epub format.\r
-\r
-.epub is an open standard of the The International Digital Publishing Forum (IDPF), \r
-a the trade and standards association for the digital publishing industry. \r
-\r
-An alpha-quality reference implementation (dbtoepub) for a DocBook to .epub \r
-converter (written in Ruby) is available under bin/. \r
-\r
-From http://idpf.org\r
- What is EPUB, .epub, OPS/OCF & OEB?\r
-\r
- ".epub" is the file extension of an XML format for reflowable digital \r
- books and publications. ".epub" is composed of three open standards, \r
- the Open Publication Structure (OPS), Open Packaging Format (OPF) and \r
- Open Container Format (OCF), produced by the IDPF. "EPUB" allows \r
- publishers to produce and send a single digital publication file \r
- through distribution and offers consumers interoperability between \r
- software/hardware for unencrypted reflowable digital books and other \r
- publications. The Open eBook Publication Structure or "OEB", \r
- originally produced in 1999, is the precursor to OPS. \r
-\r
-----------------------------------------------------------------------\r
-.epub Constraints \r
-----------------------------------------------------------------------\r
-\r
-.epub does not support all of the image formats that DocBook supports.\r
-When an image is available in an accepted format, it will be used. The\r
-accepted @formats are: 'GIF','GIF87a','GIF89a','JPEG','JPG','PNG','SVG'\r
-A mime-type for the image will be guessed from the file extension, \r
-which may not work if your file extensions are non-standard.\r
-\r
-Non-supported elements:\r
- * <mediaobjectco> \r
- * <inlinegraphic>, <graphic>, <textdata>, <imagedata> with text/XML \r
- @filerefs\r
- * <olink>\r
- * <cmdsynopsis> in lists (generic XHTML rendering inability)\r
- * <footnote><para><programlisting> (just make your programlistings \r
- siblings, rather than descendents of paras)\r
-\r
-----------------------------------------------------------------------\r
-dbtoepub Reference Implementation\r
-----------------------------------------------------------------------\r
-\r
-An alpha-quality DocBook to .epub conversion program, dbtoepub, is provided\r
-in bin/dbtoepub. \r
-\r
-This tool requires:\r
- - 'xsltproc' in your PATH\r
- - 'zip' in your PATH\r
- - Ruby 1.8.4+\r
-\r
-Windows compatibility has not been extensively tested; bug reports encouraged.\r
-[See http://www.zlatkovic.com/libxml.en.html and http://unxutils.sourceforge.net/]\r
-\r
-$ dbtoepub --help\r
- Usage: dbtoepub [OPTIONS] [DocBook Files]\r
-\r
- dbtoepub converts DocBook <book> and <article>s into to .epub files.\r
-\r
- .epub is defined by the IDPF at www.idpf.org and is made up of 3 standards:\r
- - Open Publication Structure (OPS)\r
- - Open Packaging Format (OPF) \r
- - Open Container Format (OCF)\r
-\r
- Specific options:\r
- -d, --debug Show debugging output.\r
- -h, --help Display usage info\r
- -v, --verbose Make output verbose\r
-\r
-\r
-----------------------------------------------------------------------\r
-Validation\r
-----------------------------------------------------------------------\r
-\r
-The epubcheck project provides limited validation for .epub documents. \r
-See http://code.google.com/p/epubcheck/ for details.\r
-\r
-----------------------------------------------------------------------\r
-Copyright information\r
-----------------------------------------------------------------------\r
-See the accompanying file named COPYING.\r
-\r