To specify the HTML tag to be used for headings and other special-purpose formats:
[ParaStyles] ; Document para format name = HTML style name (default is <p>) ; use h1-h6, pre, script, address, or blockquote for HTML styles
Although these (and span) are the only valid HTML tag names you can specify in this section, DITA2Go does not require you to stick to valid tags. You can use any tags, to allow XML within HTML. In fact, you can use any text that can go inside the <> brackets DITA2Go supplies around the text. However, only tags valid in HTML for paragraphs produce effects in HTML output.
If you are creating Web pages that will be available to search engines, keep in mind that headings that are actually tagged as headings (h1 through h6) can be important for search ranking. For example, Google search might look at the following (rather than keywords in meta tags):
With paragraph style settings in [ParaStyles] you can also do the following:
Apply a character tag to a paragraph format
Suppress paragraph tags entirely.
To add attributes to the paragraph tag, list them after the tag. For example:
[ParaStyles] CodeBold = pre type="bold"
Everything after the first space that follows the tag name is removed for the end tag. To apply an attribute to an individual instance of a paragraph format, insert an attribute PI marker in the paragraph; see §38.3 Adding attributes with PI markers. For this example, you would use a PI marker of type ParaType with content bold.
Apply a character tag to a paragraph format
To apply an HTML character tag (for example, em) to a paragraph format, you would have to do something like this:
[HtmlStyles] ParaFmt = CodeStart CodeEnd
[StyleCodeStart] ParaFmt = <em>
[StyleCodeEnd] ParaFmt = </em>
(With CSS, it might be simpler to add font-style: italic; to the CSS style for the <p.parafmt> tag.)
If you are using CSS, by default the tag name becomes the CSS class name for HTML output; for XML output, the default is reversed. See §31.5 Understanding how CSS affects other options.
You can provide your own class names. For example:
[ParaStyles] Heading 1 = H1 class="tophead"
<h1 class="tophead">
for all Heading 1 paragraphs in HTML output.
For XML output, see §23.3.1 Deriving XML tags from format and class names.
Suppress paragraph tags entirely
To eliminate style tags entirely, map the paragraph format to nothing:
[ParaStyles] ParaFmt =
Specifying an empty [ParaStyles] class is equivalent to assigning format property NoPara to the paragraph format; see §30.2.4 Stripping paragraph properties.
If you are producing DITA XML output, see also §24.4.3.2 Omitting element tags for selected paragraph formats.