IR::Document Struct Reference

Intermediate representation for a documentation topic. More...

#include <document.h>

Collaboration diagram for IR::Document:

Public Member Functions
QJsonObject	toJson () const
	Converts the Document to a QJsonObject for template rendering.

Public Attributes
NodeType	nodeType { NodeType::NoType }
Genus	genus { Genus::DontCare }
Status	status { Status::Active }
Access	access { Access::Public }
QString	title
QString	fullTitle
QString	url
QString	since
QString	deprecatedSince
QString	brief
QJsonObject	contentJson

Detailed Description

Intermediate representation for a documentation topic.

Document contains all information needed to render a single documentation page using templates. All links are pre-resolved, sections are pre-organized, and file paths are pre-computed. The template engine receives only this IR and performs no lookups or resolution itself.

The struct includes classification metadata (nodeType, genus, status, access) that allows templates to conditionally render content based on the type and visibility of the documented entity.

Definition at line 18 of file document.h.

Member Function Documentation

toJson()

QJsonObject IR::Document::toJson

(

)

const

Converts the Document to a QJsonObject for template rendering.

The JSON structure follows a convention where field names use camelCase and match template variable names. Classification fields (nodeType, genus, status, access) use a two-part structure with "id" (stable kebab-case identifier for conditionals) and "label" (human-readable display name).

The contentJson field is nested under a 'content' key to provide better structure and namespace separation in templates.

Returns a QJsonObject containing all IR data in a format suitable for passing to the Inja template engine via InjaBridge.

Definition at line 128 of file document.cpp.

Member Data Documentation

access

Access IR::Document::access { Access::Public }

Definition at line 24 of file document.h.

Referenced by IR::Builder::buildPageIR().

brief

QString IR::Document::brief

Definition at line 32 of file document.h.

contentJson

QJsonObject IR::Document::contentJson

Definition at line 35 of file document.h.

deprecatedSince

QString IR::Document::deprecatedSince

Definition at line 31 of file document.h.

fullTitle

QString IR::Document::fullTitle

Definition at line 28 of file document.h.

genus

Genus IR::Document::genus { Genus::DontCare }

Definition at line 22 of file document.h.

Referenced by IR::Builder::buildPageIR().

nodeType

NodeType IR::Document::nodeType { NodeType::NoType }

Definition at line 21 of file document.h.

Referenced by IR::Builder::buildPageIR().

since

QString IR::Document::since

Definition at line 30 of file document.h.

status

Status IR::Document::status { Status::Active }

Definition at line 23 of file document.h.

Referenced by IR::Builder::buildPageIR().

title

QString IR::Document::title

Definition at line 27 of file document.h.

url

QString IR::Document::url

Definition at line 29 of file document.h.

---

The documentation for this struct was generated from the following files:

• qttools/src/qdoc/qdoc/src/qdoc/ir/document.h (1b6c1b21cbf9ba2a70ce4dd2ec3dc7574247e0de)
• qttools/src/qdoc/qdoc/src/qdoc/ir/document.cpp (1b6c1b21cbf9ba2a70ce4dd2ec3dc7574247e0de)