<?xml version="1.0"?>
<section id="S__db2html-block"><title>DocBook to HTML - Block Elements</title>
  <para>This module handles most simple block-level elements, turning them into the
  appropriate HTML tags.  It does not handle tables, lists, and various other
  complex block-level elements.</para>
  <variablelist><title>Templates</title><varlistentry><term><link linkend="T__db2html_block"><function>db2html.block</function></link></term><listitem><para>Renders a block-level element to an HTML <literal>div</literal> tag</para></listitem></varlistentry><varlistentry><term><link linkend="T__db2html_block_title"><function>db2html.block.title</function></link></term><listitem><para>Renders a formal title for a block-level element</para></listitem></varlistentry><varlistentry><term><link linkend="T__db2html_blockquote"><function>db2html.blockquote</function></link></term><listitem><para>Renders a <literal>blockquote</literal> element to HTML</para></listitem></varlistentry><varlistentry><term><link linkend="T__db2html_para"><function>db2html.para</function></link></term><listitem><para>Renders a block-level element as an HTML <literal>p</literal> element</para></listitem></varlistentry><varlistentry><term><link linkend="T__db2html_pre"><function>db2html.pre</function></link></term><listitem><para>Renders a block-level element as an HTML <literal>pre</literal> element</para></listitem></varlistentry></variablelist><refentry id="T__db2html_block"><indexterm><primary>db2html.block</primary></indexterm><refnamediv><refname><function>db2html.block</function></refname><refpurpose>Renders a block-level element to an HTML <literal>div</literal> tag</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The block-level element to render</para></listitem></varlistentry><varlistentry><term><parameter>class</parameter></term><listitem><para>An extra string to insert in the <literal>class</literal> attribute</para></listitem></varlistentry><varlistentry><term><parameter>first</parameter></term><listitem><para>Whether this is the first child block in the parent</para></listitem></varlistentry><varlistentry><term><parameter>indent</parameter></term><listitem><para>Whether this block should be indented</para></listitem></varlistentry><varlistentry><term><parameter>verbatim</parameter></term><listitem><para>Whether to maintain whitespace as written</para></listitem></varlistentry><varlistentry><term><parameter>formal</parameter></term><listitem><para>Whether this is a formal block element</para></listitem></varlistentry><varlistentry><term><parameter>title</parameter></term><listitem><para>When <parameter>formal</parameter> is true, an element to use for the title</para></listitem></varlistentry><varlistentry><term><parameter>caption</parameter></term><listitem><para>When <parameter>formal</parameter> is true, an element to use for the caption </para></listitem></varlistentry><varlistentry><term><parameter>lang</parameter></term><listitem><para>The locale of the text in <parameter>node</parameter></para></listitem></varlistentry><varlistentry><term><parameter>dir</parameter></term><listitem><para>The text direction, either <literal>ltr</literal> or <literal>rtl</literal></para></listitem></varlistentry><varlistentry><term><parameter>ltr</parameter></term><listitem><para>Whether to default to <literal>ltr</literal> if neither <parameter>lang</parameter> nor <parameter>dir</parameter> is specified</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template creates an HTML <literal>div</literal> element for the given DocBook element.
  This template uses the parameters to construct the <literal>class</literal> attribute, which
  is then used by the CSS for styling.</para>
  </refsection></refentry><refentry id="T__db2html_block_title"><indexterm><primary>db2html.block.title</primary></indexterm><refnamediv><refname><function>db2html.block.title</function></refname><refpurpose>Renders a formal title for a block-level element</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The block-level element being processed</para></listitem></varlistentry><varlistentry><term><parameter>title</parameter></term><listitem><para>The element containing the title</para></listitem></varlistentry><varlistentry><term><parameter>lang</parameter></term><listitem><para>The locale of the text in <parameter>title</parameter></para></listitem></varlistentry><varlistentry><term><parameter>dir</parameter></term><listitem><para>The text direction, either <literal>ltr</literal> or <literal>rtl</literal></para></listitem></varlistentry><varlistentry><term><parameter>ltr</parameter></term><listitem><para>Whether to default to <literal>ltr</literal> if neither <parameter>lang</parameter> nor <parameter>dir</parameter> is specified</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template formats the contents of <parameter>title</parameter> as a title for a block-level
  element.  It is called by <function><link linkend="T__db2html_block">db2html.block</link></function> for formal block elements.</para>
  </refsection></refentry><refentry id="T__db2html_blockquote"><indexterm><primary>db2html.blockquote</primary></indexterm><refnamediv><refname><function>db2html.blockquote</function></refname><refpurpose>Renders a <literal>blockquote</literal> element to HTML</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The <literal>blockquote</literal> element to render</para></listitem></varlistentry><varlistentry><term><parameter>first</parameter></term><listitem><para>Whether this is the first child block in the parent</para></listitem></varlistentry><varlistentry><term><parameter>lang</parameter></term><listitem><para>The locale of the text in <parameter>node</parameter></para></listitem></varlistentry><varlistentry><term><parameter>dir</parameter></term><listitem><para>The text direction, either <literal>ltr</literal> or <literal>rtl</literal></para></listitem></varlistentry><varlistentry><term><parameter>ltr</parameter></term><listitem><para>Whether to default to <literal>ltr</literal> if neither <parameter>lang</parameter> nor <parameter>dir</parameter> is specified</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template creates an HTML <literal>blockquote</literal> element for the given DocBook
  element.</para>
  </refsection></refentry><refentry id="T__db2html_para"><indexterm><primary>db2html.para</primary></indexterm><refnamediv><refname><function>db2html.para</function></refname><refpurpose>Renders a block-level element as an HTML <literal>p</literal> element</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The block-level element to render</para></listitem></varlistentry><varlistentry><term><parameter>first</parameter></term><listitem><para>Whether this is the first child block in the parent</para></listitem></varlistentry><varlistentry><term><parameter>lang</parameter></term><listitem><para>The locale of the text in <parameter>node</parameter></para></listitem></varlistentry><varlistentry><term><parameter>dir</parameter></term><listitem><para>The text direction, either <literal>ltr</literal> or <literal>rtl</literal></para></listitem></varlistentry><varlistentry><term><parameter>ltr</parameter></term><listitem><para>Whether to default to <literal>ltr</literal> if neither <parameter>lang</parameter> nor <parameter>dir</parameter> is specified</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template creates an HTML <literal>p</literal> element for the given DocBook element.</para>
  </refsection></refentry><refentry id="T__db2html_pre"><indexterm><primary>db2html.pre</primary></indexterm><refnamediv><refname><function>db2html.pre</function></refname><refpurpose>Renders a block-level element as an HTML <literal>pre</literal> element</refpurpose></refnamediv><refsection><title>Parameters</title><variablelist><varlistentry><term><parameter>node</parameter></term><listitem><para>The block-level element to render</para></listitem></varlistentry><varlistentry><term><parameter>class</parameter></term><listitem><para>An extra string to insert in the <literal>class</literal> attribute</para></listitem></varlistentry><varlistentry><term><parameter>first</parameter></term><listitem><para>Whether this is the first child block in the parent</para></listitem></varlistentry><varlistentry><term><parameter>indent</parameter></term><listitem><para>Whether this block should be indented</para></listitem></varlistentry><varlistentry><term><parameter>children</parameter></term><listitem><para>The child elements to process</para></listitem></varlistentry><varlistentry><term><parameter>lang</parameter></term><listitem><para>The locale of the text in <parameter>node</parameter></para></listitem></varlistentry><varlistentry><term><parameter>dir</parameter></term><listitem><para>The text direction, either <literal>ltr</literal> or <literal>rtl</literal></para></listitem></varlistentry><varlistentry><term><parameter>ltr</parameter></term><listitem><para>Whether to default to <literal>ltr</literal> if neither <parameter>lang</parameter> nor <parameter>dir</parameter> is specified</para></listitem></varlistentry></variablelist></refsection><refsection><title>Description</title>
  <para>This template creates an HTML <literal>pre</literal> element for the given DocBook element.
  This template uses the parameters to construct the <literal>class</literal> attribute, which
  is then used by the CSS for styling.</para>
  <para>If <parameter>node</parameter> has the <literal>linenumbering</literal> attribute set to <literal>"numbered"</literal>, then this
  template will create line numbers for each line, using the <function><link linkend="T__db_linenumbering">db.linenumbering</link></function>
  template.</para>
  </refsection></refentry></section>
