[15c7d39] | 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 |
|
---|