22.4.7 Specifying nonstandard values for declarations

You can specify different values for several header fields or declarations; however, unless you know you need nonstandard values, you should not need to change any of these. For some settings, the default values vary based on whether the output type is HTML, XHTML, or XML:

[HTMLOptions]
; UseXMLRoot = Yes (default) or No (when writing DocBook entity files)
UseXMLRoot=Yes
; XMLRoot default is "html" for XHTML, or "doc" for generic XML.
XMLRoot=html
; UseHeadAndBody = Yes (HTML/XHTML default) 
;  or No (generic XML and DITA default)
UseHeadAndBody=Yes
; ContentType = text/html (default for HTML and XHTML)
;  or application/xml (default for XML); try not to use text/xml
; (for interoperability)
ContentType=text/html

Content-Type is part of MIME, and is used by document-processing tools. Unless you know exactly what you want and need only a mechanism to specify it, leave this setting alone. For more information, see:

http://www.w3.org/Protocols/rfc1341/4_Content-Type.html

For XHTML, you can suppress the <?xml...?> declaration, as required by some browsers:

[HTMLOptions]
;UseXMLDeclaration = Yes to start with <?xml...?>, or No to omit
UseXMLDeclaration=No

Previous Topic:  22.4.6.3 Providing meta content with DITA2Go macros

Next Topic:  22.5 Specifying HTML <body> attributes

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

Sibling Topics:

22.4.1 Specifying HTML/XML version, DOCTYPE, and DTD

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