X-Git-Url: https://git.stg.codes/stg.git/blobdiff_plain/793149f04ce52bf75dc4efb7b83a3f8ed30d1fff..35ec793690104efdd610964d255302a0310a2daf:/doc/xslt/epub/README diff --git a/doc/xslt/epub/README b/doc/xslt/epub/README deleted file mode 100644 index 5e2587a1..00000000 --- a/doc/xslt/epub/README +++ /dev/null @@ -1,88 +0,0 @@ ----------------------------------------------------------------------- - 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: - * - * , , , with text/XML - @filerefs - * - * in lists (generic XHTML rendering inability) - * (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 and
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. -