Doxygen
Loading...
Searching...
No Matches
DocbookDocVisitor Class Reference

Concrete visitor implementation for Docbook output. More...

#include <src/docbookvisitor.h>

Inheritance diagram for DocbookDocVisitor:
Collaboration diagram for DocbookDocVisitor:

Public Member Functions

 DocbookDocVisitor (TextStream &t, OutputCodeList &ci, const QCString &langExt)
template<class T>
void visitChildren (const T &t)
void operator() (const DocWord &)
void operator() (const DocLinkedWord &)
void operator() (const DocWhiteSpace &)
void operator() (const DocSymbol &)
void operator() (const DocEmoji &)
void operator() (const DocURL &)
void operator() (const DocLineBreak &)
void operator() (const DocHorRuler &)
void operator() (const DocStyleChange &)
void operator() (const DocVerbatim &)
void operator() (const DocAnchor &)
void operator() (const DocInclude &)
void operator() (const DocIncOperator &)
void operator() (const DocFormula &)
void operator() (const DocIndexEntry &)
void operator() (const DocSimpleSectSep &)
void operator() (const DocCite &)
void operator() (const DocSeparator &)
void operator() (const DocAutoList &)
void operator() (const DocAutoListItem &)
void operator() (const DocPara &)
void operator() (const DocRoot &)
void operator() (const DocSimpleSect &)
void operator() (const DocTitle &)
void operator() (const DocSimpleList &)
void operator() (const DocSimpleListItem &)
void operator() (const DocSection &)
void operator() (const DocHtmlList &)
void operator() (const DocHtmlListItem &)
void operator() (const DocHtmlDescList &)
void operator() (const DocHtmlDescTitle &)
void operator() (const DocHtmlDescData &)
void operator() (const DocHtmlTable &)
void operator() (const DocHtmlRow &)
void operator() (const DocHtmlCell &)
void operator() (const DocHtmlCaption &)
void operator() (const DocInternal &)
void operator() (const DocHRef &)
void operator() (const DocHtmlSummary &)
void operator() (const DocHtmlDetails &)
void operator() (const DocHtmlHeader &)
void operator() (const DocImage &)
void operator() (const DocDotFile &)
void operator() (const DocMscFile &)
void operator() (const DocDiaFile &)
void operator() (const DocPlantUmlFile &)
void operator() (const DocMermaidFile &)
void operator() (const DocLink &)
void operator() (const DocRef &)
void operator() (const DocSecRefItem &)
void operator() (const DocSecRefList &)
void operator() (const DocParamSect &)
void operator() (const DocParamList &)
void operator() (const DocXRefItem &)
void operator() (const DocInternalRef &)
void operator() (const DocText &)
void operator() (const DocHtmlBlockQuote &)
void operator() (const DocVhdlFlow &)
void operator() (const DocParBlock &)
Public Member Functions inherited from DocVisitor
 DocVisitor ()
virtual ~DocVisitor ()
CodeParserInterfacegetCodeParser (const QCString &langExt)
void pushHidden (bool hide)
bool popHidden ()

Private Member Functions

void filter (const QCString &str, const bool retainNewLine=false)
void startLink (const QCString &file, const QCString &anchor)
void endLink ()
void startMscFile (const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine, bool newFile=true)
void endMscFile (bool hasCaption)
void writeMscFile (const QCString &fileName, const DocVerbatim &s, bool newFile=true)
void startDiaFile (const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine, bool newFile=true)
void endDiaFile (bool hasCaption)
void writeDiaFile (const QCString &fileName, const DocVerbatim &s)
void startDotFile (const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine, bool newFile=true)
void endDotFile (bool hasCaption)
void writeDotFile (const QCString &fileName, const DocVerbatim &s, bool newFile=true)
void writePlantUMLFile (const QCString &fileName, const DocVerbatim &s)
void startPlantUmlFile (const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine)
void endPlantUmlFile (bool hasCaption)
void writeMermaidFile (const QCString &fileName, const DocVerbatim &s)
void startMermaidFile (const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine)
void endMermaidFile (bool hasCaption)
void visitPreStart (TextStream &t, const DocNodeList &children, bool hasCaption, const QCString &name, const QCString &width, const QCString &height, bool inlineImage=FALSE)
void visitPostEnd (TextStream &t, bool hasCaption, bool inlineImage=FALSE)
void visitCaption (const DocNodeList &children)

Private Attributes

TextStreamm_t
OutputCodeListm_ci
bool m_insidePre = false
bool m_hide = false
BoolStack m_enabled
QCString m_langExt
int m_colCnt = 0
BoolStack m_bodySet

Detailed Description

Concrete visitor implementation for Docbook output.

Definition at line 31 of file docbookvisitor.h.

Constructor & Destructor Documentation

◆ DocbookDocVisitor()

DocbookDocVisitor::DocbookDocVisitor ( TextStream & t,
OutputCodeList & ci,
const QCString & langExt )

Definition at line 156 of file docbookvisitor.cpp.

157 : m_t(t), m_ci(ci),m_langExt(langExt)
158{
160 // m_t << "<section>\n";
161}
OutputCodeList & m_ci
#define DB_VIS_C

References DB_VIS_C, m_ci, m_langExt, and m_t.

Member Function Documentation

◆ endDiaFile()

void DocbookDocVisitor::endDiaFile ( bool hasCaption)
private

Definition at line 1725 of file docbookvisitor.cpp.

1726{
1728 if (m_hide) return;
1729 visitPostEnd(m_t, hasCaption);
1730 m_t << "</para>\n";
1731}
void visitPostEnd(TextStream &t, bool hasCaption, bool inlineImage=FALSE)

References DB_VIS_C, m_hide, m_t, and visitPostEnd().

Referenced by operator()().

◆ endDotFile()

void DocbookDocVisitor::endDotFile ( bool hasCaption)
private

Definition at line 1764 of file docbookvisitor.cpp.

1765{
1767 if (m_hide) return;
1768 m_t << "\n";
1769 visitPostEnd(m_t, hasCaption);
1770 m_t << "</para>\n";
1771}

References DB_VIS_C, m_hide, m_t, and visitPostEnd().

Referenced by operator()().

◆ endLink()

void DocbookDocVisitor::endLink ( )
private

Definition at line 1554 of file docbookvisitor.cpp.

1555{
1557 m_t << "</link>";
1558}

References DB_VIS_C, and m_t.

Referenced by operator()(), operator()(), operator()(), operator()(), and operator()().

◆ endMermaidFile()

void DocbookDocVisitor::endMermaidFile ( bool hasCaption)
private

Definition at line 1659 of file docbookvisitor.cpp.

1660{
1662 if (m_hide) return;
1663 m_t << "\n";
1664 visitPostEnd(m_t, hasCaption);
1665 m_t << "</para>\n";
1666}

References DB_VIS_C, m_hide, m_t, and visitPostEnd().

Referenced by operator()().

◆ endMscFile()

void DocbookDocVisitor::endMscFile ( bool hasCaption)
private

Definition at line 1687 of file docbookvisitor.cpp.

1688{
1690 if (m_hide) return;
1691 visitPostEnd(m_t, hasCaption);
1692 m_t << "</para>\n";
1693}

References DB_VIS_C, m_hide, m_t, and visitPostEnd().

Referenced by operator()().

◆ endPlantUmlFile()

void DocbookDocVisitor::endPlantUmlFile ( bool hasCaption)
private

Definition at line 1610 of file docbookvisitor.cpp.

1611{
1613 if (m_hide) return;
1614 m_t << "\n";
1615 visitPostEnd(m_t, hasCaption);
1616 m_t << "</para>\n";
1617}

References DB_VIS_C, m_hide, m_t, and visitPostEnd().

Referenced by operator()(), and startPlantUmlFile().

◆ filter()

void DocbookDocVisitor::filter ( const QCString & str,
const bool retainNewLine = false )
private

Definition at line 1536 of file docbookvisitor.cpp.

1537{
1539 m_t << convertToDocBook(str, retainNewLine);
1540}
QCString convertToDocBook(const QCString &s, const bool retainNewline)

References convertToDocBook(), DB_VIS_C, and m_t.

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

◆ operator()() [1/59]

void DocbookDocVisitor::operator() ( const DocAnchor & anc)

Definition at line 419 of file docbookvisitor.cpp.

420{
422 if (m_hide) return;
423 m_t << "<anchor xml:id=\"_" << stripPath(anc.file()) << "_1" << filterId(anc.anchor()) << "\"/>";
424}
QCString anchor() const
Definition docnode.h:232
QCString file() const
Definition docnode.h:233
static QCString filterId(const QCString &s)
QCString stripPath(const QCString &s)
Definition util.cpp:4969

References DocAnchor::anchor(), DB_VIS_C, DocAnchor::file(), filterId(), m_hide, m_t, and stripPath().

◆ operator()() [2/59]

void DocbookDocVisitor::operator() ( const DocAutoList & l)

Definition at line 600 of file docbookvisitor.cpp.

601{
603 if (m_hide) return;
604 if (l.isEnumList())
605 {
606 m_t << "<orderedlist>\n";
607 }
608 else
609 {
610 m_t << "<itemizedlist>\n";
611 }
612 visitChildren(l);
613 if (l.isEnumList())
614 {
615 m_t << "</orderedlist>\n";
616 }
617 else
618 {
619 m_t << "</itemizedlist>\n";
620 }
621}
bool isEnumList() const
Definition docnode.h:580
void visitChildren(const T &t)

References DB_VIS_C, DocAutoList::isEnumList(), m_hide, m_t, and visitChildren().

◆ operator()() [3/59]

void DocbookDocVisitor::operator() ( const DocAutoListItem & li)

Definition at line 623 of file docbookvisitor.cpp.

624{
626 if (m_hide) return;
627 switch (li.itemNumber())
628 {
629 case DocAutoList::Unchecked: // unchecked
630 m_t << "<listitem override=\"unchecked\">";
631 break;
632 case DocAutoList::Checked_x: // checked with x
633 case DocAutoList::Checked_X: // checked with X
634 m_t << "<listitem override=\"checked\">";
635 break;
636 default:
637 m_t << "<listitem>";
638 break;
639 }
640 visitChildren(li);
641 m_t << "</listitem>";
642}
int itemNumber() const
Definition docnode.h:598

References DocAutoList::Checked_X, DocAutoList::Checked_x, DB_VIS_C, DocAutoListItem::itemNumber(), m_hide, m_t, DocAutoList::Unchecked, and visitChildren().

◆ operator()() [4/59]

void DocbookDocVisitor::operator() ( const DocCite & cite)

Definition at line 573 of file docbookvisitor.cpp.

574{
576 if (m_hide) return;
577 auto opt = cite.option();
578 if (!cite.file().isEmpty())
579 {
580 if (!opt.noCite()) startLink(cite.file(),filterId(cite.anchor()));
581
582 filter(cite.getText());
583
584 if (!opt.noCite()) endLink();
585 }
586 else
587 {
588 if (!opt.noPar()) filter("[");
589 filter(cite.target());
590 if (!opt.noPar()) filter("]");
591
592 }
593
594}
QCString getText() const
Definition docnode.cpp:974
CiteInfoOption option() const
Definition docnode.h:253
QCString target() const
Definition docnode.h:252
QCString anchor() const
Definition docnode.h:251
QCString file() const
Definition docnode.h:248
void filter(const QCString &str, const bool retainNewLine=false)
void startLink(const QCString &file, const QCString &anchor)
bool isEmpty() const
Returns TRUE iff the string is empty.
Definition qcstring.h:163

References DocCite::anchor(), DB_VIS_C, endLink(), DocCite::file(), filter(), filterId(), DocCite::getText(), QCString::isEmpty(), m_hide, DocCite::option(), startLink(), and DocCite::target().

◆ operator()() [5/59]

void DocbookDocVisitor::operator() ( const DocDiaFile & df)

Definition at line 1276 of file docbookvisitor.cpp.

1277{
1279 if (m_hide) return;
1280 bool exists = false;
1281 std::string inBuf;
1282 if (readInputFile(df.file(),inBuf))
1283 {
1284 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
1285 ".dia", // extension
1286 inBuf, // contents
1287 exists);
1288 if (!fileName.isEmpty())
1289 {
1290 startDiaFile(fileName,df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine(),!exists);
1291 visitChildren(df);
1292 endDiaFile(df.hasCaption());
1293 }
1294 }
1295}
DocNodeList & children()
Definition docnode.h:143
QCString relPath() const
Definition docnode.h:686
QCString height() const
Definition docnode.h:689
QCString srcFile() const
Definition docnode.h:691
QCString file() const
Definition docnode.h:685
int srcLine() const
Definition docnode.h:692
bool hasCaption() const
Definition docnode.h:687
QCString width() const
Definition docnode.h:688
void endDiaFile(bool hasCaption)
void startDiaFile(const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine, bool newFile=true)
#define Config_getString(name)
Definition config.h:32
QCString writeFileContents(const QCString &baseName, const QCString &extension, const QCString &content, bool &exists)
Thread-safe function to write a string to a file.
Definition util.cpp:6977
bool readInputFile(const QCString &fileName, std::string &contents, bool filter, bool isSourceCode)
read a file name fileName and optionally filter and transcode it
Definition util.cpp:5570

References DocCompoundNode::children(), Config_getString, DB_VIS_C, endDiaFile(), DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), DocDiagramFileBase::height(), m_hide, readInputFile(), DocDiagramFileBase::relPath(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), startDiaFile(), stripPath(), visitChildren(), DocDiagramFileBase::width(), and writeFileContents().

◆ operator()() [6/59]

void DocbookDocVisitor::operator() ( const DocDotFile & df)

Definition at line 1234 of file docbookvisitor.cpp.

1235{
1237 if (m_hide) return;
1238 bool exists = false;
1239 std::string inBuf;
1240 if (readInputFile(df.file(),inBuf))
1241 {
1242 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
1243 ".dot", // extension
1244 inBuf, // contents
1245 exists);
1246 if (!fileName.isEmpty())
1247 {
1248 startDotFile(fileName,df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine(),!exists);
1249 visitChildren(df);
1250 endDotFile(df.hasCaption());
1251 }
1252 }
1253}
void startDotFile(const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine, bool newFile=true)
void endDotFile(bool hasCaption)

References DocCompoundNode::children(), Config_getString, DB_VIS_C, endDotFile(), DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), DocDiagramFileBase::height(), m_hide, readInputFile(), DocDiagramFileBase::relPath(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), startDotFile(), stripPath(), visitChildren(), DocDiagramFileBase::width(), and writeFileContents().

◆ operator()() [7/59]

void DocbookDocVisitor::operator() ( const DocEmoji & s)

Definition at line 212 of file docbookvisitor.cpp.

213{
215 if (m_hide) return;
216 const char *res = EmojiEntityMapper::instance().unicode(s.index());
217 if (res)
218 {
219 m_t << res;
220 }
221 else
222 {
223 m_t << s.name();
224 }
225}
int index() const
Definition docnode.h:345
QCString name() const
Definition docnode.h:344
const char * unicode(int index) const
Access routine to the unicode sequence for the Emoji entity.
Definition emoji.cpp:2016
static EmojiEntityMapper & instance()
Returns the one and only instance of the Emoji entity mapper.
Definition emoji.cpp:1978

References DB_VIS_C, DocEmoji::index(), EmojiEntityMapper::instance(), m_hide, m_t, DocEmoji::name(), and EmojiEntityMapper::unicode().

◆ operator()() [8/59]

void DocbookDocVisitor::operator() ( const DocFormula & f)

Definition at line 543 of file docbookvisitor.cpp.

544{
546 if (m_hide) return;
547
548 if (f.isInline()) m_t << "<inlinemediaobject>\n";
549 else m_t << " <mediaobject>\n";
550 m_t << " <imageobject>\n";
551 m_t << " <imagedata ";
552 m_t << "align=\"center\" valign=\"middle\" scalefit=\"0\" fileref=\"" << f.relPath() << f.name() << ".png\"/>\n";
553 m_t << " </imageobject>\n";
554 if (f.isInline()) m_t << "</inlinemediaobject>\n";
555 else m_t << " </mediaobject>\n";
556}
QCString name() const
Definition docnode.h:532
bool isInline() const
Definition docnode.h:536
QCString relPath() const
Definition docnode.h:534

References DB_VIS_C, DocFormula::isInline(), m_hide, m_t, DocFormula::name(), and DocFormula::relPath().

◆ operator()() [9/59]

void DocbookDocVisitor::operator() ( const DocHorRuler & )

Definition at line 248 of file docbookvisitor.cpp.

249{
251 if (m_hide) return;
252 m_t << "<informaltable frame='bottom'><tgroup cols='1'><colspec align='center'/><tbody><row><entry align='center'>\n";
253 m_t << "</entry></row></tbody></tgroup></informaltable>\n";
254}

References DB_VIS_C, m_hide, and m_t.

◆ operator()() [10/59]

void DocbookDocVisitor::operator() ( const DocHRef & href)

Definition at line 1159 of file docbookvisitor.cpp.

1160{
1162 if (m_hide) return;
1163 if (href.url().at(0) != '#')
1164 {
1165 m_t << "<link xlink:href=\"" << convertToDocBook(href.url()) << "\">";
1166 }
1167 else
1168 {
1169 startLink(href.file(),filterId(href.url().mid(1)));
1170 }
1171 visitChildren(href);
1172 m_t << "</link>";
1173}
QCString url() const
Definition docnode.h:839
QCString file() const
Definition docnode.h:840
QCString mid(size_t index, size_t len=static_cast< size_t >(-1)) const
Definition qcstring.h:241
char & at(size_t i)
Returns a reference to the character at index i.
Definition qcstring.h:593

References QCString::at(), convertToDocBook(), DB_VIS_C, DocHRef::file(), filterId(), m_hide, m_t, QCString::mid(), startLink(), DocHRef::url(), and visitChildren().

◆ operator()() [11/59]

void DocbookDocVisitor::operator() ( const DocHtmlBlockQuote & q)

Definition at line 1513 of file docbookvisitor.cpp.

1514{
1516 if (m_hide) return;
1517 m_t << "<blockquote>";
1518 visitChildren(q);
1519 m_t << "</blockquote>";
1520}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [12/59]

void DocbookDocVisitor::operator() ( const DocHtmlCaption & c)

Definition at line 1139 of file docbookvisitor.cpp.

1140{
1142 if (m_hide) return;
1143 m_t << "<caption>";
1144 if (!c.file().isEmpty())
1145 {
1146 m_t << "<anchor xml:id=\"_" << stripPath(c.file()) << "_1" << filterId(c.anchor()) << "\"/>";
1147 }
1148 visitChildren(c);
1149 m_t << "</caption>\n";
1150}
QCString anchor() const
Definition docnode.h:1241
QCString file() const
Definition docnode.h:1240

References DocHtmlCaption::anchor(), DB_VIS_C, DocHtmlCaption::file(), filterId(), QCString::isEmpty(), m_hide, m_t, stripPath(), and visitChildren().

◆ operator()() [13/59]

void DocbookDocVisitor::operator() ( const DocHtmlCell & c)

Definition at line 1084 of file docbookvisitor.cpp.

1085{
1087 m_colCnt++;
1088 if (m_hide) return;
1089 m_t << "<entry";
1090
1091 for (const auto &opt : c.attribs())
1092 {
1093 if (opt.name=="colspan")
1094 {
1095 m_t << " namest='c" << m_colCnt << "'";
1096 int cols = opt.value.toInt();
1097 m_colCnt += (cols - 1);
1098 m_t << " nameend='c" << m_colCnt << "'";
1099 }
1100 else if (opt.name=="rowspan")
1101 {
1102 int extraRows = opt.value.toInt() - 1;
1103 m_t << " morerows='" << extraRows << "'";
1104 }
1105 else if (opt.name=="class")
1106 {
1107 if (opt.value.startsWith("markdownTable")) // handle markdown generated attributes
1108 {
1109 if (opt.value.endsWith("Right"))
1110 {
1111 m_t << " align='right'";
1112 }
1113 else if (opt.value.endsWith("Left"))
1114 {
1115 m_t << " align='left'";
1116 }
1117 else if (opt.value.endsWith("Center"))
1118 {
1119 m_t << " align='center'";
1120 }
1121 // skip 'markdownTable*' value ending with "None"
1122 }
1123 else
1124 {
1125 m_t << " class='" << convertToDocBook(opt.value) << "'";
1126 }
1127 }
1128 else if (supportedHtmlAttribute(opt.name))
1129 {
1130 // process supported attributes only
1131 m_t << " " << opt.name << "='" << convertToDocBook(opt.value) << "'";
1132 }
1133 }
1134 m_t << ">";
1135 visitChildren(c);
1136 m_t << "</entry>";
1137}
const HtmlAttribList & attribs() const
Definition docnode.h:1211
static bool supportedHtmlAttribute(const QCString &name)

References DocHtmlCell::attribs(), convertToDocBook(), DB_VIS_C, m_colCnt, m_hide, m_t, supportedHtmlAttribute(), and visitChildren().

◆ operator()() [14/59]

void DocbookDocVisitor::operator() ( const DocHtmlDescData & dd)

Definition at line 1014 of file docbookvisitor.cpp.

1015{
1017 if (m_hide) return;
1018 m_t << "<listitem>";
1019 visitChildren(dd);
1020 m_t << "</listitem>\n";
1021}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [15/59]

void DocbookDocVisitor::operator() ( const DocHtmlDescList & l)

Definition at line 996 of file docbookvisitor.cpp.

997{
999 if (m_hide) return;
1000 m_t << "<variablelist>\n";
1001 visitChildren(l);
1002 m_t << "</variablelist>\n";
1003}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [16/59]

void DocbookDocVisitor::operator() ( const DocHtmlDescTitle & dt)

Definition at line 1005 of file docbookvisitor.cpp.

1006{
1008 if (m_hide) return;
1009 m_t << "<varlistentry><term>";
1010 visitChildren(dt);
1011 m_t << "</term></varlistentry>\n";
1012}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [17/59]

void DocbookDocVisitor::operator() ( const DocHtmlDetails & d)

Definition at line 1184 of file docbookvisitor.cpp.

1185{
1187 if (m_hide) return;
1188 m_t << "\n";
1189 auto summary = d.summary();
1190 if (summary)
1191 {
1192 std::visit(*this,*summary);
1193 }
1194 m_t << "<para>";
1195 visitChildren(d);
1196 m_t << "</para>";
1197 m_t << "\n";
1198}
const DocNodeVariant * summary() const
Definition docnode.h:873

References DB_VIS_C, m_hide, m_t, DocHtmlDetails::summary(), and visitChildren().

◆ operator()() [18/59]

void DocbookDocVisitor::operator() ( const DocHtmlHeader & h)

Definition at line 1200 of file docbookvisitor.cpp.

1201{
1203 if (m_hide) return;
1204 m_t << "<formalpara><title>";
1205 visitChildren(h);
1206 m_t << "</title></formalpara>\n";
1207}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [19/59]

void DocbookDocVisitor::operator() ( const DocHtmlList & s)

Definition at line 917 of file docbookvisitor.cpp.

918{
920 if (m_hide) return;
921 if (s.children().empty()) return;
922 // opening tag for ordered list will be handled in DocHtmlListItem
923 // due to (re-)numbering possibilities
924 if (s.type()!=DocHtmlList::Ordered)
925 m_t << "<itemizedlist>\n";
926 visitChildren(s);
927 if (s.type()==DocHtmlList::Ordered)
928 m_t << "</orderedlist>\n";
929 else
930 m_t << "</itemizedlist>\n";
931}
Type type() const
Definition docnode.h:1014
bool empty() const
checks whether the container is empty
Definition growvector.h:140

References DocCompoundNode::children(), DB_VIS_C, GrowVector< T >::empty(), m_hide, m_t, DocHtmlList::Ordered, DocHtmlList::type(), and visitChildren().

◆ operator()() [20/59]

void DocbookDocVisitor::operator() ( const DocHtmlListItem & s)

Definition at line 933 of file docbookvisitor.cpp.

934{
936 if (m_hide) return;
937 const DocHtmlList *l = std::get_if<DocHtmlList>(s.parent());
938 if (l->type()==DocHtmlList::Ordered)
939 {
940 bool isFirst = &std::get<DocHtmlListItem>(l->children().front())==&s;
941 int value = 0;
942 QCString type;
943 for (const auto &opt : s.attribs())
944 {
945 if (opt.name=="value")
946 {
947 bool ok = false;
948 int val = opt.value.toInt(&ok);
949 if (ok) value = val;
950 }
951 }
952
953 if (value>0 || isFirst)
954 {
955 for (const auto &opt : l->attribs())
956 {
957 if (opt.name=="type")
958 {
959 if (opt.value=="1")
960 type = " numeration=\"arabic\"";
961 else if (opt.value=="a")
962 type = " numeration=\"loweralpha\"";
963 else if (opt.value=="A")
964 type = " numeration=\"upperalpha\"";
965 else if (opt.value=="i")
966 type = " numeration=\"lowerroman\"";
967 else if (opt.value=="I")
968 type = " numeration=\"upperroman\"";
969 }
970 else if (value==0 && opt.name=="start")
971 {
972 bool ok = false;
973 int val = opt.value.toInt(&ok);
974 if (ok) value = val;
975 }
976 }
977 }
978
979 if (value>0 && !isFirst)
980 {
981 m_t << "</orderedlist>\n";
982 }
983 if (value>0 || isFirst)
984 {
985 m_t << "<orderedlist";
986 if (!type.isEmpty()) m_t << type.data();
987 if (value>0) m_t << " startingnumber=\"" << value << "\"";
988 m_t << ">\n";
989 }
990 }
991 m_t << "<listitem>\n";
992 visitChildren(s);
993 m_t << "</listitem>\n";
994}
const HtmlAttribList & attribs() const
Definition docnode.h:1015
const HtmlAttribList & attribs() const
Definition docnode.h:1176
DocNodeVariant * parent()
Definition docnode.h:90
T & front()
access the first element
Definition growvector.h:130
const char * data() const
Returns a pointer to the contents of the string in the form of a 0-terminated C string.
Definition qcstring.h:172

References DocHtmlList::attribs(), DocHtmlListItem::attribs(), DocCompoundNode::children(), QCString::data(), DB_VIS_C, GrowVector< T >::front(), QCString::isEmpty(), m_hide, m_t, DocHtmlList::Ordered, DocNode::parent(), DocHtmlList::type(), and visitChildren().

◆ operator()() [21/59]

void DocbookDocVisitor::operator() ( const DocHtmlRow & tr)

Definition at line 1046 of file docbookvisitor.cpp.

1047{
1049 m_colCnt = 0;
1050 if (m_hide) return;
1051
1052 if (tr.isHeading())
1053 {
1054 if (m_bodySet.top()) m_t << "</tbody>\n";
1055 m_bodySet.top() = false;
1056 m_t << "<thead>\n";
1057 }
1058 else if (!m_bodySet.top())
1059 {
1060 m_bodySet.top() = true;
1061 m_t << "<tbody>\n";
1062 }
1063
1064 m_t << " <row ";
1065
1066 for (const auto &opt : tr.attribs())
1067 {
1068 if (supportedHtmlAttribute(opt.name))
1069 {
1070 // process supported attributes only
1071 m_t << " " << opt.name << "='" << convertToDocBook(opt.value) << "'";
1072 }
1073 }
1074 m_t << ">\n";
1075 visitChildren(tr);
1076 m_t << "</row>\n";
1077 if (tr.isHeading())
1078 {
1079 m_t << "</thead><tbody>\n";
1080 m_bodySet.top() = true;
1081 }
1082}
bool isHeading() const
Definition docnode.cpp:2002
const HtmlAttribList & attribs() const
Definition docnode.h:1258

References DocHtmlRow::attribs(), convertToDocBook(), DB_VIS_C, DocHtmlRow::isHeading(), m_bodySet, m_colCnt, m_hide, m_t, supportedHtmlAttribute(), and visitChildren().

◆ operator()() [22/59]

void DocbookDocVisitor::operator() ( const DocHtmlSummary & s)

Definition at line 1175 of file docbookvisitor.cpp.

1176{
1178 if (m_hide) return;
1179 m_t << "<para><emphasis role=\"bold\">";
1180 visitChildren(s);
1181 m_t << "</emphasis></para>";
1182}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [23/59]

void DocbookDocVisitor::operator() ( const DocHtmlTable & t)

Definition at line 1023 of file docbookvisitor.cpp.

1024{
1026 m_bodySet.push(false);
1027 if (m_hide) return;
1028 m_t << "<informaltable frame=\"all\">\n";
1029 m_t << " <tgroup cols=\"" << t.numColumns() << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n";
1030 for (uint32_t i = 0; i <t.numColumns(); i++)
1031 {
1032 // do something with colwidth based of cell width specification (be aware of possible colspan in the header)?
1033 m_t << " <colspec colname='c" << i+1 << "'/>\n";
1034 }
1035 if (t.caption())
1036 {
1037 std::visit(*this,*t.caption());
1038 }
1039 visitChildren(t);
1040 if (m_bodySet.top()) m_t << " </tbody>\n";
1041 m_bodySet.pop();
1042 m_t << " </tgroup>\n";
1043 m_t << "</informaltable>\n";
1044}
size_t numColumns() const
Definition docnode.h:1284
const DocNodeVariant * caption() const
Definition docnode.cpp:2250

References DocHtmlTable::caption(), DB_VIS_C, m_bodySet, m_hide, m_t, DocHtmlTable::numColumns(), and visitChildren().

◆ operator()() [24/59]

void DocbookDocVisitor::operator() ( const DocImage & img)

Definition at line 1209 of file docbookvisitor.cpp.

1210{
1212 if (img.type()==DocImage::DocBook)
1213 {
1214 if (m_hide) return;
1215 m_t << "\n";
1216 QCString baseName=stripPath(img.name());
1217 visitPreStart(m_t, img.children(), img.hasCaption(), img.relPath() + baseName, img.width(), img.height(), img.isInlineImage());
1218 visitChildren(img);
1220 QCString file;
1221 bool ambig = false;
1222 FileDef *fd=findFileDef(Doxygen::imageNameLinkedMap, baseName, ambig);
1223 if (fd)
1224 {
1225 file=fd->absFilePath();
1226 }
1227 copyFile(file,Config_getString(DOCBOOK_OUTPUT)+"/"+baseName);
1228 }
1229 else // skip other formats
1230 {
1231 }
1232}
QCString relPath() const
Definition docnode.h:652
QCString name() const
Definition docnode.h:648
QCString height() const
Definition docnode.h:651
Type type() const
Definition docnode.h:647
QCString width() const
Definition docnode.h:650
@ DocBook
Definition docnode.h:644
bool isInlineImage() const
Definition docnode.h:654
bool hasCaption() const
Definition docnode.h:649
void visitPreStart(TextStream &t, const DocNodeList &children, bool hasCaption, const QCString &name, const QCString &width, const QCString &height, bool inlineImage=FALSE)
static FileNameLinkedMap * imageNameLinkedMap
Definition doxygen.h:105
virtual QCString absFilePath() const =0
bool copyFile(const QCString &src, const QCString &dest)
Copies the contents of file with name src to the newly created file with name dest.
Definition util.cpp:5875
FileDef * findFileDef(const FileNameLinkedMap *fnMap, const QCString &n, bool &ambig)
Definition util.cpp:2904

References FileDef::absFilePath(), DocCompoundNode::children(), Config_getString, copyFile(), DB_VIS_C, DocImage::DocBook, findFileDef(), DocImage::hasCaption(), DocImage::height(), Doxygen::imageNameLinkedMap, DocImage::isInlineImage(), m_hide, m_t, DocImage::name(), DocImage::relPath(), stripPath(), DocImage::type(), visitChildren(), visitPostEnd(), visitPreStart(), and DocImage::width().

◆ operator()() [25/59]

void DocbookDocVisitor::operator() ( const DocInclude & inc)

Definition at line 426 of file docbookvisitor.cpp.

427{
429 if (m_hide) return;
431 switch(inc.type())
432 {
434 {
435 m_t << "<literallayout><computeroutput>";
436 FileInfo cfi( inc.file().str() );
437 auto fd = createFileDef( cfi.dirPath(), cfi.fileName() );
439 inc.text(),
440 langExt,
441 inc.stripCodeComments(),
442 CodeParserOptions()
443 .setExample(inc.isExample(),inc.exampleFile())
444 .setFileDef(fd.get())
445 );
446 m_t << "</computeroutput></literallayout>";
447 }
448 break;
450 m_t << "<literallayout><computeroutput>";
452 inc.text(),
453 langExt,
454 inc.stripCodeComments(),
455 CodeParserOptions()
456 .setExample(inc.isExample(),inc.exampleFile())
457 );
458 m_t << "</computeroutput></literallayout>";
459 break;
467 break;
469 m_t << inc.text();
470 break;
472 m_t << "<literallayout>";
473 filter(inc.text());
474 m_t << "</literallayout>";
475 break;
478 m_t << "<literallayout><computeroutput>";
480 inc.file(),
481 inc.blockId(),
482 inc.context(),
484 inc.trimLeft(),
486 );
487 m_t << "</computeroutput></literallayout>";
488 break;
489 }
490}
void parseCodeFragment(OutputCodeList &codeOutList, const QCString &fileName, const QCString &blockId, const QCString &scopeName, bool showLineNumbers, bool trimLeft, bool stripCodeComments)
static CodeFragmentManager & instance()
virtual void parseCode(OutputCodeList &codeOutList, const QCString &scopeName, const QCString &input, SrcLangExt lang, bool stripCodeComments, const CodeParserOptions &options)=0
Parses a source file or fragment with the goal to produce highlighted and cross-referenced output.
QCString blockId() const
Definition docnode.h:454
QCString extension() const
Definition docnode.h:450
bool stripCodeComments() const
Definition docnode.h:455
@ LatexInclude
Definition docnode.h:437
@ SnippetWithLines
Definition docnode.h:438
@ DontIncWithLines
Definition docnode.h:439
@ IncWithLines
Definition docnode.h:438
@ HtmlInclude
Definition docnode.h:437
@ VerbInclude
Definition docnode.h:437
@ DontInclude
Definition docnode.h:437
@ DocbookInclude
Definition docnode.h:439
Type type() const
Definition docnode.h:451
QCString exampleFile() const
Definition docnode.h:457
QCString text() const
Definition docnode.h:452
QCString file() const
Definition docnode.h:449
bool trimLeft() const
Definition docnode.h:459
bool isExample() const
Definition docnode.h:456
QCString context() const
Definition docnode.h:453
CodeParserInterface & getCodeParser(const QCString &langExt)
const std::string & str() const
Definition qcstring.h:552
std::unique_ptr< FileDef > createFileDef(const QCString &p, const QCString &n, const QCString &ref, const QCString &dn)
Definition filedef.cpp:268
SrcLangExt
Definition types.h:207
SrcLangExt getLanguageFromFileName(const QCString &fileName, SrcLangExt defLang)
Definition util.cpp:5231

References DocInclude::blockId(), DocInclude::context(), createFileDef(), DB_VIS_C, FileInfo::dirPath(), DocInclude::DocbookInclude, DocInclude::DontInclude, DocInclude::DontIncWithLines, DocInclude::exampleFile(), DocInclude::extension(), DocInclude::file(), FileInfo::fileName(), filter(), DocVisitor::getCodeParser(), getLanguageFromFileName(), DocInclude::HtmlInclude, DocInclude::Include, DocInclude::IncWithLines, CodeFragmentManager::instance(), DocInclude::isExample(), DocInclude::LatexInclude, m_ci, m_hide, m_t, DocInclude::ManInclude, CodeParserInterface::parseCode(), CodeFragmentManager::parseCodeFragment(), DocInclude::RtfInclude, CodeParserOptions::setFileDef(), DocInclude::Snippet, DocInclude::SnippetWithLines, QCString::str(), DocInclude::stripCodeComments(), DocInclude::text(), DocInclude::trimLeft(), DocInclude::type(), DocInclude::VerbInclude, and DocInclude::XmlInclude.

◆ operator()() [26/59]

void DocbookDocVisitor::operator() ( const DocIncOperator & op)

Definition at line 492 of file docbookvisitor.cpp.

493{
495 if (op.isFirst())
496 {
497 if (!m_hide)
498 {
499 m_t << "<programlisting linenumbering=\"unnumbered\">";
500 }
502 m_hide = TRUE;
503 }
504 QCString locLangExt = getFileNameExtension(op.includeFileName());
505 if (locLangExt.isEmpty()) locLangExt = m_langExt;
506 SrcLangExt langExt = getLanguageFromFileName(locLangExt);
507 if (op.type()!=DocIncOperator::Skip)
508 {
509 m_hide = popHidden();
510 if (!m_hide)
511 {
512 std::unique_ptr<FileDef> fd;
513 if (!op.includeFileName().isEmpty())
514 {
515 FileInfo cfi( op.includeFileName().str() );
516 fd = createFileDef( cfi.dirPath(), cfi.fileName() );
517 }
518
519 getCodeParser(locLangExt).parseCode(m_ci,op.context(),
520 op.text(),langExt,
522 CodeParserOptions()
523 .setExample(op.isExample(), op.exampleFile())
524 .setFileDef(fd.get())
525 .setStartLine(op.line())
526 .setShowLineNumbers(op.showLineNo())
527 );
528 }
530 m_hide=TRUE;
531 }
532 if (op.isLast())
533 {
534 m_hide = popHidden();
535 if (!m_hide) m_t << "</programlisting>";
536 }
537 else
538 {
539 if (!m_hide) m_t << "\n";
540 }
541}
bool stripCodeComments() const
Definition docnode.h:506
bool isLast() const
Definition docnode.h:503
QCString includeFileName() const
Definition docnode.h:509
QCString text() const
Definition docnode.h:499
QCString context() const
Definition docnode.h:501
QCString exampleFile() const
Definition docnode.h:508
int line() const
Definition docnode.h:497
Type type() const
Definition docnode.h:485
bool isFirst() const
Definition docnode.h:502
bool showLineNo() const
Definition docnode.h:498
bool isExample() const
Definition docnode.h:507
void pushHidden(bool hide)
bool popHidden()
#define TRUE
Definition qcstring.h:37
QCString getFileNameExtension(const QCString &fn)
Definition util.cpp:5273

References DocIncOperator::context(), createFileDef(), DB_VIS_C, FileInfo::dirPath(), DocIncOperator::exampleFile(), FileInfo::fileName(), DocVisitor::getCodeParser(), getFileNameExtension(), getLanguageFromFileName(), DocIncOperator::includeFileName(), QCString::isEmpty(), DocIncOperator::isExample(), DocIncOperator::isFirst(), DocIncOperator::isLast(), DocIncOperator::line(), m_ci, m_hide, m_langExt, m_t, CodeParserInterface::parseCode(), DocVisitor::popHidden(), DocVisitor::pushHidden(), CodeParserOptions::setFileDef(), CodeParserOptions::setShowLineNumbers(), CodeParserOptions::setStartLine(), DocIncOperator::showLineNo(), DocIncOperator::Skip, QCString::str(), DocIncOperator::stripCodeComments(), DocIncOperator::text(), TRUE, and DocIncOperator::type().

◆ operator()() [27/59]

void DocbookDocVisitor::operator() ( const DocIndexEntry & ie)

Definition at line 558 of file docbookvisitor.cpp.

559{
561 if (m_hide) return;
562 m_t << "<indexterm><primary>";
563 filter(ie.entry());
564 m_t << "</primary></indexterm>\n";
565}
QCString entry() const
Definition docnode.h:559

References DB_VIS_C, DocIndexEntry::entry(), filter(), m_hide, and m_t.

◆ operator()() [28/59]

void DocbookDocVisitor::operator() ( const DocInternal & i)

Definition at line 1152 of file docbookvisitor.cpp.

1153{
1155 if (m_hide) return;
1156 visitChildren(i);
1157}

References DB_VIS_C, m_hide, and visitChildren().

◆ operator()() [29/59]

void DocbookDocVisitor::operator() ( const DocInternalRef & ref)

Definition at line 1496 of file docbookvisitor.cpp.

1497{
1499 if (m_hide) return;
1500 startLink(ref.file(),ref.anchor());
1501 visitChildren(ref);
1502 endLink();
1503 m_t << " ";
1504}
QCString file() const
Definition docnode.h:820
QCString anchor() const
Definition docnode.h:822

References DocInternalRef::anchor(), DB_VIS_C, endLink(), DocInternalRef::file(), m_hide, m_t, startLink(), and visitChildren().

◆ operator()() [30/59]

void DocbookDocVisitor::operator() ( const DocLineBreak & )

Definition at line 239 of file docbookvisitor.cpp.

240{
242 if (m_hide) return;
243 m_t << "<?linebreak?>";
244 // gives nicer results but gives problems as it is not allowed in <pare> and also problems with dblatex
245 // m_t << "\n" << "<sbr/>\n";
246}

References DB_VIS_C, m_hide, and m_t.

◆ operator()() [31/59]

void DocbookDocVisitor::operator() ( const DocLink & lnk)

Definition at line 1318 of file docbookvisitor.cpp.

1319{
1321 if (m_hide) return;
1322 startLink(lnk.file(),lnk.anchor());
1323 visitChildren(lnk);
1324 endLink();
1325}

References DocLink::anchor(), DB_VIS_C, endLink(), DocLink::file(), m_hide, startLink(), and visitChildren().

◆ operator()() [32/59]

void DocbookDocVisitor::operator() ( const DocLinkedWord & w)

Definition at line 174 of file docbookvisitor.cpp.

175{
177 if (m_hide) return;
178 startLink(w.file(),w.anchor());
179 filter(w.word());
180 endLink();
181}
QCString file() const
Definition docnode.h:171
QCString word() const
Definition docnode.h:170
QCString anchor() const
Definition docnode.h:174

References DocLinkedWord::anchor(), DB_VIS_C, endLink(), DocLinkedWord::file(), filter(), m_hide, startLink(), and DocLinkedWord::word().

◆ operator()() [33/59]

void DocbookDocVisitor::operator() ( const DocMermaidFile & df)

Definition at line 1307 of file docbookvisitor.cpp.

1308{
1310 if (m_hide) return;
1311 if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
1312 if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file()));
1313 startMermaidFile(df.file(),df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine());
1314 visitChildren(df);
1316}
void endMermaidFile(bool hasCaption)
void startMermaidFile(const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine)
#define Config_getBool(name)
Definition config.h:33

References DocCompoundNode::children(), Config_getBool, Config_getString, copyFile(), DB_VIS_C, endMermaidFile(), DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), DocDiagramFileBase::height(), m_hide, DocDiagramFileBase::relPath(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), startMermaidFile(), stripPath(), visitChildren(), and DocDiagramFileBase::width().

◆ operator()() [34/59]

void DocbookDocVisitor::operator() ( const DocMscFile & df)

Definition at line 1255 of file docbookvisitor.cpp.

1256{
1258 if (m_hide) return;
1259 bool exists = false;
1260 std::string inBuf;
1261 if (readInputFile(df.file(),inBuf))
1262 {
1263 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
1264 ".msc", // extension
1265 inBuf, // contents
1266 exists);
1267 if (!fileName.isEmpty())
1268 {
1269 startMscFile(fileName,df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine(),!exists);
1270 visitChildren(df);
1271 endMscFile(df.hasCaption());
1272 }
1273 }
1274}
void startMscFile(const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine, bool newFile=true)
void endMscFile(bool hasCaption)

References DocCompoundNode::children(), Config_getString, DB_VIS_C, endMscFile(), DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), DocDiagramFileBase::height(), m_hide, readInputFile(), DocDiagramFileBase::relPath(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), startMscFile(), stripPath(), visitChildren(), DocDiagramFileBase::width(), and writeFileContents().

◆ operator()() [35/59]

void DocbookDocVisitor::operator() ( const DocPara & p)

Definition at line 644 of file docbookvisitor.cpp.

645{
647 if (m_hide) return;
648 m_t << "\n";
649 m_t << "<para>";
650 visitChildren(p);
651 m_t << "</para>";
652 m_t << "\n";
653}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [36/59]

void DocbookDocVisitor::operator() ( const DocParamList & pl)

Definition at line 1414 of file docbookvisitor.cpp.

1415{
1417 if (m_hide) return;
1418 m_t << " <row>\n";
1419
1420 const DocParamSect *sect = std::get_if<DocParamSect>(pl.parent());
1421 if (sect && sect->hasInOutSpecifier())
1422 {
1423 m_t << "<entry>";
1425 {
1426 if (pl.direction()==DocParamSect::In)
1427 {
1428 m_t << "in";
1429 }
1430 else if (pl.direction()==DocParamSect::Out)
1431 {
1432 m_t << "out";
1433 }
1434 else if (pl.direction()==DocParamSect::InOut)
1435 {
1436 m_t << "in,out";
1437 }
1438 }
1439 m_t << "</entry>";
1440 }
1441
1442 if (sect && sect->hasTypeSpecifier())
1443 {
1444 m_t << "<entry>";
1445 for (const auto &type : pl.paramTypes())
1446 {
1447 std::visit(*this,type);
1448 }
1449 m_t << "</entry>";
1450 }
1451
1452 if (pl.parameters().empty())
1453 {
1454 m_t << "<entry></entry>\n";
1455 }
1456 else
1457 {
1458 m_t << "<entry>";
1459 int cnt = 0;
1460 for (const auto &param : pl.parameters())
1461 {
1462 if (cnt)
1463 {
1464 m_t << ", ";
1465 }
1466 std::visit(*this,param);
1467 cnt++;
1468 }
1469 m_t << "</entry>";
1470 }
1471 m_t << "<entry>";
1472 for (const auto &par : pl.paragraphs())
1473 {
1474 std::visit(*this,par);
1475 }
1476 m_t << "</entry>\n";
1477 m_t << " </row>\n";
1478}
const DocNodeList & parameters() const
Definition docnode.h:1135
const DocNodeList & paramTypes() const
Definition docnode.h:1136
DocParamSect::Direction direction() const
Definition docnode.h:1139
const DocNodeList & paragraphs() const
Definition docnode.h:1137
bool hasInOutSpecifier() const
Definition docnode.h:1078
bool hasTypeSpecifier() const
Definition docnode.h:1079

References DB_VIS_C, DocParamList::direction(), GrowVector< T >::empty(), DocParamSect::hasInOutSpecifier(), DocParamSect::hasTypeSpecifier(), DocParamSect::In, DocParamSect::InOut, m_hide, m_t, DocParamSect::Out, DocParamList::paragraphs(), DocParamList::parameters(), DocParamList::paramTypes(), DocNode::parent(), and DocParamSect::Unspecified.

◆ operator()() [37/59]

void DocbookDocVisitor::operator() ( const DocParamSect & s)

Definition at line 1364 of file docbookvisitor.cpp.

1365{
1367 if (m_hide) return;
1368 m_t << "\n";
1369 m_t << " <formalpara>\n";
1370 m_t << " <title>\n";
1371 switch(s.type())
1372 {
1377 default:
1378 ASSERT(0);
1379 }
1380 m_t << "</title>\n";
1381 m_t << " <para>\n";
1382 m_t << " <table frame=\"all\">\n";
1383 int ncols = 2;
1384 if (s.type() == DocParamSect::Param)
1385 {
1386 bool hasInOutSpecs = s.hasInOutSpecifier();
1387 bool hasTypeSpecs = s.hasTypeSpecifier();
1388 if (hasInOutSpecs && hasTypeSpecs) ncols += 2;
1389 else if (hasInOutSpecs || hasTypeSpecs) ncols += 1;
1390 }
1391 m_t << " <tgroup cols=\"" << ncols << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n";
1392 for (int i = 1; i <= ncols; i++)
1393 {
1394 if (i == ncols) m_t << " <colspec colwidth=\"4*\"/>\n";
1395 else m_t << " <colspec colwidth=\"1*\"/>\n";
1396 }
1397 m_t << " <tbody>\n";
1398 visitChildren(s);
1399 m_t << " </tbody>\n";
1400 m_t << " </tgroup>\n";
1401 m_t << " </table>\n";
1402 m_t << " </para>\n";
1403 m_t << " </formalpara>\n";
1404 m_t << " ";
1405}
Type type() const
Definition docnode.h:1077
virtual QCString trExceptions()=0
virtual QCString trParameters()=0
virtual QCString trTemplateParameters()=0
virtual QCString trReturnValues()=0
Translator * theTranslator
Definition language.cpp:71
#define ASSERT(x)
Definition qcstring.h:39

References ASSERT, DB_VIS_C, DocParamSect::Exception, DocParamSect::hasInOutSpecifier(), DocParamSect::hasTypeSpecifier(), m_hide, m_t, DocParamSect::Param, DocParamSect::RetVal, DocParamSect::TemplateParam, theTranslator, DocParamSect::type(), and visitChildren().

◆ operator()() [38/59]

void DocbookDocVisitor::operator() ( const DocParBlock & b)

Definition at line 1528 of file docbookvisitor.cpp.

1529{
1531 if (m_hide) return;
1532 visitChildren(b);
1533}

References DB_VIS_C, m_hide, and visitChildren().

◆ operator()() [39/59]

void DocbookDocVisitor::operator() ( const DocPlantUmlFile & df)

Definition at line 1297 of file docbookvisitor.cpp.

1298{
1300 if (m_hide) return;
1301 if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file()));
1302 startPlantUmlFile(df.file(),df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine());
1303 visitChildren(df);
1305}
void endPlantUmlFile(bool hasCaption)
void startPlantUmlFile(const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine)

References DocCompoundNode::children(), Config_getBool, Config_getString, copyFile(), DB_VIS_C, endPlantUmlFile(), DocDiagramFileBase::file(), DocDiagramFileBase::hasCaption(), DocDiagramFileBase::height(), m_hide, DocDiagramFileBase::relPath(), DocDiagramFileBase::srcFile(), DocDiagramFileBase::srcLine(), startPlantUmlFile(), stripPath(), visitChildren(), and DocDiagramFileBase::width().

◆ operator()() [40/59]

void DocbookDocVisitor::operator() ( const DocRef & ref)

Definition at line 1327 of file docbookvisitor.cpp.

1328{
1330 if (m_hide) return;
1331 if (ref.isSubPage())
1332 {
1333 startLink(QCString(),ref.anchor());
1334 }
1335 else
1336 {
1337 if (!ref.file().isEmpty()) startLink(ref.file(),ref.anchor());
1338 }
1339
1340 if (!ref.hasLinkText()) filter(ref.targetTitle());
1341 visitChildren(ref);
1342 if (!ref.file().isEmpty()) endLink();
1343}
QCString anchor() const
Definition docnode.h:794
QCString targetTitle() const
Definition docnode.h:795
bool isSubPage() const
Definition docnode.h:801
QCString file() const
Definition docnode.h:791
bool hasLinkText() const
Definition docnode.h:797

References DocRef::anchor(), DB_VIS_C, endLink(), DocRef::file(), filter(), DocRef::hasLinkText(), QCString::isEmpty(), DocRef::isSubPage(), m_hide, startLink(), DocRef::targetTitle(), and visitChildren().

◆ operator()() [41/59]

void DocbookDocVisitor::operator() ( const DocRoot & r)

Definition at line 655 of file docbookvisitor.cpp.

656{
658 visitChildren(r);
659}

References DB_VIS_C, and visitChildren().

◆ operator()() [42/59]

void DocbookDocVisitor::operator() ( const DocSecRefItem & ref)

Definition at line 1345 of file docbookvisitor.cpp.

1346{
1348 if (m_hide) return;
1349 //m_t << "<tocentry xml:idref=\"_" << stripPath(ref->file()) << "_1" << ref->anchor() << "\">";
1350 m_t << "<tocentry>";
1351 visitChildren(ref);
1352 m_t << "</tocentry>\n";
1353}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [43/59]

void DocbookDocVisitor::operator() ( const DocSecRefList & l)

Definition at line 1355 of file docbookvisitor.cpp.

1356{
1358 if (m_hide) return;
1359 m_t << "<toc>\n";
1360 visitChildren(l);
1361 m_t << "</toc>\n";
1362}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [44/59]

void DocbookDocVisitor::operator() ( const DocSection & s)

Definition at line 902 of file docbookvisitor.cpp.

903{
905 if (m_hide) return;
906 m_t << "<section xml:id=\"_" << stripPath(s.file());
907 if (!s.anchor().isEmpty()) m_t << "_1" << s.anchor();
908 m_t << "\">\n";
909 if (s.title())
910 {
911 std::visit(*this,*s.title());
912 }
913 visitChildren(s);
914 m_t << "</section>\n";
915}
QCString file() const
Definition docnode.h:931
QCString anchor() const
Definition docnode.h:929
const DocNodeVariant * title() const
Definition docnode.h:928

References DocSection::anchor(), DB_VIS_C, DocSection::file(), QCString::isEmpty(), m_hide, m_t, stripPath(), DocSection::title(), and visitChildren().

◆ operator()() [45/59]

void DocbookDocVisitor::operator() ( const DocSeparator & sep)

Definition at line 1407 of file docbookvisitor.cpp.

1408{
1410 if (m_hide) return;
1411 m_t << " " << sep.chars() << " ";
1412}
QCString chars() const
Definition docnode.h:369

References DocSeparator::chars(), DB_VIS_C, m_hide, and m_t.

◆ operator()() [46/59]

void DocbookDocVisitor::operator() ( const DocSimpleList & l)

Definition at line 881 of file docbookvisitor.cpp.

882{
884 if (m_hide) return;
885 m_t << "<itemizedlist>\n";
886 visitChildren(l);
887 m_t << "</itemizedlist>\n";
888}

References DB_VIS_C, m_hide, m_t, and visitChildren().

◆ operator()() [47/59]

void DocbookDocVisitor::operator() ( const DocSimpleListItem & li)

Definition at line 890 of file docbookvisitor.cpp.

891{
893 if (m_hide) return;
894 m_t << "<listitem>";
895 if (li.paragraph())
896 {
897 visit(*this,*li.paragraph());
898 }
899 m_t << "</listitem>\n";
900}
const DocNodeVariant * paragraph() const
Definition docnode.h:1163

References DB_VIS_C, m_hide, m_t, and DocSimpleListItem::paragraph().

◆ operator()() [48/59]

void DocbookDocVisitor::operator() ( const DocSimpleSect & s)

Definition at line 661 of file docbookvisitor.cpp.

662{
664 if (m_hide) return;
665 switch(s.type())
666 {
668 if (m_insidePre)
669 {
670 m_t << "<formalpara><title>" << theTranslator->trSeeAlso() << "</title>\n";
671 }
672 else
673 {
674 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trSeeAlso()) << "</title>\n";
675 }
676 break;
678 if (m_insidePre)
679 {
680 m_t << "<formalpara><title>" << theTranslator->trReturns()<< "</title>\n";
681 }
682 else
683 {
684 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trReturns()) << "</title>\n";
685 }
686 break;
688 if (m_insidePre)
689 {
690 m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, TRUE) << "</title>\n";
691 }
692 else
693 {
694 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trAuthor(TRUE, TRUE)) << "</title>\n";
695 }
696 break;
698 if (m_insidePre)
699 {
700 m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, FALSE) << "</title>\n";
701 }
702 else
703 {
704 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trAuthor(TRUE, FALSE)) << "</title>\n";
705 }
706 break;
708 if (m_insidePre)
709 {
710 m_t << "<formalpara><title>" << theTranslator->trVersion() << "</title>\n";
711 }
712 else
713 {
714 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trVersion()) << "</title>\n";
715 }
716 break;
718 if (m_insidePre)
719 {
720 m_t << "<formalpara><title>" << theTranslator->trSince() << "</title>\n";
721 }
722 else
723 {
724 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trSince()) << "</title>\n";
725 }
726 break;
728 if (m_insidePre)
729 {
730 m_t << "<formalpara><title>" << theTranslator->trDate() << "</title>\n";
731 }
732 else
733 {
734 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trDate()) << "</title>\n";
735 }
736 break;
738 if (m_insidePre)
739 {
740 m_t << "<note><title>" << theTranslator->trNote() << "</title>\n";
741 }
742 else
743 {
744 m_t << "<note><title>" << convertToDocBook(theTranslator->trNote()) << "</title>\n";
745 }
746 break;
748 if (m_insidePre)
749 {
750 m_t << "<warning><title>" << theTranslator->trWarning() << "</title>\n";
751 }
752 else
753 {
754 m_t << "<warning><title>" << convertToDocBook(theTranslator->trWarning()) << "</title>\n";
755 }
756 break;
758 if (m_insidePre)
759 {
760 m_t << "<formalpara><title>" << theTranslator->trPrecondition() << "</title>\n";
761 }
762 else
763 {
764 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trPrecondition()) << "</title>\n";
765 }
766 break;
768 if (m_insidePre)
769 {
770 m_t << "<formalpara><title>" << theTranslator->trPostcondition() << "</title>\n";
771 }
772 else
773 {
774 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trPostcondition()) << "</title>\n";
775 }
776 break;
778 if (m_insidePre)
779 {
780 m_t << "<formalpara><title>" << theTranslator->trCopyright() << "</title>\n";
781 }
782 else
783 {
784 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trCopyright()) << "</title>\n";
785 }
786 break;
788 if (m_insidePre)
789 {
790 m_t << "<formalpara><title>" << theTranslator->trInvariant() << "</title>\n";
791 }
792 else
793 {
794 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trInvariant()) << "</title>\n";
795 }
796 break;
798 // <remark> is miising the <title> possibility
799 if (m_insidePre)
800 {
801 m_t << "<formalpara><title>" << theTranslator->trRemarks() << "</title>\n";
802 }
803 else
804 {
805 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trRemarks()) << "</title>\n";
806 }
807 break;
809 if (m_insidePre)
810 {
811 m_t << "<caution><title>" << theTranslator->trAttention() << "</title>\n";
812 }
813 else
814 {
815 m_t << "<caution><title>" << convertToDocBook(theTranslator->trAttention()) << "</title>\n";
816 }
817 break;
819 if (m_insidePre)
820 {
821 m_t << "<important><title>" << theTranslator->trImportant() << "</title>\n";
822 }
823 else
824 {
825 m_t << "<important><title>" << convertToDocBook(theTranslator->trImportant()) << "</title>\n";
826 }
827 break;
831 if (s.hasTitle())
832 m_t << "<formalpara>\n";
833 else
834 m_t << "<para>\n";
835 break;
836 }
837
838 if (s.title())
839 {
840 std::visit(*this,*s.title());
841 }
842 visitChildren(s);
843
844 switch(s.type())
845 {
849 if (s.hasTitle())
850 m_t << "</formalpara>\n";
851 else
852 m_t << "</para>\n";
853 break;
855 m_t << "</note>\n";
856 break;
858 m_t << "</caution>\n";
859 break;
861 m_t << "</important>\n";
862 break;
864 m_t << "</warning>\n";
865 break;
866 default:
867 m_t << "</formalpara>\n";
868 break;
869 }
870}
Type type() const
Definition docnode.h:1035
const DocNodeVariant * title() const
Definition docnode.h:1042
bool hasTitle() const
Definition docnode.cpp:3145
virtual QCString trPrecondition()=0
virtual QCString trSince()=0
virtual QCString trVersion()=0
virtual QCString trReturns()=0
virtual QCString trRemarks()=0
virtual QCString trNote()=0
virtual QCString trPostcondition()=0
virtual QCString trAttention()=0
virtual QCString trCopyright()=0
virtual QCString trDate()=0
virtual QCString trAuthor(bool first_capital, bool singular)=0
virtual QCString trWarning()=0
virtual QCString trSeeAlso()=0
virtual QCString trImportant()=0
virtual QCString trInvariant()=0
#define FALSE
Definition qcstring.h:34

References DocSimpleSect::Attention, DocSimpleSect::Author, DocSimpleSect::Authors, convertToDocBook(), DocSimpleSect::Copyright, DocSimpleSect::Date, DB_VIS_C, FALSE, DocSimpleSect::hasTitle(), DocSimpleSect::Important, DocSimpleSect::Invar, m_hide, m_insidePre, m_t, DocSimpleSect::Note, DocSimpleSect::Post, DocSimpleSect::Pre, DocSimpleSect::Rcs, DocSimpleSect::Remark, DocSimpleSect::Return, DocSimpleSect::See, DocSimpleSect::Since, theTranslator, DocSimpleSect::title(), TRUE, DocSimpleSect::type(), DocSimpleSect::Unknown, DocSimpleSect::User, DocSimpleSect::Version, visitChildren(), and DocSimpleSect::Warning.

◆ operator()() [49/59]

void DocbookDocVisitor::operator() ( const DocSimpleSectSep & )

Definition at line 567 of file docbookvisitor.cpp.

568{
570 // m_t << "<simplesect/>";
571}

References DB_VIS_C.

◆ operator()() [50/59]

void DocbookDocVisitor::operator() ( const DocStyleChange & s)

Definition at line 256 of file docbookvisitor.cpp.

257{
259 if (m_hide) return;
260 switch (s.style())
261 {
263 if (s.enable()) m_t << "<emphasis role=\"bold\">"; else m_t << "</emphasis>";
264 break;
266 if (s.enable()) m_t << "<emphasis>"; else m_t << "</emphasis>";
267 break;
271 if (s.enable()) m_t << "<computeroutput>"; else m_t << "</computeroutput>";
272 break;
274 if (s.enable()) m_t << "<subscript>"; else m_t << "</subscript>";
275 break;
277 if (s.enable()) m_t << "<superscript>"; else m_t << "</superscript>";
278 break;
280 if (s.enable()) m_t << "<informaltable frame='none'><tgroup cols='1'><colspec align='center'/><tbody><row><entry align='center'>";
281 else m_t << "</entry></row></tbody></tgroup></informaltable>";
282 break;
284 if (s.enable())
285 {
286 m_t << "<literallayout>";
288 }
289 else
290 {
291 m_t << "</literallayout>";
293 }
294 break;
295 /* There is no equivalent Docbook tag for rendering Small text */
296 case DocStyleChange::Small: /* XSLT Stylesheets can be used */ break;
297 /* HTML only */
298 case DocStyleChange::Cite: break;
299 case DocStyleChange::S: break;
300 case DocStyleChange::Strike: break;
301 case DocStyleChange::Del: break;
302 case DocStyleChange::Underline: break;
303 case DocStyleChange::Ins: break;
304 case DocStyleChange::Div: /* HTML only */ break;
305 case DocStyleChange::Span: /* HTML only */ break;
306 }
307}
Style style() const
Definition docnode.h:307
bool enable() const
Definition docnode.h:309

References DocStyleChange::Bold, DocStyleChange::Center, DocStyleChange::Cite, DocStyleChange::Code, DB_VIS_C, DocStyleChange::Del, DocStyleChange::Div, DocStyleChange::enable(), FALSE, DocStyleChange::Ins, DocStyleChange::Italic, DocStyleChange::Kbd, m_hide, m_insidePre, m_t, DocStyleChange::Preformatted, DocStyleChange::S, DocStyleChange::Small, DocStyleChange::Span, DocStyleChange::Strike, DocStyleChange::style(), DocStyleChange::Subscript, DocStyleChange::Superscript, TRUE, DocStyleChange::Typewriter, and DocStyleChange::Underline.

◆ operator()() [51/59]

void DocbookDocVisitor::operator() ( const DocSymbol & s)

Definition at line 197 of file docbookvisitor.cpp.

198{
200 if (m_hide) return;
201 const char *res = HtmlEntityMapper::instance().docbook(s.symbol());
202 if (res)
203 {
204 m_t << res;
205 }
206 else
207 {
208 err("DocBook: non supported HTML-entity found: {}\n",HtmlEntityMapper::instance().html(s.symbol(),TRUE));
209 }
210}
HtmlEntityMapper::SymType symbol() const
Definition docnode.h:332
static HtmlEntityMapper & instance()
Returns the one and only instance of the HTML entity mapper.
const char * docbook(SymType symb) const
Access routine to the docbook code of the HTML entity.
#define err(fmt,...)
Definition message.h:127

References DB_VIS_C, HtmlEntityMapper::docbook(), err, HtmlEntityMapper::instance(), m_hide, m_t, DocSymbol::symbol(), and TRUE.

◆ operator()() [52/59]

void DocbookDocVisitor::operator() ( const DocText & t)

Definition at line 1506 of file docbookvisitor.cpp.

1507{
1509 visitChildren(t);
1510}

References DB_VIS_C, and visitChildren().

◆ operator()() [53/59]

void DocbookDocVisitor::operator() ( const DocTitle & t)

Definition at line 872 of file docbookvisitor.cpp.

873{
875 if (m_hide) return;
876 if (t.hasTitle()) m_t << "<title>";
877 visitChildren(t);
878 if (t.hasTitle()) m_t << "</title>";
879}
bool hasTitle() const
Definition docnode.h:613

References DB_VIS_C, DocTitle::hasTitle(), m_hide, m_t, and visitChildren().

◆ operator()() [54/59]

void DocbookDocVisitor::operator() ( const DocURL & u)

Definition at line 227 of file docbookvisitor.cpp.

228{
230 if (m_hide) return;
231 m_t << "<link xlink:href=\"";
232 if (u.isEmail()) m_t << "mailto:";
233 filter(u.url());
234 m_t << "\">";
235 filter(u.url());
236 m_t << "</link>";
237}
QCString url() const
Definition docnode.h:192
bool isEmail() const
Definition docnode.h:193

References DB_VIS_C, filter(), DocURL::isEmail(), m_hide, m_t, and DocURL::url().

◆ operator()() [55/59]

void DocbookDocVisitor::operator() ( const DocVerbatim & s)

Definition at line 309 of file docbookvisitor.cpp.

310{
312 if (m_hide) return;
313 QCString lang = m_langExt;
314 if (!s.language().isEmpty()) // explicit language setting
315 {
316 lang = s.language();
317 }
318 SrcLangExt langExt = getLanguageFromCodeLang(lang);
319 switch(s.type())
320 {
322 m_t << "<literallayout><computeroutput>";
324 s.text(),
325 langExt,
326 Config_getBool(STRIP_CODE_COMMENTS),
327 CodeParserOptions()
328 .setExample(s.isExample(),s.exampleFile())
329 );
330 m_t << "</computeroutput></literallayout>";
331 break;
333 m_t << "<literallayout><computeroutput>";
334 filter(s.text());
335 m_t << "</computeroutput></literallayout>";
336 break;
338 filter(s.text(), true);
339 break;
341 m_t << "<computeroutput>";
342 filter(s.text(), true);
343 m_t << "</computeroutput>";
344 break;
346 break;
348 break;
350 break;
352 break;
354 break;
356 m_t << s.text();
357 break;
358 case DocVerbatim::Dot:
359 {
360 m_t << "<para>\n";
361 bool exists = false;
362 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/inline_dotgraph_", // baseName
363 ".dot", // extension
364 s.text(), // contents
365 exists);
366 if (!fileName.isEmpty())
367 {
368 writeDotFile(fileName, s, !exists);
369 }
370 m_t << "</para>\n";
371 }
372 break;
373 case DocVerbatim::Msc:
374 {
375 m_t << "<para>\n";
376 bool exists = false;
377 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/inline_mscgraph_", // baseName
378 ".msc", // extension
379 "msc {"+s.text()+"}", // contents
380 exists);
381 if (!fileName.isEmpty())
382 {
383 writeMscFile(fileName,s,!exists);
384 }
385 m_t << "</para>\n";
386 }
387 break;
389 {
390 QCString docbookOutput = Config_getString(DOCBOOK_OUTPUT);
391 auto baseNameVector = PlantumlManager::instance().writePlantUMLSource(docbookOutput,
393 s.engine(),s.srcFile(),s.srcLine(),true);
394 for (const auto &baseName: baseNameVector)
395 {
396 m_t << "<para>\n";
397 writePlantUMLFile(baseName,s);
398 m_t << "</para>\n";
399 }
400 }
401 break;
403 if (Config_getBool(MERMAID_RENDER_MODE)!=MERMAID_RENDER_MODE_t::CLIENT_SIDE)
404 {
405 auto docbookOutput = Config_getString(DOCBOOK_OUTPUT);
406 auto outputFormat = MermaidManager::OutputFormat::Docbook;
407 auto imageFormat = MermaidManager::convertToImageFormat(outputFormat);
408 auto baseName = MermaidManager::instance().writeMermaidSource(docbookOutput,
409 s.exampleFile(),s.text(),imageFormat,
410 s.srcFile(),s.srcLine());
411 m_t << "<para>\n";
412 writeMermaidFile(baseName,s);
413 m_t << "</para>\n";
414 }
415 break;
416 }
417}
QCString srcFile() const
Definition docnode.h:397
int srcLine() const
Definition docnode.h:398
QCString language() const
Definition docnode.h:388
bool isExample() const
Definition docnode.h:385
QCString context() const
Definition docnode.h:384
Type type() const
Definition docnode.h:382
QCString text() const
Definition docnode.h:383
QCString exampleFile() const
Definition docnode.h:386
QCString engine() const
Definition docnode.h:393
@ JavaDocLiteral
Definition docnode.h:378
void writeMscFile(const QCString &fileName, const DocVerbatim &s, bool newFile=true)
void writeMermaidFile(const QCString &fileName, const DocVerbatim &s)
void writePlantUMLFile(const QCString &fileName, const DocVerbatim &s)
void writeDotFile(const QCString &fileName, const DocVerbatim &s, bool newFile=true)
static MermaidManager & instance()
Definition mermaid.cpp:33
static ImageFormat convertToImageFormat(OutputFormat outputFormat)
Definition mermaid.cpp:54
QCString writeMermaidSource(const QCString &outDirArg, const QCString &fileName, const QCString &content, ImageFormat format, const QCString &srcFile, int srcLine)
Write a Mermaid source file and register it for CLI rendering.
Definition mermaid.cpp:70
StringVector writePlantUMLSource(const QCString &outDirArg, const QCString &fileName, const QCString &content, OutputFormat format, const QCString &engine, const QCString &srcFile, int srcLine, bool inlineCode)
Write a PlantUML compatible file.
Definition plantuml.cpp:31
static PlantumlManager & instance()
Definition plantuml.cpp:232
SrcLangExt getLanguageFromCodeLang(QCString &fileName)
Routine to handle the language attribute of the \code command.
Definition util.cpp:5249

References DocVerbatim::Code, Config_getBool, Config_getString, DocVerbatim::context(), MermaidManager::convertToImageFormat(), DB_VIS_C, MermaidManager::Docbook, DocVerbatim::DocbookOnly, DocVerbatim::Dot, DocVerbatim::engine(), DocVerbatim::exampleFile(), filter(), DocVisitor::getCodeParser(), getLanguageFromCodeLang(), DocVerbatim::HtmlOnly, MermaidManager::instance(), PlantumlManager::instance(), QCString::isEmpty(), DocVerbatim::isExample(), DocVerbatim::JavaDocCode, DocVerbatim::JavaDocLiteral, DocVerbatim::language(), DocVerbatim::LatexOnly, m_ci, m_hide, m_langExt, m_t, DocVerbatim::ManOnly, DocVerbatim::Mermaid, DocVerbatim::Msc, CodeParserInterface::parseCode(), DocVerbatim::PlantUML, PlantumlManager::PUML_BITMAP, DocVerbatim::RtfOnly, DocVerbatim::srcFile(), DocVerbatim::srcLine(), DocVerbatim::text(), DocVerbatim::type(), DocVerbatim::Verbatim, writeDotFile(), writeFileContents(), writeMermaidFile(), MermaidManager::writeMermaidSource(), writeMscFile(), writePlantUMLFile(), PlantumlManager::writePlantUMLSource(), and DocVerbatim::XmlOnly.

◆ operator()() [56/59]

void DocbookDocVisitor::operator() ( const DocVhdlFlow & )

Definition at line 1522 of file docbookvisitor.cpp.

1523{
1525 // TODO: to be implemented
1526}

References DB_VIS_C.

◆ operator()() [57/59]

void DocbookDocVisitor::operator() ( const DocWhiteSpace & w)

Definition at line 183 of file docbookvisitor.cpp.

184{
186 if (m_hide) return;
187 if (m_insidePre)
188 {
189 m_t << w.chars();
190 }
191 else
192 {
193 m_t << " ";
194 }
195}
QCString chars() const
Definition docnode.h:358

References DocWhiteSpace::chars(), DB_VIS_C, m_hide, m_insidePre, and m_t.

◆ operator()() [58/59]

void DocbookDocVisitor::operator() ( const DocWord & w)

Definition at line 167 of file docbookvisitor.cpp.

168{
170 if (m_hide) return;
171 filter(w.word());
172}
QCString word() const
Definition docnode.h:156

References DB_VIS_C, filter(), m_hide, and DocWord::word().

◆ operator()() [59/59]

void DocbookDocVisitor::operator() ( const DocXRefItem & x)

Definition at line 1480 of file docbookvisitor.cpp.

1481{
1483 if (m_hide) return;
1484 if (x.title().isEmpty()) return;
1485 m_t << "<para><link linkend=\"_";
1486 m_t << stripPath(x.file()) << "_1" << x.anchor();
1487 m_t << "\">";
1488 filter(x.title());
1489 m_t << "</link>";
1490 m_t << " ";
1491 visitChildren(x);
1492 if (x.title().isEmpty()) return;
1493 m_t << "</para>";
1494}
QCString anchor() const
Definition docnode.h:625
QCString file() const
Definition docnode.h:624
QCString title() const
Definition docnode.h:626

References DocXRefItem::anchor(), DB_VIS_C, DocXRefItem::file(), filter(), QCString::isEmpty(), m_hide, m_t, stripPath(), DocXRefItem::title(), and visitChildren().

◆ startDiaFile()

void DocbookDocVisitor::startDiaFile ( const QCString & fileName,
const QCString & relPath,
const QCString & width,
const QCString & height,
bool hasCaption,
const DocNodeList & children,
const QCString & srcFile,
int srcLine,
bool newFile = true )
private

Definition at line 1706 of file docbookvisitor.cpp.

1715{
1717 QCString baseName=makeBaseName(fileName,".dia");
1718 baseName.prepend("dia_");
1719 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1720 if (newFile) writeDiaGraphFromFile(fileName,outDir,baseName,DiaOutputFormat::BITMAP,srcFile,srcLine,false);
1721 m_t << "<para>\n";
1722 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1723}
void writeDiaGraphFromFile(const QCString &inFile, const QCString &outDir, const QCString &outFile, DiaOutputFormat format, const QCString &srcFile, int srcLine, bool toIndex)
Definition dia.cpp:28
QCString makeBaseName(const QCString &name, const QCString &ext)
Definition util.cpp:4985

References BITMAP, Config_getString, DB_VIS_C, m_t, makeBaseName(), visitPreStart(), and writeDiaGraphFromFile().

Referenced by operator()().

◆ startDotFile()

void DocbookDocVisitor::startDotFile ( const QCString & fileName,
const QCString & relPath,
const QCString & width,
const QCString & height,
bool hasCaption,
const DocNodeList & children,
const QCString & srcFile,
int srcLine,
bool newFile = true )
private

Definition at line 1744 of file docbookvisitor.cpp.

1753{
1755 QCString baseName=makeBaseName(fileName,".dot");
1756 baseName.prepend("dot_");
1757 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1758 QCString imgExt = getDotImageExtension();
1759 if (newFile) writeDotGraphFromFile(fileName,outDir,baseName,GraphOutputFormat::BITMAP,srcFile,srcLine,false);
1760 m_t << "<para>\n";
1761 visitPreStart(m_t, children, hasCaption, relPath + baseName + "." + imgExt, width, height);
1762}
void writeDotGraphFromFile(const QCString &inFile, const QCString &outDir, const QCString &outFile, GraphOutputFormat format, const QCString &srcFile, int srcLine, bool toIndex)
Definition dot.cpp:230
QCString getDotImageExtension()
Definition util.cpp:6307

References BITMAP, Config_getString, DB_VIS_C, getDotImageExtension(), m_t, makeBaseName(), visitPreStart(), and writeDotGraphFromFile().

Referenced by operator()().

◆ startLink()

void DocbookDocVisitor::startLink ( const QCString & file,
const QCString & anchor )
private

Definition at line 1542 of file docbookvisitor.cpp.

1543{
1545 m_t << "<link linkend=\"_" << stripPath(file);
1546 if (!anchor.isEmpty())
1547 {
1548 if (!file.isEmpty()) m_t << "_1";
1549 m_t << anchor;
1550 }
1551 m_t << "\">";
1552}

References DB_VIS_C, QCString::isEmpty(), m_t, and stripPath().

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

◆ startMermaidFile()

void DocbookDocVisitor::startMermaidFile ( const QCString & fileName,
const QCString & relPath,
const QCString & width,
const QCString & height,
bool hasCaption,
const DocNodeList & children,
const QCString & srcFile,
int srcLine )
private

Definition at line 1634 of file docbookvisitor.cpp.

1643{
1645 if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
1646 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1647 std::string inBuf;
1648 readInputFile(fileName,inBuf);
1649 auto outputFormat = MermaidManager::OutputFormat::Docbook;
1650 auto imageFormat = MermaidManager::convertToImageFormat(outputFormat);
1651 auto imgExt = MermaidManager::imageExtension(imageFormat);
1652 auto baseName = MermaidManager::instance().writeMermaidSource(outDir,QCString(),inBuf,imageFormat,srcFile,srcLine);
1653 auto shortName = stripPath(baseName);
1654 MermaidManager::instance().generateMermaidOutput(baseName,outDir,imageFormat,false);
1655 m_t << "<para>\n";
1656 visitPreStart(m_t, children, hasCaption, relPath + shortName + "." + imgExt, width, height);
1657}
void generateMermaidOutput(const QCString &baseName, const QCString &outDir, ImageFormat format, bool toIndex)
Register a generated Mermaid image with the index.
Definition mermaid.cpp:117
static QCString imageExtension(ImageFormat imageFormat)
Definition mermaid.cpp:43

References Config_getBool, Config_getString, MermaidManager::convertToImageFormat(), DB_VIS_C, MermaidManager::Docbook, MermaidManager::generateMermaidOutput(), MermaidManager::imageExtension(), MermaidManager::instance(), m_t, readInputFile(), stripPath(), visitPreStart(), and MermaidManager::writeMermaidSource().

Referenced by operator()().

◆ startMscFile()

void DocbookDocVisitor::startMscFile ( const QCString & fileName,
const QCString & relPath,
const QCString & width,
const QCString & height,
bool hasCaption,
const DocNodeList & children,
const QCString & srcFile,
int srcLine,
bool newFile = true )
private

Definition at line 1668 of file docbookvisitor.cpp.

1677{
1679 QCString baseName=makeBaseName(fileName,".msc");
1680 baseName.prepend("msc_");
1681 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1682 if (newFile) writeMscGraphFromFile(fileName,outDir,baseName,MscOutputFormat::BITMAP,srcFile,srcLine,false);
1683 m_t << "<para>\n";
1684 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1685}
void writeMscGraphFromFile(const QCString &inFile, const QCString &outDir, const QCString &outFile, MscOutputFormat format, const QCString &srcFile, int srcLine, bool toIndex)
Definition msc.cpp:157

References BITMAP, Config_getString, DB_VIS_C, m_t, makeBaseName(), visitPreStart(), and writeMscGraphFromFile().

Referenced by operator()().

◆ startPlantUmlFile()

void DocbookDocVisitor::startPlantUmlFile ( const QCString & fileName,
const QCString & relPath,
const QCString & width,
const QCString & height,
bool hasCaption,
const DocNodeList & children,
const QCString & srcFile,
int srcLine )
private

Definition at line 1582 of file docbookvisitor.cpp.

1591{
1593 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1594 std::string inBuf;
1595 readInputFile(fileName,inBuf);
1596 auto baseNameVector = PlantumlManager::instance().writePlantUMLSource(outDir,
1597 QCString(),inBuf,PlantumlManager::PUML_BITMAP,QCString(),srcFile,srcLine,false);
1598 bool first = true;
1599 for (const auto &bName: baseNameVector)
1600 {
1601 QCString baseName=makeBaseName(bName,".pu");
1603 if (!first) endPlantUmlFile(hasCaption);
1604 first = false;
1605 m_t << "<para>\n";
1606 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1607 }
1608}
void generatePlantUMLOutput(const QCString &baseName, const QCString &outDir, OutputFormat format, bool toIndex)
Convert a PlantUML file to an image.
Definition plantuml.cpp:202

References Config_getString, DB_VIS_C, endPlantUmlFile(), PlantumlManager::generatePlantUMLOutput(), PlantumlManager::instance(), m_t, makeBaseName(), PlantumlManager::PUML_BITMAP, readInputFile(), visitPreStart(), and PlantumlManager::writePlantUMLSource().

Referenced by operator()().

◆ visitCaption()

void DocbookDocVisitor::visitCaption ( const DocNodeList & children)
private

Definition at line 87 of file docbookvisitor.cpp.

88{
89 for (const auto &n : children)
90 {
91 std::visit(*this,n);
92 }
93}

Referenced by visitPreStart(), writeDiaFile(), writeDotFile(), writeMermaidFile(), writeMscFile(), and writePlantUMLFile().

◆ visitChildren()

◆ visitPostEnd()

void DocbookDocVisitor::visitPostEnd ( TextStream & t,
bool hasCaption,
bool inlineImage = FALSE )
private

Definition at line 138 of file docbookvisitor.cpp.

139{
140 t << "\n";
141 if (hasCaption && !inlineImage)
142 {
143 t << " -->\n"; // Needed for general formatting with title for other formats
144 }
145 t << " </mediaobject>\n";
146 if (hasCaption && !inlineImage)
147 {
148 t << " </figure>\n";
149 }
150 else
151 {
152 t << " </informalfigure>\n";
153 }
154}

Referenced by endDiaFile(), endDotFile(), endMermaidFile(), endMscFile(), endPlantUmlFile(), operator()(), writeDiaFile(), writeDotFile(), writeMermaidFile(), writeMscFile(), and writePlantUMLFile().

◆ visitPreStart()

void DocbookDocVisitor::visitPreStart ( TextStream & t,
const DocNodeList & children,
bool hasCaption,
const QCString & name,
const QCString & width,
const QCString & height,
bool inlineImage = FALSE )
private

Definition at line 95 of file docbookvisitor.cpp.

102{
103 if (hasCaption && !inlineImage)
104 {
105 t << " <figure>\n";
106 t << " <title>\n";
107 visitCaption(children);
108 t << " </title>\n";
109 }
110 else
111 {
112 t << " <informalfigure>\n";
113 }
114 t << " <mediaobject>\n";
115 t << " <imageobject>\n";
116 t << " <imagedata";
117 if (!width.isEmpty())
118 {
119 t << " width=\"" << convertToDocBook(width) << "\"";
120 }
121 else
122 {
123 if (!height.isEmpty() && !inlineImage) t << " width=\"50%\"";
124 }
125 if (!height.isEmpty())
126 {
127 t << " depth=\"" << convertToDocBook(height) << "\"";
128 }
129 t << " align=\"center\" valign=\"middle\" scalefit=\"0\" fileref=\"" << name << "\">";
130 t << "</imagedata>\n";
131 t << " </imageobject>\n";
132 if (hasCaption && !inlineImage)
133 {
134 t << " <!--\n"; // Needed for general formatting with title for other formats
135 }
136}
void visitCaption(const DocNodeList &children)

References convertToDocBook(), QCString::isEmpty(), and visitCaption().

Referenced by operator()(), startDiaFile(), startDotFile(), startMermaidFile(), startMscFile(), startPlantUmlFile(), writeDiaFile(), writeDotFile(), writeMermaidFile(), writeMscFile(), and writePlantUMLFile().

◆ writeDiaFile()

void DocbookDocVisitor::writeDiaFile ( const QCString & fileName,
const DocVerbatim & s )
private

Definition at line 1695 of file docbookvisitor.cpp.

1696{
1698 QCString shortName = stripPath(baseName);
1699 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1700 writeDiaGraphFromFile(baseName+".dia",outDir,shortName,DiaOutputFormat::BITMAP,s.srcFile(),s.srcLine(),false);
1701 visitPreStart(m_t, s.children(), s.hasCaption(), shortName, s.width(),s.height());
1704}
QCString height() const
Definition docnode.h:392
bool hasCaption() const
Definition docnode.h:390
const DocNodeList & children() const
Definition docnode.h:395
QCString width() const
Definition docnode.h:391

References BITMAP, DocVerbatim::children(), Config_getString, DB_VIS_C, DocVerbatim::hasCaption(), DocVerbatim::height(), m_t, DocVerbatim::srcFile(), DocVerbatim::srcLine(), stripPath(), visitCaption(), visitPostEnd(), visitPreStart(), DocVerbatim::width(), and writeDiaGraphFromFile().

◆ writeDotFile()

void DocbookDocVisitor::writeDotFile ( const QCString & fileName,
const DocVerbatim & s,
bool newFile = true )
private

Definition at line 1733 of file docbookvisitor.cpp.

1734{
1736 QCString shortName = makeBaseName(fileName,".dot");
1737 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1738 if (newFile) writeDotGraphFromFile(fileName,outDir,shortName,GraphOutputFormat::BITMAP,s.srcFile(),s.srcLine(),false);
1739 visitPreStart(m_t, s.children(), s.hasCaption(), s.relPath() + shortName + "." + getDotImageExtension(), s.width(),s.height());
1742}
QCString relPath() const
Definition docnode.h:387

References BITMAP, DocVerbatim::children(), Config_getString, DB_VIS_C, getDotImageExtension(), DocVerbatim::hasCaption(), DocVerbatim::height(), m_t, makeBaseName(), DocVerbatim::relPath(), DocVerbatim::srcFile(), DocVerbatim::srcLine(), visitCaption(), visitPostEnd(), visitPreStart(), DocVerbatim::width(), and writeDotGraphFromFile().

Referenced by operator()().

◆ writeMermaidFile()

void DocbookDocVisitor::writeMermaidFile ( const QCString & fileName,
const DocVerbatim & s )
private

Definition at line 1619 of file docbookvisitor.cpp.

1620{
1622 if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
1623 auto shortName = stripPath(baseName);
1624 auto outDir = Config_getString(DOCBOOK_OUTPUT);
1625 auto outputFormat = MermaidManager::OutputFormat::Docbook;
1626 auto imageFormat = MermaidManager::convertToImageFormat(outputFormat);
1627 auto imgExt = MermaidManager::imageExtension(imageFormat);
1628 MermaidManager::instance().generateMermaidOutput(baseName,outDir,imageFormat,false);
1629 visitPreStart(m_t, s.children(), s.hasCaption(), s.relPath() + shortName + "." + imgExt, s.width(),s.height());
1632}

References DocVerbatim::children(), Config_getBool, Config_getString, MermaidManager::convertToImageFormat(), DB_VIS_C, MermaidManager::Docbook, MermaidManager::generateMermaidOutput(), DocVerbatim::hasCaption(), DocVerbatim::height(), MermaidManager::imageExtension(), MermaidManager::instance(), m_t, DocVerbatim::relPath(), stripPath(), visitCaption(), visitPostEnd(), visitPreStart(), and DocVerbatim::width().

Referenced by operator()().

◆ writeMscFile()

void DocbookDocVisitor::writeMscFile ( const QCString & fileName,
const DocVerbatim & s,
bool newFile = true )
private

Definition at line 1560 of file docbookvisitor.cpp.

1561{
1563 QCString shortName = makeBaseName(fileName,".msc");
1564 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1565 if (newFile) writeMscGraphFromFile(fileName,outDir,shortName,MscOutputFormat::BITMAP,s.srcFile(),s.srcLine(),false);
1566 visitPreStart(m_t, s.children(), s.hasCaption(), s.relPath() + shortName + ".png", s.width(), s.height());
1569}

References BITMAP, DocVerbatim::children(), Config_getString, DB_VIS_C, DocVerbatim::hasCaption(), DocVerbatim::height(), m_t, makeBaseName(), DocVerbatim::relPath(), DocVerbatim::srcFile(), DocVerbatim::srcLine(), visitCaption(), visitPostEnd(), visitPreStart(), DocVerbatim::width(), and writeMscGraphFromFile().

Referenced by operator()().

◆ writePlantUMLFile()

void DocbookDocVisitor::writePlantUMLFile ( const QCString & fileName,
const DocVerbatim & s )
private

Member Data Documentation

◆ m_bodySet

BoolStack DocbookDocVisitor::m_bodySet
private

Definition at line 162 of file docbookvisitor.h.

Referenced by operator()(), and operator()().

◆ m_ci

OutputCodeList& DocbookDocVisitor::m_ci
private

Definition at line 156 of file docbookvisitor.h.

Referenced by DocbookDocVisitor(), operator()(), operator()(), and operator()().

◆ m_colCnt

int DocbookDocVisitor::m_colCnt = 0
private

Definition at line 161 of file docbookvisitor.h.

Referenced by operator()(), and operator()().

◆ m_enabled

BoolStack DocbookDocVisitor::m_enabled
private

Definition at line 159 of file docbookvisitor.h.

◆ m_hide

◆ m_insidePre

bool DocbookDocVisitor::m_insidePre = false
private

Definition at line 157 of file docbookvisitor.h.

Referenced by operator()(), operator()(), and operator()().

◆ m_langExt

QCString DocbookDocVisitor::m_langExt
private

Definition at line 160 of file docbookvisitor.h.

Referenced by DocbookDocVisitor(), operator()(), and operator()().

◆ m_t


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