mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-11-22 18:08:10 +00:00
62 lines
1.9 KiB
Plaintext
62 lines
1.9 KiB
Plaintext
DocBook stylesheets for HTML5 output
|
|
=============================================
|
|
|
|
This directory contains XSL stylesheets
|
|
for generating HTML5 output from DocBook content.
|
|
For information on HTML5, see:
|
|
|
|
http://dev.w3.org/html5/spec/Overview.html
|
|
|
|
Note that there is no schema available for HTML5, by design.
|
|
|
|
The output of these stylesheets is the XML serialization of
|
|
HTML5. There is no provision for generating the HTML
|
|
serialization of HTML5 with these stylesheets.
|
|
|
|
These HTML5 stylesheets are also used by the EPUB3
|
|
stylesheets included in this distribution.
|
|
|
|
These stylesheets are customizations of the
|
|
existing stylesheets in the "xhtml/" directory.
|
|
Using a customization layer enables the HTML5
|
|
stylesheets to inherit all the features of the
|
|
XHTML stylesheets while making the minimum changes
|
|
for them to produce valid HTML5.
|
|
|
|
If you are processing DocBook 5 document, you should use
|
|
the namespaced version of the stylesheets, with "-ns-"
|
|
in the directory name.
|
|
|
|
|
|
Usage
|
|
-----------
|
|
You should be able to apply any of these stylesheet files
|
|
to a DocBook document as with any other DocBook stylesheet:
|
|
|
|
xhtml5/docbook.xsl - Single file output.
|
|
xhtml5/chunk.xsl - Chunked output.
|
|
xhtml5/profile-docbook.xsl - Profiled single file output.
|
|
xhtml5/profile-chunk.xsl - Profiled chunk output.
|
|
xhtml5/chunkfast.xsl - Chunked output with precomputed chunks.
|
|
|
|
Do not attempt to directly use the following two stylesheet files:
|
|
|
|
xhtml-docbook.xsl
|
|
xhtml-profile-docbook.xsl
|
|
|
|
Those are copies of the corresponding files in the
|
|
xhtml/ directory, modified to remove the doctype
|
|
declarations in the xsl:output elements. They were also
|
|
modified to import from the original xhtml/ directory.
|
|
They will produce xhtml output, not HTML5 output.
|
|
They are imported by the xhtml5 stylesheet files.
|
|
|
|
Testing
|
|
--------------
|
|
|
|
The HTML5 output of these stylesheets should pass the
|
|
W3C online validator, available here:
|
|
|
|
http://validator.w3.org/
|
|
|