1DocBook stylesheets for HTML5 output 2============================================= 3 4This directory contains XSL stylesheets 5for generating HTML5 output from DocBook content. 6For information on HTML5, see: 7 8http://dev.w3.org/html5/spec/Overview.html 9 10Note that there is no schema available for HTML5, by design. 11 12The output of these stylesheets is the XML serialization of 13HTML5. There is no provision for generating the HTML 14serialization of HTML5 with these stylesheets. 15 16These HTML5 stylesheets are also used by the EPUB3 17stylesheets included in this distribution. 18 19These stylesheets are customizations of the 20existing stylesheets in the "xhtml/" directory. 21Using a customization layer enables the HTML5 22stylesheets to inherit all the features of the 23XHTML stylesheets while making the minimum changes 24for them to produce valid HTML5. 25 26If you are processing DocBook 5 document, you should use 27the namespaced version of the stylesheets, with "-ns-" 28in the directory name. 29 30 31Usage 32----------- 33You should be able to apply any of these stylesheet files 34to a DocBook document as with any other DocBook stylesheet: 35 36xhtml5/docbook.xsl - Single file output. 37xhtml5/chunk.xsl - Chunked output. 38xhtml5/profile-docbook.xsl - Profiled single file output. 39xhtml5/profile-chunk.xsl - Profiled chunk output. 40xhtml5/chunkfast.xsl - Chunked output with precomputed chunks. 41 42Do not attempt to directly use the following two stylesheet files: 43 44xhtml-docbook.xsl 45xhtml-profile-docbook.xsl 46 47Those are copies of the corresponding files in the 48xhtml/ directory, modified to remove the doctype 49declarations in the xsl:output elements. They were also 50modified to import from the original xhtml/ directory. 51They will produce xhtml output, not HTML5 output. 52They are imported by the xhtml5 stylesheet files. 53 54Testing 55-------------- 56 57The HTML5 output of these stylesheets should pass the 58W3C online validator, available here: 59 60http://validator.w3.org/ 61 62