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 |
|
---|