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 1718 of file docbookvisitor.cpp.

1719{
1721 if (m_hide) return;
1722 visitPostEnd(m_t, hasCaption);
1723 m_t << "</para>\n";
1724}
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 1757 of file docbookvisitor.cpp.

1758{
1760 if (m_hide) return;
1761 m_t << "\n";
1762 visitPostEnd(m_t, hasCaption);
1763 m_t << "</para>\n";
1764}

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

Referenced by operator()().

◆ endLink()

void DocbookDocVisitor::endLink ( )
private

Definition at line 1552 of file docbookvisitor.cpp.

1553{
1555 m_t << "</link>";
1556}

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 1652 of file docbookvisitor.cpp.

1653{
1655 if (m_hide) return;
1656 m_t << "\n";
1657 visitPostEnd(m_t, hasCaption);
1658 m_t << "</para>\n";
1659}

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

Referenced by operator()().

◆ endMscFile()

void DocbookDocVisitor::endMscFile ( bool hasCaption)
private

Definition at line 1680 of file docbookvisitor.cpp.

1681{
1683 if (m_hide) return;
1684 visitPostEnd(m_t, hasCaption);
1685 m_t << "</para>\n";
1686}

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

Referenced by operator()().

◆ endPlantUmlFile()

void DocbookDocVisitor::endPlantUmlFile ( bool hasCaption)
private

Definition at line 1608 of file docbookvisitor.cpp.

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

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 1534 of file docbookvisitor.cpp.

1535{
1537 m_t << convertToDocBook(str, retainNewLine);
1538}
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 417 of file docbookvisitor.cpp.

418{
420 if (m_hide) return;
421 m_t << "<anchor xml:id=\"_" << stripPath(anc.file()) << "_1" << filterId(anc.anchor()) << "\"/>";
422}
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:4952

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 598 of file docbookvisitor.cpp.

599{
601 if (m_hide) return;
602 if (l.isEnumList())
603 {
604 m_t << "<orderedlist>\n";
605 }
606 else
607 {
608 m_t << "<itemizedlist>\n";
609 }
610 visitChildren(l);
611 if (l.isEnumList())
612 {
613 m_t << "</orderedlist>\n";
614 }
615 else
616 {
617 m_t << "</itemizedlist>\n";
618 }
619}
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 621 of file docbookvisitor.cpp.

622{
624 if (m_hide) return;
625 switch (li.itemNumber())
626 {
627 case DocAutoList::Unchecked: // unchecked
628 m_t << "<listitem override=\"unchecked\">";
629 break;
630 case DocAutoList::Checked_x: // checked with x
631 case DocAutoList::Checked_X: // checked with X
632 m_t << "<listitem override=\"checked\">";
633 break;
634 default:
635 m_t << "<listitem>";
636 break;
637 }
638 visitChildren(li);
639 m_t << "</listitem>";
640}
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 571 of file docbookvisitor.cpp.

572{
574 if (m_hide) return;
575 auto opt = cite.option();
576 if (!cite.file().isEmpty())
577 {
578 if (!opt.noCite()) startLink(cite.file(),filterId(cite.anchor()));
579
580 filter(cite.getText());
581
582 if (!opt.noCite()) endLink();
583 }
584 else
585 {
586 if (!opt.noPar()) filter("[");
587 filter(cite.target());
588 if (!opt.noPar()) filter("]");
589
590 }
591
592}
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 1274 of file docbookvisitor.cpp.

1275{
1277 if (m_hide) return;
1278 bool exists = false;
1279 std::string inBuf;
1280 if (readInputFile(df.file(),inBuf))
1281 {
1282 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
1283 ".dia", // extension
1284 inBuf, // contents
1285 exists);
1286 if (!fileName.isEmpty())
1287 {
1288 startDiaFile(fileName,df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine(),!exists);
1289 visitChildren(df);
1290 endDiaFile(df.hasCaption());
1291 }
1292 }
1293}
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:6982
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:5553

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 1232 of file docbookvisitor.cpp.

1233{
1235 if (m_hide) return;
1236 bool exists = false;
1237 std::string inBuf;
1238 if (readInputFile(df.file(),inBuf))
1239 {
1240 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
1241 ".dot", // extension
1242 inBuf, // contents
1243 exists);
1244 if (!fileName.isEmpty())
1245 {
1246 startDotFile(fileName,df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine(),!exists);
1247 visitChildren(df);
1248 endDotFile(df.hasCaption());
1249 }
1250 }
1251}
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 541 of file docbookvisitor.cpp.

542{
544 if (m_hide) return;
545
546 if (f.isInline()) m_t << "<inlinemediaobject>\n";
547 else m_t << " <mediaobject>\n";
548 m_t << " <imageobject>\n";
549 m_t << " <imagedata ";
550 m_t << "align=\"center\" valign=\"middle\" scalefit=\"0\" fileref=\"" << f.relPath() << f.name() << ".png\"/>\n";
551 m_t << " </imageobject>\n";
552 if (f.isInline()) m_t << "</inlinemediaobject>\n";
553 else m_t << " </mediaobject>\n";
554}
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 1157 of file docbookvisitor.cpp.

1158{
1160 if (m_hide) return;
1161 if (href.url().at(0) != '#')
1162 {
1163 m_t << "<link xlink:href=\"" << convertToDocBook(href.url()) << "\">";
1164 }
1165 else
1166 {
1167 startLink(href.file(),filterId(href.url().mid(1)));
1168 }
1169 visitChildren(href);
1170 m_t << "</link>";
1171}
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 1511 of file docbookvisitor.cpp.

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

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

◆ operator()() [12/59]

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

Definition at line 1137 of file docbookvisitor.cpp.

1138{
1140 if (m_hide) return;
1141 m_t << "<caption>";
1142 if (!c.file().isEmpty())
1143 {
1144 m_t << "<anchor xml:id=\"_" << stripPath(c.file()) << "_1" << filterId(c.anchor()) << "\"/>";
1145 }
1146 visitChildren(c);
1147 m_t << "</caption>\n";
1148}
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 1082 of file docbookvisitor.cpp.

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

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

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

◆ operator()() [15/59]

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

Definition at line 994 of file docbookvisitor.cpp.

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

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

◆ operator()() [16/59]

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

Definition at line 1003 of file docbookvisitor.cpp.

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

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

◆ operator()() [17/59]

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

Definition at line 1182 of file docbookvisitor.cpp.

1183{
1185 if (m_hide) return;
1186 m_t << "\n";
1187 auto summary = d.summary();
1188 if (summary)
1189 {
1190 std::visit(*this,*summary);
1191 }
1192 m_t << "<para>";
1193 visitChildren(d);
1194 m_t << "</para>";
1195 m_t << "\n";
1196}
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 1198 of file docbookvisitor.cpp.

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

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

◆ operator()() [19/59]

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

Definition at line 915 of file docbookvisitor.cpp.

916{
918 if (m_hide) return;
919 if (s.children().empty()) return;
920 // opening tag for ordered list will be handled in DocHtmlListItem
921 // due to (re-)numbering possibilities
922 if (s.type()!=DocHtmlList::Ordered)
923 m_t << "<itemizedlist>\n";
924 visitChildren(s);
925 if (s.type()==DocHtmlList::Ordered)
926 m_t << "</orderedlist>\n";
927 else
928 m_t << "</itemizedlist>\n";
929}
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 931 of file docbookvisitor.cpp.

932{
934 if (m_hide) return;
935 const DocHtmlList *l = std::get_if<DocHtmlList>(s.parent());
936 if (l->type()==DocHtmlList::Ordered)
937 {
938 bool isFirst = &std::get<DocHtmlListItem>(l->children().front())==&s;
939 int value = 0;
940 QCString type;
941 for (const auto &opt : s.attribs())
942 {
943 if (opt.name=="value")
944 {
945 bool ok = false;
946 int val = opt.value.toInt(&ok);
947 if (ok) value = val;
948 }
949 }
950
951 if (value>0 || isFirst)
952 {
953 for (const auto &opt : l->attribs())
954 {
955 if (opt.name=="type")
956 {
957 if (opt.value=="1")
958 type = " numeration=\"arabic\"";
959 else if (opt.value=="a")
960 type = " numeration=\"loweralpha\"";
961 else if (opt.value=="A")
962 type = " numeration=\"upperalpha\"";
963 else if (opt.value=="i")
964 type = " numeration=\"lowerroman\"";
965 else if (opt.value=="I")
966 type = " numeration=\"upperroman\"";
967 }
968 else if (value==0 && opt.name=="start")
969 {
970 bool ok = false;
971 int val = opt.value.toInt(&ok);
972 if (ok) value = val;
973 }
974 }
975 }
976
977 if (value>0 && !isFirst)
978 {
979 m_t << "</orderedlist>\n";
980 }
981 if (value>0 || isFirst)
982 {
983 m_t << "<orderedlist";
984 if (!type.isEmpty()) m_t << type.data();
985 if (value>0) m_t << " startingnumber=\"" << value << "\"";
986 m_t << ">\n";
987 }
988 }
989 m_t << "<listitem>\n";
990 visitChildren(s);
991 m_t << "</listitem>\n";
992}
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 1044 of file docbookvisitor.cpp.

1045{
1047 m_colCnt = 0;
1048 if (m_hide) return;
1049
1050 if (tr.isHeading())
1051 {
1052 if (m_bodySet.top()) m_t << "</tbody>\n";
1053 m_bodySet.top() = false;
1054 m_t << "<thead>\n";
1055 }
1056 else if (!m_bodySet.top())
1057 {
1058 m_bodySet.top() = true;
1059 m_t << "<tbody>\n";
1060 }
1061
1062 m_t << " <row ";
1063
1064 for (const auto &opt : tr.attribs())
1065 {
1066 if (supportedHtmlAttribute(opt.name))
1067 {
1068 // process supported attributes only
1069 m_t << " " << opt.name << "='" << convertToDocBook(opt.value) << "'";
1070 }
1071 }
1072 m_t << ">\n";
1073 visitChildren(tr);
1074 m_t << "</row>\n";
1075 if (tr.isHeading())
1076 {
1077 m_t << "</thead><tbody>\n";
1078 m_bodySet.top() = true;
1079 }
1080}
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 1173 of file docbookvisitor.cpp.

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

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

◆ operator()() [23/59]

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

Definition at line 1021 of file docbookvisitor.cpp.

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

1208{
1210 if (img.type()==DocImage::DocBook)
1211 {
1212 if (m_hide) return;
1213 m_t << "\n";
1214 QCString baseName=stripPath(img.name());
1215 visitPreStart(m_t, img.children(), img.hasCaption(), img.relPath() + baseName, img.width(), img.height(), img.isInlineImage());
1216 visitChildren(img);
1218 QCString file;
1219 bool ambig = false;
1220 FileDef *fd=findFileDef(Doxygen::imageNameLinkedMap, baseName, ambig);
1221 if (fd)
1222 {
1223 file=fd->absFilePath();
1224 }
1225 copyFile(file,Config_getString(DOCBOOK_OUTPUT)+"/"+baseName);
1226 }
1227 else // skip other formats
1228 {
1229 }
1230}
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:5880
FileDef * findFileDef(const FileNameLinkedMap *fnMap, const QCString &n, bool &ambig)
Definition util.cpp:2894

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 424 of file docbookvisitor.cpp.

425{
427 if (m_hide) return;
429 switch(inc.type())
430 {
432 {
433 m_t << "<literallayout><computeroutput>";
434 FileInfo cfi( inc.file().str() );
435 auto fd = createFileDef( cfi.dirPath(), cfi.fileName() );
437 inc.text(),
438 langExt,
439 inc.stripCodeComments(),
440 CodeParserOptions()
441 .setExample(inc.isExample(),inc.exampleFile())
442 .setFileDef(fd.get())
443 );
444 m_t << "</computeroutput></literallayout>";
445 }
446 break;
448 m_t << "<literallayout><computeroutput>";
450 inc.text(),
451 langExt,
452 inc.stripCodeComments(),
453 CodeParserOptions()
454 .setExample(inc.isExample(),inc.exampleFile())
455 );
456 m_t << "</computeroutput></literallayout>";
457 break;
465 break;
467 m_t << inc.text();
468 break;
470 m_t << "<literallayout>";
471 filter(inc.text());
472 m_t << "</literallayout>";
473 break;
476 m_t << "<literallayout><computeroutput>";
478 inc.file(),
479 inc.blockId(),
480 inc.context(),
482 inc.trimLeft(),
484 );
485 m_t << "</computeroutput></literallayout>";
486 break;
487 }
488}
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:5214

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 490 of file docbookvisitor.cpp.

491{
493 if (op.isFirst())
494 {
495 if (!m_hide)
496 {
497 m_t << "<programlisting linenumbering=\"unnumbered\">";
498 }
500 m_hide = TRUE;
501 }
502 QCString locLangExt = getFileNameExtension(op.includeFileName());
503 if (locLangExt.isEmpty()) locLangExt = m_langExt;
504 SrcLangExt langExt = getLanguageFromFileName(locLangExt);
505 if (op.type()!=DocIncOperator::Skip)
506 {
507 m_hide = popHidden();
508 if (!m_hide)
509 {
510 std::unique_ptr<FileDef> fd;
511 if (!op.includeFileName().isEmpty())
512 {
513 FileInfo cfi( op.includeFileName().str() );
514 fd = createFileDef( cfi.dirPath(), cfi.fileName() );
515 }
516
517 getCodeParser(locLangExt).parseCode(m_ci,op.context(),
518 op.text(),langExt,
520 CodeParserOptions()
521 .setExample(op.isExample(), op.exampleFile())
522 .setFileDef(fd.get())
523 .setStartLine(op.line())
524 .setShowLineNumbers(op.showLineNo())
525 );
526 }
528 m_hide=TRUE;
529 }
530 if (op.isLast())
531 {
532 m_hide = popHidden();
533 if (!m_hide) m_t << "</programlisting>";
534 }
535 else
536 {
537 if (!m_hide) m_t << "\n";
538 }
539}
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:5256

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 556 of file docbookvisitor.cpp.

557{
559 if (m_hide) return;
560 m_t << "<indexterm><primary>";
561 filter(ie.entry());
562 m_t << "</primary></indexterm>\n";
563}
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 1150 of file docbookvisitor.cpp.

1151{
1153 if (m_hide) return;
1154 visitChildren(i);
1155}

References DB_VIS_C, m_hide, and visitChildren().

◆ operator()() [29/59]

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

Definition at line 1494 of file docbookvisitor.cpp.

1495{
1497 if (m_hide) return;
1498 startLink(ref.file(),ref.anchor());
1499 visitChildren(ref);
1500 endLink();
1501 m_t << " ";
1502}
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 1316 of file docbookvisitor.cpp.

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

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 1305 of file docbookvisitor.cpp.

1306{
1308 if (m_hide) return;
1309 if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
1310 if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file()));
1311 startMermaidFile(df.file(),df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine());
1312 visitChildren(df);
1314}
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 1253 of file docbookvisitor.cpp.

1254{
1256 if (m_hide) return;
1257 bool exists = false;
1258 std::string inBuf;
1259 if (readInputFile(df.file(),inBuf))
1260 {
1261 auto fileName = writeFileContents(Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file())+"_", // baseName
1262 ".msc", // extension
1263 inBuf, // contents
1264 exists);
1265 if (!fileName.isEmpty())
1266 {
1267 startMscFile(fileName,df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine(),!exists);
1268 visitChildren(df);
1269 endMscFile(df.hasCaption());
1270 }
1271 }
1272}
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 642 of file docbookvisitor.cpp.

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

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

◆ operator()() [36/59]

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

Definition at line 1412 of file docbookvisitor.cpp.

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

1363{
1365 if (m_hide) return;
1366 m_t << "\n";
1367 m_t << " <formalpara>\n";
1368 m_t << " <title>\n";
1369 switch(s.type())
1370 {
1375 default:
1376 ASSERT(0);
1377 }
1378 m_t << "</title>\n";
1379 m_t << " <para>\n";
1380 m_t << " <table frame=\"all\">\n";
1381 int ncols = 2;
1382 if (s.type() == DocParamSect::Param)
1383 {
1384 bool hasInOutSpecs = s.hasInOutSpecifier();
1385 bool hasTypeSpecs = s.hasTypeSpecifier();
1386 if (hasInOutSpecs && hasTypeSpecs) ncols += 2;
1387 else if (hasInOutSpecs || hasTypeSpecs) ncols += 1;
1388 }
1389 m_t << " <tgroup cols=\"" << ncols << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n";
1390 for (int i = 1; i <= ncols; i++)
1391 {
1392 if (i == ncols) m_t << " <colspec colwidth=\"4*\"/>\n";
1393 else m_t << " <colspec colwidth=\"1*\"/>\n";
1394 }
1395 m_t << " <tbody>\n";
1396 visitChildren(s);
1397 m_t << " </tbody>\n";
1398 m_t << " </tgroup>\n";
1399 m_t << " </table>\n";
1400 m_t << " </para>\n";
1401 m_t << " </formalpara>\n";
1402 m_t << " ";
1403}
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 1526 of file docbookvisitor.cpp.

1527{
1529 if (m_hide) return;
1530 visitChildren(b);
1531}

References DB_VIS_C, m_hide, and visitChildren().

◆ operator()() [39/59]

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

Definition at line 1295 of file docbookvisitor.cpp.

1296{
1298 if (m_hide) return;
1299 if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file()));
1300 startPlantUmlFile(df.file(),df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine());
1301 visitChildren(df);
1303}
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 1325 of file docbookvisitor.cpp.

1326{
1328 if (m_hide) return;
1329 if (ref.isSubPage())
1330 {
1331 startLink(QCString(),ref.anchor());
1332 }
1333 else
1334 {
1335 if (!ref.file().isEmpty()) startLink(ref.file(),ref.anchor());
1336 }
1337
1338 if (!ref.hasLinkText()) filter(ref.targetTitle());
1339 visitChildren(ref);
1340 if (!ref.file().isEmpty()) endLink();
1341}
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 653 of file docbookvisitor.cpp.

654{
656 visitChildren(r);
657}

References DB_VIS_C, and visitChildren().

◆ operator()() [42/59]

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

Definition at line 1343 of file docbookvisitor.cpp.

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

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

◆ operator()() [43/59]

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

Definition at line 1353 of file docbookvisitor.cpp.

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

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

◆ operator()() [44/59]

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

Definition at line 900 of file docbookvisitor.cpp.

901{
903 if (m_hide) return;
904 m_t << "<section xml:id=\"_" << stripPath(s.file());
905 if (!s.anchor().isEmpty()) m_t << "_1" << s.anchor();
906 m_t << "\">\n";
907 if (s.title())
908 {
909 std::visit(*this,*s.title());
910 }
911 visitChildren(s);
912 m_t << "</section>\n";
913}
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 1405 of file docbookvisitor.cpp.

1406{
1408 if (m_hide) return;
1409 m_t << " " << sep.chars() << " ";
1410}
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 879 of file docbookvisitor.cpp.

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

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

◆ operator()() [47/59]

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

Definition at line 888 of file docbookvisitor.cpp.

889{
891 if (m_hide) return;
892 m_t << "<listitem>";
893 if (li.paragraph())
894 {
895 visit(*this,*li.paragraph());
896 }
897 m_t << "</listitem>\n";
898}
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 659 of file docbookvisitor.cpp.

660{
662 if (m_hide) return;
663 switch(s.type())
664 {
666 if (m_insidePre)
667 {
668 m_t << "<formalpara><title>" << theTranslator->trSeeAlso() << "</title>\n";
669 }
670 else
671 {
672 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trSeeAlso()) << "</title>\n";
673 }
674 break;
676 if (m_insidePre)
677 {
678 m_t << "<formalpara><title>" << theTranslator->trReturns()<< "</title>\n";
679 }
680 else
681 {
682 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trReturns()) << "</title>\n";
683 }
684 break;
686 if (m_insidePre)
687 {
688 m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, TRUE) << "</title>\n";
689 }
690 else
691 {
692 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trAuthor(TRUE, TRUE)) << "</title>\n";
693 }
694 break;
696 if (m_insidePre)
697 {
698 m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, FALSE) << "</title>\n";
699 }
700 else
701 {
702 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trAuthor(TRUE, FALSE)) << "</title>\n";
703 }
704 break;
706 if (m_insidePre)
707 {
708 m_t << "<formalpara><title>" << theTranslator->trVersion() << "</title>\n";
709 }
710 else
711 {
712 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trVersion()) << "</title>\n";
713 }
714 break;
716 if (m_insidePre)
717 {
718 m_t << "<formalpara><title>" << theTranslator->trSince() << "</title>\n";
719 }
720 else
721 {
722 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trSince()) << "</title>\n";
723 }
724 break;
726 if (m_insidePre)
727 {
728 m_t << "<formalpara><title>" << theTranslator->trDate() << "</title>\n";
729 }
730 else
731 {
732 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trDate()) << "</title>\n";
733 }
734 break;
736 if (m_insidePre)
737 {
738 m_t << "<note><title>" << theTranslator->trNote() << "</title>\n";
739 }
740 else
741 {
742 m_t << "<note><title>" << convertToDocBook(theTranslator->trNote()) << "</title>\n";
743 }
744 break;
746 if (m_insidePre)
747 {
748 m_t << "<warning><title>" << theTranslator->trWarning() << "</title>\n";
749 }
750 else
751 {
752 m_t << "<warning><title>" << convertToDocBook(theTranslator->trWarning()) << "</title>\n";
753 }
754 break;
756 if (m_insidePre)
757 {
758 m_t << "<formalpara><title>" << theTranslator->trPrecondition() << "</title>\n";
759 }
760 else
761 {
762 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trPrecondition()) << "</title>\n";
763 }
764 break;
766 if (m_insidePre)
767 {
768 m_t << "<formalpara><title>" << theTranslator->trPostcondition() << "</title>\n";
769 }
770 else
771 {
772 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trPostcondition()) << "</title>\n";
773 }
774 break;
776 if (m_insidePre)
777 {
778 m_t << "<formalpara><title>" << theTranslator->trCopyright() << "</title>\n";
779 }
780 else
781 {
782 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trCopyright()) << "</title>\n";
783 }
784 break;
786 if (m_insidePre)
787 {
788 m_t << "<formalpara><title>" << theTranslator->trInvariant() << "</title>\n";
789 }
790 else
791 {
792 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trInvariant()) << "</title>\n";
793 }
794 break;
796 // <remark> is miising the <title> possibility
797 if (m_insidePre)
798 {
799 m_t << "<formalpara><title>" << theTranslator->trRemarks() << "</title>\n";
800 }
801 else
802 {
803 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trRemarks()) << "</title>\n";
804 }
805 break;
807 if (m_insidePre)
808 {
809 m_t << "<caution><title>" << theTranslator->trAttention() << "</title>\n";
810 }
811 else
812 {
813 m_t << "<caution><title>" << convertToDocBook(theTranslator->trAttention()) << "</title>\n";
814 }
815 break;
817 if (m_insidePre)
818 {
819 m_t << "<important><title>" << theTranslator->trImportant() << "</title>\n";
820 }
821 else
822 {
823 m_t << "<important><title>" << convertToDocBook(theTranslator->trImportant()) << "</title>\n";
824 }
825 break;
829 if (s.hasTitle())
830 m_t << "<formalpara>\n";
831 else
832 m_t << "<para>\n";
833 break;
834 }
835
836 if (s.title())
837 {
838 std::visit(*this,*s.title());
839 }
840 visitChildren(s);
841
842 switch(s.type())
843 {
847 if (s.hasTitle())
848 m_t << "</formalpara>\n";
849 else
850 m_t << "</para>\n";
851 break;
853 m_t << "</note>\n";
854 break;
856 m_t << "</caution>\n";
857 break;
859 m_t << "</important>\n";
860 break;
862 m_t << "</warning>\n";
863 break;
864 default:
865 m_t << "</formalpara>\n";
866 break;
867 }
868}
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 565 of file docbookvisitor.cpp.

566{
568 // m_t << "<simplesect/>";
569}

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 1504 of file docbookvisitor.cpp.

1505{
1507 visitChildren(t);
1508}

References DB_VIS_C, and visitChildren().

◆ operator()() [53/59]

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

Definition at line 870 of file docbookvisitor.cpp.

871{
873 if (m_hide) return;
874 if (t.hasTitle()) m_t << "<title>";
875 visitChildren(t);
876 if (t.hasTitle()) m_t << "</title>";
877}
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 QCString docbookOutput = Config_getString(DOCBOOK_OUTPUT);
406 QCString baseName = MermaidManager::instance().writeMermaidSource(docbookOutput,
408 s.srcFile(),s.srcLine());
409 m_t << "<para>\n";
410 writeMermaidFile(baseName,s);
411 m_t << "</para>\n";
412 }
413 break;
414 }
415}
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)
QCString writeMermaidSource(const QCString &outDirArg, const QCString &fileName, const QCString &content, OutputFormat format, const QCString &srcFile, int srcLine)
Write a Mermaid source file and register it for CLI rendering.
Definition mermaid.cpp:52
static MermaidManager & instance()
Definition mermaid.cpp:32
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:231
SrcLangExt getLanguageFromCodeLang(QCString &fileName)
Routine to handle the language attribute of the \code command.
Definition util.cpp:5232

References DocVerbatim::Code, Config_getBool, Config_getString, DocVerbatim::context(), DB_VIS_C, 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, MermaidManager::MERM_BITMAP, 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 1520 of file docbookvisitor.cpp.

1521{
1523 // TODO: to be implemented
1524}

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 1478 of file docbookvisitor.cpp.

1479{
1481 if (m_hide) return;
1482 if (x.title().isEmpty()) return;
1483 m_t << "<para><link linkend=\"_";
1484 m_t << stripPath(x.file()) << "_1" << x.anchor();
1485 m_t << "\">";
1486 filter(x.title());
1487 m_t << "</link>";
1488 m_t << " ";
1489 visitChildren(x);
1490 if (x.title().isEmpty()) return;
1491 m_t << "</para>";
1492}
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 1699 of file docbookvisitor.cpp.

1708{
1710 QCString baseName=makeBaseName(fileName,".dia");
1711 baseName.prepend("dia_");
1712 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1713 if (newFile) writeDiaGraphFromFile(fileName,outDir,baseName,DiaOutputFormat::BITMAP,srcFile,srcLine);
1714 m_t << "<para>\n";
1715 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1716}
void writeDiaGraphFromFile(const QCString &inFile, const QCString &outDir, const QCString &outFile, DiaOutputFormat format, const QCString &srcFile, int srcLine)
Definition dia.cpp:26
QCString makeBaseName(const QCString &name, const QCString &ext)
Definition util.cpp:4968

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 1737 of file docbookvisitor.cpp.

1746{
1748 QCString baseName=makeBaseName(fileName,".dot");
1749 baseName.prepend("dot_");
1750 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1751 QCString imgExt = getDotImageExtension();
1752 if (newFile) writeDotGraphFromFile(fileName,outDir,baseName,GraphOutputFormat::BITMAP,srcFile,srcLine);
1753 m_t << "<para>\n";
1754 visitPreStart(m_t, children, hasCaption, relPath + baseName + "." + imgExt, width, height);
1755}
void writeDotGraphFromFile(const QCString &inFile, const QCString &outDir, const QCString &outFile, GraphOutputFormat format, const QCString &srcFile, int srcLine)
Definition dot.cpp:230
QCString getDotImageExtension()
Definition util.cpp:6312

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 1540 of file docbookvisitor.cpp.

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

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 1629 of file docbookvisitor.cpp.

1638{
1640 if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
1641 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1642 std::string inBuf;
1643 readInputFile(fileName,inBuf);
1644 QCString baseName = MermaidManager::instance().writeMermaidSource(outDir,
1645 QCString(),inBuf,MermaidManager::MERM_BITMAP,srcFile,srcLine);
1646 QCString shortName = stripPath(baseName);
1648 m_t << "<para>\n";
1649 visitPreStart(m_t, children, hasCaption, relPath + shortName + ".png", width, height);
1650}
void generateMermaidOutput(const QCString &baseName, const QCString &outDir, OutputFormat format)
Register a generated Mermaid image with the index.
Definition mermaid.cpp:104

References Config_getBool, Config_getString, DB_VIS_C, MermaidManager::generateMermaidOutput(), MermaidManager::instance(), m_t, MermaidManager::MERM_BITMAP, 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 1661 of file docbookvisitor.cpp.

1670{
1672 QCString baseName=makeBaseName(fileName,".msc");
1673 baseName.prepend("msc_");
1674 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1675 if (newFile) writeMscGraphFromFile(fileName,outDir,baseName,MscOutputFormat::BITMAP,srcFile,srcLine);
1676 m_t << "<para>\n";
1677 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1678}
void writeMscGraphFromFile(const QCString &inFile, const QCString &outDir, const QCString &outFile, MscOutputFormat format, const QCString &srcFile, int srcLine)
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 1580 of file docbookvisitor.cpp.

1589{
1591 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1592 std::string inBuf;
1593 readInputFile(fileName,inBuf);
1594 auto baseNameVector = PlantumlManager::instance().writePlantUMLSource(outDir,
1595 QCString(),inBuf,PlantumlManager::PUML_BITMAP,QCString(),srcFile,srcLine,false);
1596 bool first = true;
1597 for (const auto &bName: baseNameVector)
1598 {
1599 QCString baseName=makeBaseName(bName,".pu");
1601 if (!first) endPlantUmlFile(hasCaption);
1602 first = false;
1603 m_t << "<para>\n";
1604 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1605 }
1606}
void generatePlantUMLOutput(const QCString &baseName, const QCString &outDir, OutputFormat format)
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 1688 of file docbookvisitor.cpp.

1689{
1691 QCString shortName = stripPath(baseName);
1692 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1693 writeDiaGraphFromFile(baseName+".dia",outDir,shortName,DiaOutputFormat::BITMAP,s.srcFile(),s.srcLine());
1694 visitPreStart(m_t, s.children(), s.hasCaption(), shortName, s.width(),s.height());
1697}
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 1726 of file docbookvisitor.cpp.

1727{
1729 QCString shortName = makeBaseName(fileName,".dot");
1730 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1731 if (newFile) writeDotGraphFromFile(fileName,outDir,shortName,GraphOutputFormat::BITMAP,s.srcFile(),s.srcLine());
1732 visitPreStart(m_t, s.children(), s.hasCaption(), s.relPath() + shortName + "." + getDotImageExtension(), s.width(),s.height());
1735}
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 1617 of file docbookvisitor.cpp.

1618{
1620 if (Config_getBool(MERMAID_RENDER_MODE)==MERMAID_RENDER_MODE_t::CLIENT_SIDE) return;
1621 QCString shortName = stripPath(baseName);
1622 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1624 visitPreStart(m_t, s.children(), s.hasCaption(), s.relPath() + shortName + ".png", s.width(),s.height());
1627}

References DocVerbatim::children(), Config_getBool, Config_getString, DB_VIS_C, MermaidManager::generateMermaidOutput(), DocVerbatim::hasCaption(), DocVerbatim::height(), MermaidManager::instance(), m_t, MermaidManager::MERM_BITMAP, 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 1558 of file docbookvisitor.cpp.

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

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: