{#- Copyright (C) 2025 The Qt Company Ltd. SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0 -#} {% if length(content.blocks) > 0 %}
{% for block in content.blocks %} {% if block.type == "paragraph" %} {#- href is internal-only (QDoc-resolved); link text is user-authored and must be escaped. -#} {% for i in block.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "bold" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "italic" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% endif %}{% else if i.type == "teletype" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "underline" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "strikethrough" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "subscript" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "superscript" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "parameter" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "line-break" %}
{% else if i.type == "image" %}{% else if i.type == "keyword" %}{% else if i.type == "target" %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}

{% else if block.type == "code-block" %}
{{ escape_html(block.text) }}
{% else if block.type == "section-heading" %} {{ escape_html(block.text) }} {% else if block.type == "list" %} {% if block.attributes.listType == "numeric" %}
    {% else %}
      {% endif %} {% for item in block.children %}
    • {% for p in item.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "bold" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "italic" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% endif %}{% else if i.type == "teletype" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}
    • {% endfor %} {% if block.attributes.listType == "numeric" %}
{% else %}{% endif %} {% else if block.type == "definition-list" %} {% if block.attributes.listType == "value" %}
{% for entry in block.children %}{% if entry.type == "definition-term" %}{% else if entry.type == "definition-description" %} {% endif %}{% endfor %}
ConstantDescription
{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{{ escape_html(i.text) }}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{{ escape_html(i.text) }}{% endfor %}{% else %}{{ escape_html(entry.text) }}{% endif %}{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}
{% else %}
{% for entry in block.children %} {% if entry.type == "definition-term" %}
{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% else %}{{ escape_html(entry.text) }}{% endif %}
{% else if entry.type == "definition-description" %}
{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% else %}{{ escape_html(entry.text) }}{% endif %}
{% endif %} {% endfor %}
{% endif %} {% else if block.type == "note" %} {% else if block.type == "warning" %} {% else if block.type == "important" %} {% else if block.type == "horizontal-rule" %}
{% else if block.type == "div" %}
{{ escape_html(block.text) }}
{% else if block.type == "table" %}
{% for row in block.rows %}{% if row.type == "table-header-row" %}{% for cell in row.cells %}{% if cell.type == "table-cell" %}{% endif %}{% endfor %} {% else if row.type == "table-row" %}{% for cell in row.cells %}{% if cell.type == "table-cell" %}{{ escape_html(cell.text) }}{% endif %}{% endfor %} {% endif %}{% endfor %}
{{ escape_html(cell.text) }}
{% else if block.type == "section" %}
{% for child in block.children %} {% if child.type == "section-heading" %} {{ escape_html(child.text) }} {% else if child.type == "paragraph" %} {% for i in child.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "bold" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "italic" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% endif %}{% else if i.type == "teletype" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "underline" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "strikethrough" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "subscript" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "superscript" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "parameter" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "line-break" %}
{% else if i.type == "image" %}{% else if i.type == "keyword" %}{% else if i.type == "target" %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}

{% else if child.type == "code-block" %}
{{ escape_html(child.text) }}
{% else if child.type == "list" %} {% if child.attributes.listType == "numeric" %}
    {% else %}
      {% endif %} {% for item in child.children %}
    • {% for p in item.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "bold" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "italic" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% endif %}{% else if i.type == "teletype" %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else if c.type == "code" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}
    • {% endfor %} {% if child.attributes.listType == "numeric" %}
{% else %}{% endif %} {% else if child.type == "definition-list" %} {% if child.attributes.listType == "value" %}
{% for entry in child.children %}{% if entry.type == "definition-term" %}{% else if entry.type == "definition-description" %} {% endif %}{% endfor %}
ConstantDescription
{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{{ escape_html(i.text) }}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{{ escape_html(i.text) }}{% endfor %}{% else %}{{ escape_html(entry.text) }}{% endif %}{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}
{% else %}
{% for entry in child.children %} {% if entry.type == "definition-term" %}
{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% else %}{{ escape_html(entry.text) }}{% endif %}
{% else if entry.type == "definition-description" %}
{% if existsIn(entry, "children") and length(entry.children) > 0 %}{% for p in entry.children %}{% if p.type == "paragraph" %}{% for i in p.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% else %}{% for c in i.children %}{{ escape_html(c.text) }}{% endfor %}{% endif %}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% endif %}{% endfor %}{% else if existsIn(entry, "inlines") %}{% for i in entry.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else if i.type == "code" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}{% else %}{{ escape_html(entry.text) }}{% endif %}
{% endif %} {% endfor %}
{% endif %} {% else if child.type == "note" %} {% else if child.type == "warning" %} {% else if child.type == "important" %} {% else if child.type == "horizontal-rule" %}
{% else if child.type == "table" %}
{% for row in child.rows %}{% if row.type == "table-header-row" %}{% for cell in row.cells %}{% if cell.type == "table-cell" %}{% endif %}{% endfor %} {% else if row.type == "table-row" %}{% for cell in row.cells %}{% if cell.type == "table-cell" %}{{ escape_html(cell.text) }}{% endif %}{% endfor %} {% endif %}{% endfor %}
{{ escape_html(cell.text) }}
{% else if child.type == "div" %}
{{ escape_html(child.text) }}
{% else if child.type == "list-placeholder" %} {% else if child.type == "catalog" %}
{% for entry in child.children %} {% if entry.type == "section-heading" %} {% for i in entry.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %} {% else if entry.type == "table" %}
{% for row in entry.rows %}{% if row.type == "table-row" %}{% for cell in row.cells %}{% if cell.type == "table-cell" %}{% endif %}{% endfor %} {% endif %}{% endfor %}
{% for i in cell.inlines %}{% if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% endif %}{% else if i.type == "text" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}
{% else if entry.type == "list" %} {% endif %} {% endfor %}
{% else %} {{ escape_html(child.text) }} {% endif %} {% endfor %}
{% else if block.type == "list-placeholder" %} {#- Reaching this branch is an invariant violation: the list-expander pass should have replaced every ListPlaceholder before rendering. The loud marker is intentional — a silent empty Div would let pipeline misconfiguration ship. -#} {% else if block.type == "catalog" %} {#- Catalog children re-use the existing block types (section-heading, table, list) but their dispatch is inlined here. Inja 3.5.0 has include/extends/blocks but no macros and no way to swap the iteration scope to child.children, so recursing into the top-level dispatch with a new context isn't expressible. De-duplication would require restructuring the whole content_blocks dispatch into a per-block partial; tracked separately. -#}
{% for child in block.children %} {% if child.type == "section-heading" %} {% for i in child.inlines %}{% if i.type == "text" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %} {% else if child.type == "table" %}
{% for row in child.rows %}{% if row.type == "table-row" %}{% for cell in row.cells %}{% if cell.type == "table-cell" %}{% endif %}{% endfor %} {% endif %}{% endfor %}
{% for i in cell.inlines %}{% if i.type == "link" %}{% if existsIn(i, "href") %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% else %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% else %}{% for c in i.children %}{% if c.type == "text" %}{{ escape_html(c.text) }}{% endif %}{% endfor %}{% endif %}{% else if i.type == "text" %}{{ escape_html(i.text) }}{% else %}{{ escape_html(i.text) }}{% endif %}{% endfor %}
{% else if child.type == "list" %} {% endif %} {% endfor %}
{% else %} {{ escape_html(block.text) }} {% endif %} {% endfor %}
{% else if existsIn(content, "text") %}
{{ escape_html(content.text) }}
{% endif %}