#### 22.4.1 Specifying HTML/XML version, DOCTYPE, and DTD

You can change the HTML or XML header, perhaps to accommodate noncompliant code you are using in a macro, or to conform to the requirements of third-party tools:

    [HTMLOptions]
    ; HTMLVersion = version used: 4 (default), 3 (JavaHelp), or 2 (old)
    HTMLVersion=4
    ; UseDOCTYPE = Yes (default) or No (when writing DocBook entity files)
    UseDOCTYPE=Yes
    ; HTMLDocType, PUBLIC identifier required at start of HTML documents
    ;  Default for v4 is: "-//W3C//DTD HTML 4.01 Transitional//EN"
    ;  or if frameset is: "-//W3C//DTD HTML 4.01 Frameset//EN"
    ;  Default for v3 is: "-//W3C//DTD HTML 3.2 Final//EN"
    ;  Default for v2 is: "-//IETF//DTD HTML 2.0//EN"
    ;  Default for XHTML is: "-//W3C//DTD XHTML 1.0 Transitional//EN"
    ;  Uncomment and give alternate if needed;
    ;   do not leave blank uncommented:
    ;HTMLDocType="-//W3C//DTD HTML 4.01 Transitional//EN"
    ; HTMLDTD, the optional SYSTEM identifier in <!DOCTYPE>;
    ;  default is to omit. If you want to add it back, although it breaks
    ;  CSS usage, for v4 it is:
    ;  "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd"
    ;  or for v4 frameset is:
    ;  "http://www.w3.org/TR/1999/REC-html401-19991224/frameset.dtd"
    ;  For XHTML, it is:
    ;  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"
    ;  Uncomment and leave blank for no DTD (v2 and v3),
    ;  or give an alternate
    ;HTMLDTD=

DITA2Go generates code that is completely compliant with the W3C DTD cited, for whatever version you select. However, it is your responsibility to use only valid syntax for that version in your macros.

HTML 5

For HTML 5 output, leave HTMLVersion=4, and set the other values in this section as appropriate.

JavaHelp

When you specify JavaHelp or Oracle Help for Java as the output type, DITA2Go automatically sets [HTMLOptions]HTMLVersion=3, unless you override this setting in the configuration file.

XHTML

When you specify XHTML as the output type, DITA2Go automatically sets the corresponding HTMLDocType and HTMLDTD, unless you override these settings in the configuration file:

    [HTMLOptions]
    HTMLDocType="-//W3C//DTD XHTML 1.0 Transitional//EN"
    HTMLDTD="DTD/xhtml1-transitional.dtd"

DITA XML

When you specify DITA XML as the output type, DITA2Go sets HTMLDocType and HTMLDTD as follows, depending on the DITA version and topic type. For example, for DITA version 1.1 and topic type concept:

    [HTMLOptions]
    HTMLDocType="-//OASIS//DTD DITA 1.1 Concept//EN"
    HTMLDTD="docs.oasis-open.org/dita/v1.1/CS01/dtd/concept.dtd"

You can override the default values; see §24.3 Specifying general options for DITA.

DocBook XML

When you specify DocBook XML as the output type, DITA2Go sets HTMLDocType and HTMLDTD as follows:

    [HTMLOptions]
    HTMLDocType="-//OASIS//DTD DocBook XML V4.5//EN"
    HTMLDTD="www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"

Previous Topic: 22.4 Supplying values for the <head> element

Next Topic: 22.4.2 Specifying namespace and language

Parent Topic: 22.4 Supplying values for the <head> element

Sibling Topics:

22.4.2 Specifying namespace and language

22.4.3 Specifying character encoding for HTML

22.4.4 Including or omitting HTML/XML generator information

22.4.5 Specifying page titles for HTML output files

22.4.6 Supplying content for the <meta> tag

22.4.7 Specifying nonstandard values for declarations

Table of Contents • Index