lib/docbook/xhtml5/README

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