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