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 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)
void endMscFile (bool hasCaption)
void writeMscFile (const QCString &fileName, const DocVerbatim &s)
void startDiaFile (const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine)
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)
void endDotFile (bool hasCaption)
void writeDotFile (const QCString &fileName, const DocVerbatim &s)
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 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 179 of file docbookvisitor.cpp.

180 : m_t(t), m_ci(ci),m_langExt(langExt)
181{
183 // m_t << "<section>\n";
184}
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 1662 of file docbookvisitor.cpp.

1663{
1665 if (m_hide) return;
1666 visitPostEnd(m_t, hasCaption);
1667 m_t << "</para>\n";
1668}
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 1701 of file docbookvisitor.cpp.

1702{
1704 if (m_hide) return;
1705 m_t << "\n";
1706 visitPostEnd(m_t, hasCaption);
1707 m_t << "</para>\n";
1708}

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

Referenced by operator()().

◆ endLink()

void DocbookDocVisitor::endLink ( )
private

Definition at line 1541 of file docbookvisitor.cpp.

1542{
1544 m_t << "</link>";
1545}

References DB_VIS_C, and m_t.

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

◆ endMscFile()

void DocbookDocVisitor::endMscFile ( bool hasCaption)
private

Definition at line 1624 of file docbookvisitor.cpp.

1625{
1627 if (m_hide) return;
1628 visitPostEnd(m_t, hasCaption);
1629 m_t << "</para>\n";
1630}

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

Referenced by operator()().

◆ endPlantUmlFile()

void DocbookDocVisitor::endPlantUmlFile ( bool hasCaption)
private

Definition at line 1596 of file docbookvisitor.cpp.

1597{
1599 if (m_hide) return;
1600 m_t << "\n";
1601 visitPostEnd(m_t, hasCaption);
1602 m_t << "</para>\n";
1603}

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

1524{
1526 m_t << convertToDocBook(str, retainNewLine);
1527}
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/58]

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

Definition at line 450 of file docbookvisitor.cpp.

451{
453 if (m_hide) return;
454 m_t << "<anchor xml:id=\"_" << stripPath(anc.file()) << "_1" << filterId(anc.anchor()) << "\"/>";
455}
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:5461

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

◆ operator()() [2/58]

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

Definition at line 631 of file docbookvisitor.cpp.

632{
634 if (m_hide) return;
635 if (l.isEnumList())
636 {
637 m_t << "<orderedlist>\n";
638 }
639 else
640 {
641 m_t << "<itemizedlist>\n";
642 }
643 visitChildren(l);
644 if (l.isEnumList())
645 {
646 m_t << "</orderedlist>\n";
647 }
648 else
649 {
650 m_t << "</itemizedlist>\n";
651 }
652}
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/58]

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

Definition at line 654 of file docbookvisitor.cpp.

655{
657 if (m_hide) return;
658 switch (li.itemNumber())
659 {
660 case DocAutoList::Unchecked: // unchecked
661 m_t << "<listitem override=\"unchecked\">";
662 break;
663 case DocAutoList::Checked_x: // checked with x
664 case DocAutoList::Checked_X: // checked with X
665 m_t << "<listitem override=\"checked\">";
666 break;
667 default:
668 m_t << "<listitem>";
669 break;
670 }
671 visitChildren(li);
672 m_t << "</listitem>";
673}
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/58]

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

Definition at line 604 of file docbookvisitor.cpp.

605{
607 if (m_hide) return;
608 auto opt = cite.option();
609 if (!cite.file().isEmpty())
610 {
611 if (!opt.noCite()) startLink(cite.file(),filterId(cite.anchor()));
612
613 filter(cite.getText());
614
615 if (!opt.noCite()) endLink();
616 }
617 else
618 {
619 if (!opt.noPar()) filter("[");
620 filter(cite.target());
621 if (!opt.noPar()) filter("]");
622
623 }
624
625}
QCString getText() const
Definition docnode.cpp:939
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:150

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/58]

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

Definition at line 1285 of file docbookvisitor.cpp.

1286{
1288 if (m_hide) return;
1289 if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file()));
1290 startDiaFile(df.file(),df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine());
1291 visitChildren(df);
1292 endDiaFile(df.hasCaption());
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)
#define Config_getBool(name)
Definition config.h:33
#define Config_getString(name)
Definition config.h:32
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:6370

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

◆ operator()() [6/58]

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

Definition at line 1265 of file docbookvisitor.cpp.

1266{
1268 if (m_hide) return;
1269 if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file()));
1270 startDotFile(df.file(),df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine());
1271 visitChildren(df);
1272 endDotFile(df.hasCaption());
1273}
void startDotFile(const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine)
void endDotFile(bool hasCaption)

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

◆ operator()() [7/58]

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

Definition at line 235 of file docbookvisitor.cpp.

236{
238 if (m_hide) return;
239 const char *res = EmojiEntityMapper::instance().unicode(s.index());
240 if (res)
241 {
242 m_t << res;
243 }
244 else
245 {
246 m_t << s.name();
247 }
248}
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/58]

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

Definition at line 574 of file docbookvisitor.cpp.

575{
577 if (m_hide) return;
578
579 if (f.isInline()) m_t << "<inlinemediaobject>\n";
580 else m_t << " <mediaobject>\n";
581 m_t << " <imageobject>\n";
582 m_t << " <imagedata ";
583 m_t << "align=\"center\" valign=\"middle\" scalefit=\"0\" fileref=\"" << f.relPath() << f.name() << ".png\"/>\n";
584 m_t << " </imageobject>\n";
585 if (f.isInline()) m_t << "</inlinemediaobject>\n";
586 else m_t << " </mediaobject>\n";
587}
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/58]

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

Definition at line 271 of file docbookvisitor.cpp.

272{
274 if (m_hide) return;
275 m_t << "<informaltable frame='bottom'><tgroup cols='1'><colspec align='center'/><tbody><row><entry align='center'>\n";
276 m_t << "</entry></row></tbody></tgroup></informaltable>\n";
277}

References DB_VIS_C, m_hide, and m_t.

◆ operator()() [10/58]

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

Definition at line 1190 of file docbookvisitor.cpp.

1191{
1193 if (m_hide) return;
1194 if (href.url().at(0) != '#')
1195 {
1196 m_t << "<link xlink:href=\"" << convertToDocBook(href.url()) << "\">";
1197 }
1198 else
1199 {
1200 startLink(href.file(),filterId(href.url().mid(1)));
1201 }
1202 visitChildren(href);
1203 m_t << "</link>";
1204}
QCString url() const
Definition docnode.h:830
QCString file() const
Definition docnode.h:831
QCString mid(size_t index, size_t len=static_cast< size_t >(-1)) const
Definition qcstring.h:226
char & at(size_t i)
Returns a reference to the character at index i.
Definition qcstring.h:578

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

◆ operator()() [11/58]

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

Definition at line 1500 of file docbookvisitor.cpp.

1501{
1503 if (m_hide) return;
1504 m_t << "<blockquote>";
1505 visitChildren(q);
1506 m_t << "</blockquote>";
1507}

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

◆ operator()() [12/58]

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

Definition at line 1170 of file docbookvisitor.cpp.

1171{
1173 if (m_hide) return;
1174 m_t << "<caption>";
1175 if (!c.file().isEmpty())
1176 {
1177 m_t << "<anchor xml:id=\"_" << stripPath(c.file()) << "_1" << filterId(c.anchor()) << "\"/>";
1178 }
1179 visitChildren(c);
1180 m_t << "</caption>\n";
1181}
QCString anchor() const
Definition docnode.h:1235
QCString file() const
Definition docnode.h:1234

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

◆ operator()() [13/58]

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

Definition at line 1115 of file docbookvisitor.cpp.

1116{
1118 m_colCnt++;
1119 if (m_hide) return;
1120 m_t << "<entry";
1121
1122 for (const auto &opt : c.attribs())
1123 {
1124 if (opt.name=="colspan")
1125 {
1126 m_t << " namest='c" << m_colCnt << "'";
1127 int cols = opt.value.toInt();
1128 m_colCnt += (cols - 1);
1129 m_t << " nameend='c" << m_colCnt << "'";
1130 }
1131 else if (opt.name=="rowspan")
1132 {
1133 int extraRows = opt.value.toInt() - 1;
1134 m_t << " morerows='" << extraRows << "'";
1135 }
1136 else if (opt.name=="class")
1137 {
1138 if (opt.value.startsWith("markdownTable")) // handle markdown generated attributes
1139 {
1140 if (opt.value.endsWith("Right"))
1141 {
1142 m_t << " align='right'";
1143 }
1144 else if (opt.value.endsWith("Left"))
1145 {
1146 m_t << " align='left'";
1147 }
1148 else if (opt.value.endsWith("Center"))
1149 {
1150 m_t << " align='center'";
1151 }
1152 // skip 'markdownTable*' value ending with "None"
1153 }
1154 else
1155 {
1156 m_t << " class='" << convertToDocBook(opt.value) << "'";
1157 }
1158 }
1159 else if (supportedHtmlAttribute(opt.name))
1160 {
1161 // process supported attributes only
1162 m_t << " " << opt.name << "='" << convertToDocBook(opt.value) << "'";
1163 }
1164 }
1165 m_t << ">";
1166 visitChildren(c);
1167 m_t << "</entry>";
1168}
const HtmlAttribList & attribs() const
Definition docnode.h:1205
static bool supportedHtmlAttribute(const QCString &name)

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

◆ operator()() [14/58]

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

Definition at line 1045 of file docbookvisitor.cpp.

1046{
1048 if (m_hide) return;
1049 m_t << "<listitem>";
1050 visitChildren(dd);
1051 m_t << "</listitem>\n";
1052}

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

◆ operator()() [15/58]

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

Definition at line 1027 of file docbookvisitor.cpp.

1028{
1030 if (m_hide) return;
1031 m_t << "<variablelist>\n";
1032 visitChildren(l);
1033 m_t << "</variablelist>\n";
1034}

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

◆ operator()() [16/58]

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

Definition at line 1036 of file docbookvisitor.cpp.

1037{
1039 if (m_hide) return;
1040 m_t << "<varlistentry><term>";
1041 visitChildren(dt);
1042 m_t << "</term></varlistentry>\n";
1043}

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

◆ operator()() [17/58]

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

Definition at line 1215 of file docbookvisitor.cpp.

1216{
1218 if (m_hide) return;
1219 m_t << "\n";
1220 auto summary = d.summary();
1221 if (summary)
1222 {
1223 std::visit(*this,*summary);
1224 }
1225 m_t << "<para>";
1226 visitChildren(d);
1227 m_t << "</para>";
1228 m_t << "\n";
1229}
const DocNodeVariant * summary() const
Definition docnode.h:864

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

◆ operator()() [18/58]

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

Definition at line 1231 of file docbookvisitor.cpp.

1232{
1234 if (m_hide) return;
1235 m_t << "<formalpara><title>";
1236 visitChildren(h);
1237 m_t << "</title></formalpara>\n";
1238}

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

◆ operator()() [19/58]

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

Definition at line 948 of file docbookvisitor.cpp.

949{
951 if (m_hide) return;
952 if (s.children().empty()) return;
953 // opening tag for ordered list will be handled in DocHtmlListItem
954 // due to (re-)numbering possibilities
955 if (s.type()!=DocHtmlList::Ordered)
956 m_t << "<itemizedlist>\n";
957 visitChildren(s);
958 if (s.type()==DocHtmlList::Ordered)
959 m_t << "</orderedlist>\n";
960 else
961 m_t << "</itemizedlist>\n";
962}
Type type() const
Definition docnode.h:1005
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/58]

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

Definition at line 964 of file docbookvisitor.cpp.

965{
967 if (m_hide) return;
968 const DocHtmlList *l = std::get_if<DocHtmlList>(s.parent());
969 if (l->type()==DocHtmlList::Ordered)
970 {
971 bool isFirst = &std::get<DocHtmlListItem>(l->children().front())==&s;
972 int value = 0;
973 QCString type;
974 for (const auto &opt : s.attribs())
975 {
976 if (opt.name=="value")
977 {
978 bool ok = false;
979 int val = opt.value.toInt(&ok);
980 if (ok) value = val;
981 }
982 }
983
984 if (value>0 || isFirst)
985 {
986 for (const auto &opt : l->attribs())
987 {
988 if (opt.name=="type")
989 {
990 if (opt.value=="1")
991 type = " numeration=\"arabic\"";
992 else if (opt.value=="a")
993 type = " numeration=\"loweralpha\"";
994 else if (opt.value=="A")
995 type = " numeration=\"upperalpha\"";
996 else if (opt.value=="i")
997 type = " numeration=\"lowerroman\"";
998 else if (opt.value=="I")
999 type = " numeration=\"upperroman\"";
1000 }
1001 else if (value==0 && opt.name=="start")
1002 {
1003 bool ok = false;
1004 int val = opt.value.toInt(&ok);
1005 if (ok) value = val;
1006 }
1007 }
1008 }
1009
1010 if (value>0 && !isFirst)
1011 {
1012 m_t << "</orderedlist>\n";
1013 }
1014 if (value>0 || isFirst)
1015 {
1016 m_t << "<orderedlist";
1017 if (!type.isEmpty()) m_t << type.data();
1018 if (value>0) m_t << " startingnumber=\"" << value << "\"";
1019 m_t << ">\n";
1020 }
1021 }
1022 m_t << "<listitem>\n";
1023 visitChildren(s);
1024 m_t << "</listitem>\n";
1025}
const HtmlAttribList & attribs() const
Definition docnode.h:1006
const HtmlAttribList & attribs() const
Definition docnode.h:1170
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:159

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/58]

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

Definition at line 1077 of file docbookvisitor.cpp.

1078{
1080 m_colCnt = 0;
1081 if (m_hide) return;
1082
1083 if (tr.isHeading())
1084 {
1085 if (m_bodySet.top()) m_t << "</tbody>\n";
1086 m_bodySet.top() = false;
1087 m_t << "<thead>\n";
1088 }
1089 else if (!m_bodySet.top())
1090 {
1091 m_bodySet.top() = true;
1092 m_t << "<tbody>\n";
1093 }
1094
1095 m_t << " <row ";
1096
1097 for (const auto &opt : tr.attribs())
1098 {
1099 if (supportedHtmlAttribute(opt.name))
1100 {
1101 // process supported attributes only
1102 m_t << " " << opt.name << "='" << convertToDocBook(opt.value) << "'";
1103 }
1104 }
1105 m_t << ">\n";
1106 visitChildren(tr);
1107 m_t << "</row>\n";
1108 if (tr.isHeading())
1109 {
1110 m_t << "</thead><tbody>\n";
1111 m_bodySet.top() = true;
1112 }
1113}
bool isHeading() const
Definition docnode.cpp:1922
const HtmlAttribList & attribs() const
Definition docnode.h:1252

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

◆ operator()() [22/58]

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

Definition at line 1206 of file docbookvisitor.cpp.

1207{
1209 if (m_hide) return;
1210 m_t << "<para><emphasis role=\"bold\">";
1211 visitChildren(s);
1212 m_t << "</emphasis></para>";
1213}

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

◆ operator()() [23/58]

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

Definition at line 1054 of file docbookvisitor.cpp.

1055{
1057 m_bodySet.push(false);
1058 if (m_hide) return;
1059 m_t << "<informaltable frame=\"all\">\n";
1060 m_t << " <tgroup cols=\"" << t.numColumns() << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n";
1061 for (uint32_t i = 0; i <t.numColumns(); i++)
1062 {
1063 // do something with colwidth based of cell width specification (be aware of possible colspan in the header)?
1064 m_t << " <colspec colname='c" << i+1 << "'/>\n";
1065 }
1066 if (t.caption())
1067 {
1068 std::visit(*this,*t.caption());
1069 }
1070 visitChildren(t);
1071 if (m_bodySet.top()) m_t << " </tbody>\n";
1072 m_bodySet.pop();
1073 m_t << " </tgroup>\n";
1074 m_t << "</informaltable>\n";
1075}
size_t numColumns() const
Definition docnode.h:1278
const DocNodeVariant * caption() const
Definition docnode.cpp:2141

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

◆ operator()() [24/58]

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

Definition at line 1240 of file docbookvisitor.cpp.

1241{
1243 if (img.type()==DocImage::DocBook)
1244 {
1245 if (m_hide) return;
1246 m_t << "\n";
1247 QCString baseName=makeShortName(img.name());
1248 visitPreStart(m_t, img.children(), img.hasCaption(), img.relPath() + baseName, img.width(), img.height(), img.isInlineImage());
1249 visitChildren(img);
1251 QCString file;
1252 bool ambig = false;
1253 FileDef *fd=findFileDef(Doxygen::imageNameLinkedMap, baseName, ambig);
1254 if (fd)
1255 {
1256 file=fd->absFilePath();
1257 }
1258 copyFile(file,Config_getString(DOCBOOK_OUTPUT)+"/"+baseName);
1259 }
1260 else // skip other formats
1261 {
1262 }
1263}
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:106
virtual QCString absFilePath() const =0
static QCString makeShortName(const QCString &baseName)
FileDef * findFileDef(const FileNameLinkedMap *fnMap, const QCString &n, bool &ambig)
Definition util.cpp:3416

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, makeShortName(), DocImage::name(), DocImage::relPath(), DocImage::type(), visitChildren(), visitPostEnd(), visitPreStart(), and DocImage::width().

◆ operator()() [25/58]

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

Definition at line 457 of file docbookvisitor.cpp.

458{
460 if (m_hide) return;
462 switch(inc.type())
463 {
465 {
466 m_t << "<literallayout><computeroutput>";
467 FileInfo cfi( inc.file().str() );
468 auto fd = createFileDef( cfi.dirPath(), cfi.fileName() );
470 inc.text(),
471 langExt,
472 inc.stripCodeComments(),
473 inc.isExample(),
474 inc.exampleFile(), fd.get());
475 m_t << "</computeroutput></literallayout>";
476 }
477 break;
479 m_t << "<literallayout><computeroutput>";
481 inc.text(),
482 langExt,
483 inc.stripCodeComments(),
484 inc.isExample(),
485 inc.exampleFile());
486 m_t << "</computeroutput></literallayout>";
487 break;
495 break;
497 m_t << inc.text();
498 break;
500 m_t << "<literallayout>";
501 filter(inc.text());
502 m_t << "</literallayout>";
503 break;
506 m_t << "<literallayout><computeroutput>";
508 inc.file(),
509 inc.blockId(),
510 inc.context(),
512 inc.trimLeft(),
514 );
515 m_t << "</computeroutput></literallayout>";
516 break;
517 }
518}
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, bool isExampleBlock, const QCString &exampleName=QCString(), const FileDef *fileDef=nullptr, int startLine=-1, int endLine=-1, bool inlineFragment=FALSE, const MemberDef *memberDef=nullptr, bool showLineNumbers=TRUE, const Definition *searchCtx=nullptr, bool collectXRefs=TRUE)=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:537
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:5718

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, DocInclude::Snippet, DocInclude::SnippetWithLines, QCString::str(), DocInclude::stripCodeComments(), DocInclude::text(), DocInclude::trimLeft(), DocInclude::type(), DocInclude::VerbInclude, and DocInclude::XmlInclude.

◆ operator()() [26/58]

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

Definition at line 520 of file docbookvisitor.cpp.

521{
523 if (op.isFirst())
524 {
525 if (!m_hide)
526 {
527 m_t << "<programlisting linenumbering=\"unnumbered\">";
528 }
530 m_hide = TRUE;
531 }
532 QCString locLangExt = getFileNameExtension(op.includeFileName());
533 if (locLangExt.isEmpty()) locLangExt = m_langExt;
534 SrcLangExt langExt = getLanguageFromFileName(locLangExt);
535 if (op.type()!=DocIncOperator::Skip)
536 {
537 m_hide = popHidden();
538 if (!m_hide)
539 {
540 std::unique_ptr<FileDef> fd;
541 if (!op.includeFileName().isEmpty())
542 {
543 FileInfo cfi( op.includeFileName().str() );
544 fd = createFileDef( cfi.dirPath(), cfi.fileName() );
545 }
546
547 getCodeParser(locLangExt).parseCode(m_ci,op.context(),
548 op.text(),langExt,
550 op.isExample(),
551 op.exampleFile(),
552 fd.get(), // fileDef
553 op.line(), // startLine
554 -1, // endLine
555 FALSE, // inline fragment
556 nullptr, // memberDef
557 op.showLineNo() // show line numbers
558 );
559 }
561 m_hide=TRUE;
562 }
563 if (op.isLast())
564 {
565 m_hide = popHidden();
566 if (!m_hide) m_t << "</programlisting>";
567 }
568 else
569 {
570 if (!m_hide) m_t << "\n";
571 }
572}
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
#define FALSE
Definition qcstring.h:34
QCString getFileNameExtension(const QCString &fn)
Definition util.cpp:5760

References DocIncOperator::context(), createFileDef(), DB_VIS_C, FileInfo::dirPath(), DocIncOperator::exampleFile(), FALSE, 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(), DocIncOperator::showLineNo(), DocIncOperator::Skip, QCString::str(), DocIncOperator::stripCodeComments(), DocIncOperator::text(), TRUE, and DocIncOperator::type().

◆ operator()() [27/58]

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

Definition at line 589 of file docbookvisitor.cpp.

590{
592 if (m_hide) return;
593 m_t << "<indexterm><primary>";
594 filter(ie.entry());
595 m_t << "</primary></indexterm>\n";
596}
QCString entry() const
Definition docnode.h:559

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

◆ operator()() [28/58]

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

Definition at line 1183 of file docbookvisitor.cpp.

1184{
1186 if (m_hide) return;
1187 visitChildren(i);
1188}

References DB_VIS_C, m_hide, and visitChildren().

◆ operator()() [29/58]

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

Definition at line 1483 of file docbookvisitor.cpp.

1484{
1486 if (m_hide) return;
1487 startLink(ref.file(),ref.anchor());
1488 visitChildren(ref);
1489 endLink();
1490 m_t << " ";
1491}
QCString file() const
Definition docnode.h:811
QCString anchor() const
Definition docnode.h:813

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

◆ operator()() [30/58]

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

Definition at line 262 of file docbookvisitor.cpp.

263{
265 if (m_hide) return;
266 m_t << "<?linebreak?>";
267 // gives nicer results but gives problems as it is not allowed in <pare> and also problems with dblatex
268 // m_t << "\n" << "<sbr/>\n";
269}

References DB_VIS_C, m_hide, and m_t.

◆ operator()() [31/58]

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

Definition at line 1305 of file docbookvisitor.cpp.

1306{
1308 if (m_hide) return;
1309 startLink(lnk.file(),lnk.anchor());
1310 visitChildren(lnk);
1311 endLink();
1312}

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

◆ operator()() [32/58]

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

Definition at line 197 of file docbookvisitor.cpp.

198{
200 if (m_hide) return;
201 startLink(w.file(),w.anchor());
202 filter(w.word());
203 endLink();
204}
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/58]

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

Definition at line 1275 of file docbookvisitor.cpp.

1276{
1278 if (m_hide) return;
1279 if (!Config_getBool(DOT_CLEANUP)) copyFile(df.file(),Config_getString(DOCBOOK_OUTPUT)+"/"+stripPath(df.file()));
1280 startMscFile(df.file(),df.relPath(),df.width(),df.height(),df.hasCaption(),df.children(),df.srcFile(),df.srcLine());
1281 visitChildren(df);
1282 endMscFile(df.hasCaption());
1283}
void startMscFile(const QCString &fileName, const QCString &relPath, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children, const QCString &srcFile, int srcLine)
void endMscFile(bool hasCaption)

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

◆ operator()() [34/58]

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

Definition at line 675 of file docbookvisitor.cpp.

676{
678 if (m_hide) return;
679 m_t << "\n";
680 m_t << "<para>";
681 visitChildren(p);
682 m_t << "</para>";
683 m_t << "\n";
684}

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

◆ operator()() [35/58]

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

Definition at line 1401 of file docbookvisitor.cpp.

1402{
1404 if (m_hide) return;
1405 m_t << " <row>\n";
1406
1407 const DocParamSect *sect = std::get_if<DocParamSect>(pl.parent());
1408 if (sect && sect->hasInOutSpecifier())
1409 {
1410 m_t << "<entry>";
1412 {
1413 if (pl.direction()==DocParamSect::In)
1414 {
1415 m_t << "in";
1416 }
1417 else if (pl.direction()==DocParamSect::Out)
1418 {
1419 m_t << "out";
1420 }
1421 else if (pl.direction()==DocParamSect::InOut)
1422 {
1423 m_t << "in,out";
1424 }
1425 }
1426 m_t << "</entry>";
1427 }
1428
1429 if (sect && sect->hasTypeSpecifier())
1430 {
1431 m_t << "<entry>";
1432 for (const auto &type : pl.paramTypes())
1433 {
1434 std::visit(*this,type);
1435 }
1436 m_t << "</entry>";
1437 }
1438
1439 if (pl.parameters().empty())
1440 {
1441 m_t << "<entry></entry>\n";
1442 }
1443 else
1444 {
1445 m_t << "<entry>";
1446 int cnt = 0;
1447 for (const auto &param : pl.parameters())
1448 {
1449 if (cnt)
1450 {
1451 m_t << ", ";
1452 }
1453 std::visit(*this,param);
1454 cnt++;
1455 }
1456 m_t << "</entry>";
1457 }
1458 m_t << "<entry>";
1459 for (const auto &par : pl.paragraphs())
1460 {
1461 std::visit(*this,par);
1462 }
1463 m_t << "</entry>\n";
1464 m_t << " </row>\n";
1465}
const DocNodeList & parameters() const
Definition docnode.h:1129
const DocNodeList & paramTypes() const
Definition docnode.h:1130
DocParamSect::Direction direction() const
Definition docnode.h:1133
const DocNodeList & paragraphs() const
Definition docnode.h:1131
bool hasInOutSpecifier() const
Definition docnode.h:1069
bool hasTypeSpecifier() const
Definition docnode.h:1070

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()() [36/58]

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

Definition at line 1351 of file docbookvisitor.cpp.

1352{
1354 if (m_hide) return;
1355 m_t << "\n";
1356 m_t << " <formalpara>\n";
1357 m_t << " <title>\n";
1358 switch(s.type())
1359 {
1364 default:
1365 ASSERT(0);
1366 }
1367 m_t << "</title>\n";
1368 m_t << " <para>\n";
1369 m_t << " <table frame=\"all\">\n";
1370 int ncols = 2;
1371 if (s.type() == DocParamSect::Param)
1372 {
1373 bool hasInOutSpecs = s.hasInOutSpecifier();
1374 bool hasTypeSpecs = s.hasTypeSpecifier();
1375 if (hasInOutSpecs && hasTypeSpecs) ncols += 2;
1376 else if (hasInOutSpecs || hasTypeSpecs) ncols += 1;
1377 }
1378 m_t << " <tgroup cols=\"" << ncols << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n";
1379 for (int i = 1; i <= ncols; i++)
1380 {
1381 if (i == ncols) m_t << " <colspec colwidth=\"4*\"/>\n";
1382 else m_t << " <colspec colwidth=\"1*\"/>\n";
1383 }
1384 m_t << " <tbody>\n";
1385 visitChildren(s);
1386 m_t << " </tbody>\n";
1387 m_t << " </tgroup>\n";
1388 m_t << " </table>\n";
1389 m_t << " </para>\n";
1390 m_t << " </formalpara>\n";
1391 m_t << " ";
1392}
Type type() const
Definition docnode.h:1068
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()() [37/58]

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

Definition at line 1515 of file docbookvisitor.cpp.

1516{
1518 if (m_hide) return;
1519 visitChildren(b);
1520}

References DB_VIS_C, m_hide, and visitChildren().

◆ operator()() [38/58]

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()() [39/58]

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

Definition at line 1314 of file docbookvisitor.cpp.

1315{
1317 if (m_hide) return;
1318 if (ref.isSubPage())
1319 {
1320 startLink(QCString(),ref.anchor());
1321 }
1322 else
1323 {
1324 if (!ref.file().isEmpty()) startLink(ref.file(),ref.anchor());
1325 }
1326
1327 if (!ref.hasLinkText()) filter(ref.targetTitle());
1328 visitChildren(ref);
1329 if (!ref.file().isEmpty()) endLink();
1330}
QCString anchor() const
Definition docnode.h:785
QCString targetTitle() const
Definition docnode.h:786
bool isSubPage() const
Definition docnode.h:792
QCString file() const
Definition docnode.h:782
bool hasLinkText() const
Definition docnode.h:788

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

◆ operator()() [40/58]

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

Definition at line 686 of file docbookvisitor.cpp.

687{
689 visitChildren(r);
690}

References DB_VIS_C, and visitChildren().

◆ operator()() [41/58]

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

Definition at line 1332 of file docbookvisitor.cpp.

1333{
1335 if (m_hide) return;
1336 //m_t << "<tocentry xml:idref=\"_" << stripPath(ref->file()) << "_1" << ref->anchor() << "\">";
1337 m_t << "<tocentry>";
1338 visitChildren(ref);
1339 m_t << "</tocentry>\n";
1340}

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

◆ operator()() [42/58]

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

Definition at line 1342 of file docbookvisitor.cpp.

1343{
1345 if (m_hide) return;
1346 m_t << "<toc>\n";
1347 visitChildren(l);
1348 m_t << "</toc>\n";
1349}

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

◆ operator()() [43/58]

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

Definition at line 933 of file docbookvisitor.cpp.

934{
936 if (m_hide) return;
937 m_t << "<section xml:id=\"_" << stripPath(s.file());
938 if (!s.anchor().isEmpty()) m_t << "_1" << s.anchor();
939 m_t << "\">\n";
940 if (s.title())
941 {
942 std::visit(*this,*s.title());
943 }
944 visitChildren(s);
945 m_t << "</section>\n";
946}
QCString file() const
Definition docnode.h:922
QCString anchor() const
Definition docnode.h:920
const DocNodeVariant * title() const
Definition docnode.h:919

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

◆ operator()() [44/58]

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

Definition at line 1394 of file docbookvisitor.cpp.

1395{
1397 if (m_hide) return;
1398 m_t << " " << sep.chars() << " ";
1399}
QCString chars() const
Definition docnode.h:369

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

◆ operator()() [45/58]

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

Definition at line 912 of file docbookvisitor.cpp.

913{
915 if (m_hide) return;
916 m_t << "<itemizedlist>\n";
917 visitChildren(l);
918 m_t << "</itemizedlist>\n";
919}

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

◆ operator()() [46/58]

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

Definition at line 921 of file docbookvisitor.cpp.

922{
924 if (m_hide) return;
925 m_t << "<listitem>";
926 if (li.paragraph())
927 {
928 visit(*this,*li.paragraph());
929 }
930 m_t << "</listitem>\n";
931}
const DocNodeVariant * paragraph() const
Definition docnode.h:1157

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

◆ operator()() [47/58]

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

Definition at line 692 of file docbookvisitor.cpp.

693{
695 if (m_hide) return;
696 switch(s.type())
697 {
699 if (m_insidePre)
700 {
701 m_t << "<formalpara><title>" << theTranslator->trSeeAlso() << "</title>\n";
702 }
703 else
704 {
705 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trSeeAlso()) << "</title>\n";
706 }
707 break;
709 if (m_insidePre)
710 {
711 m_t << "<formalpara><title>" << theTranslator->trReturns()<< "</title>\n";
712 }
713 else
714 {
715 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trReturns()) << "</title>\n";
716 }
717 break;
719 if (m_insidePre)
720 {
721 m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, TRUE) << "</title>\n";
722 }
723 else
724 {
725 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trAuthor(TRUE, TRUE)) << "</title>\n";
726 }
727 break;
729 if (m_insidePre)
730 {
731 m_t << "<formalpara><title>" << theTranslator->trAuthor(TRUE, FALSE) << "</title>\n";
732 }
733 else
734 {
735 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trAuthor(TRUE, FALSE)) << "</title>\n";
736 }
737 break;
739 if (m_insidePre)
740 {
741 m_t << "<formalpara><title>" << theTranslator->trVersion() << "</title>\n";
742 }
743 else
744 {
745 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trVersion()) << "</title>\n";
746 }
747 break;
749 if (m_insidePre)
750 {
751 m_t << "<formalpara><title>" << theTranslator->trSince() << "</title>\n";
752 }
753 else
754 {
755 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trSince()) << "</title>\n";
756 }
757 break;
759 if (m_insidePre)
760 {
761 m_t << "<formalpara><title>" << theTranslator->trDate() << "</title>\n";
762 }
763 else
764 {
765 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trDate()) << "</title>\n";
766 }
767 break;
769 if (m_insidePre)
770 {
771 m_t << "<note><title>" << theTranslator->trNote() << "</title>\n";
772 }
773 else
774 {
775 m_t << "<note><title>" << convertToDocBook(theTranslator->trNote()) << "</title>\n";
776 }
777 break;
779 if (m_insidePre)
780 {
781 m_t << "<warning><title>" << theTranslator->trWarning() << "</title>\n";
782 }
783 else
784 {
785 m_t << "<warning><title>" << convertToDocBook(theTranslator->trWarning()) << "</title>\n";
786 }
787 break;
789 if (m_insidePre)
790 {
791 m_t << "<formalpara><title>" << theTranslator->trPrecondition() << "</title>\n";
792 }
793 else
794 {
795 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trPrecondition()) << "</title>\n";
796 }
797 break;
799 if (m_insidePre)
800 {
801 m_t << "<formalpara><title>" << theTranslator->trPostcondition() << "</title>\n";
802 }
803 else
804 {
805 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trPostcondition()) << "</title>\n";
806 }
807 break;
809 if (m_insidePre)
810 {
811 m_t << "<formalpara><title>" << theTranslator->trCopyright() << "</title>\n";
812 }
813 else
814 {
815 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trCopyright()) << "</title>\n";
816 }
817 break;
819 if (m_insidePre)
820 {
821 m_t << "<formalpara><title>" << theTranslator->trInvariant() << "</title>\n";
822 }
823 else
824 {
825 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trInvariant()) << "</title>\n";
826 }
827 break;
829 // <remark> is miising the <title> possibility
830 if (m_insidePre)
831 {
832 m_t << "<formalpara><title>" << theTranslator->trRemarks() << "</title>\n";
833 }
834 else
835 {
836 m_t << "<formalpara><title>" << convertToDocBook(theTranslator->trRemarks()) << "</title>\n";
837 }
838 break;
840 if (m_insidePre)
841 {
842 m_t << "<caution><title>" << theTranslator->trAttention() << "</title>\n";
843 }
844 else
845 {
846 m_t << "<caution><title>" << convertToDocBook(theTranslator->trAttention()) << "</title>\n";
847 }
848 break;
850 if (m_insidePre)
851 {
852 m_t << "<important><title>" << theTranslator->trImportant() << "</title>\n";
853 }
854 else
855 {
856 m_t << "<important><title>" << convertToDocBook(theTranslator->trImportant()) << "</title>\n";
857 }
858 break;
862 if (s.hasTitle())
863 m_t << "<formalpara>\n";
864 else
865 m_t << "<para>\n";
866 break;
867 }
868
869 if (s.title())
870 {
871 std::visit(*this,*s.title());
872 }
873 visitChildren(s);
874
875 switch(s.type())
876 {
880 if (s.hasTitle())
881 m_t << "</formalpara>\n";
882 else
883 m_t << "</para>\n";
884 break;
886 m_t << "</note>\n";
887 break;
889 m_t << "</caution>\n";
890 break;
892 m_t << "</important>\n";
893 break;
895 m_t << "</warning>\n";
896 break;
897 default:
898 m_t << "</formalpara>\n";
899 break;
900 }
901}
Type type() const
Definition docnode.h:1026
const DocNodeVariant * title() const
Definition docnode.h:1033
bool hasTitle() const
Definition docnode.cpp:3014
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

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()() [48/58]

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

Definition at line 598 of file docbookvisitor.cpp.

599{
601 // m_t << "<simplesect/>";
602}

References DB_VIS_C.

◆ operator()() [49/58]

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

Definition at line 279 of file docbookvisitor.cpp.

280{
282 if (m_hide) return;
283 switch (s.style())
284 {
286 if (s.enable()) m_t << "<emphasis role=\"bold\">"; else m_t << "</emphasis>";
287 break;
289 if (s.enable()) m_t << "<emphasis>"; else m_t << "</emphasis>";
290 break;
294 if (s.enable()) m_t << "<computeroutput>"; else m_t << "</computeroutput>";
295 break;
297 if (s.enable()) m_t << "<subscript>"; else m_t << "</subscript>";
298 break;
300 if (s.enable()) m_t << "<superscript>"; else m_t << "</superscript>";
301 break;
303 if (s.enable()) m_t << "<informaltable frame='none'><tgroup cols='1'><colspec align='center'/><tbody><row><entry align='center'>";
304 else m_t << "</entry></row></tbody></tgroup></informaltable>";
305 break;
307 if (s.enable())
308 {
309 m_t << "<literallayout>";
311 }
312 else
313 {
314 m_t << "</literallayout>";
316 }
317 break;
318 /* There is no equivalent Docbook tag for rendering Small text */
319 case DocStyleChange::Small: /* XSLT Stylesheets can be used */ break;
320 /* HTML only */
321 case DocStyleChange::Cite: break;
322 case DocStyleChange::S: break;
323 case DocStyleChange::Strike: break;
324 case DocStyleChange::Del: break;
325 case DocStyleChange::Underline: break;
326 case DocStyleChange::Ins: break;
327 case DocStyleChange::Div: /* HTML only */ break;
328 case DocStyleChange::Span: /* HTML only */ break;
329 }
330}
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()() [50/58]

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

Definition at line 220 of file docbookvisitor.cpp.

221{
223 if (m_hide) return;
224 const char *res = HtmlEntityMapper::instance().docbook(s.symbol());
225 if (res)
226 {
227 m_t << res;
228 }
229 else
230 {
231 err("DocBook: non supported HTML-entity found: {}\n",HtmlEntityMapper::instance().html(s.symbol(),TRUE));
232 }
233}
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()() [51/58]

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

Definition at line 1493 of file docbookvisitor.cpp.

1494{
1496 visitChildren(t);
1497}

References DB_VIS_C, and visitChildren().

◆ operator()() [52/58]

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

Definition at line 903 of file docbookvisitor.cpp.

904{
906 if (m_hide) return;
907 if (t.hasTitle()) m_t << "<title>";
908 visitChildren(t);
909 if (t.hasTitle()) m_t << "</title>";
910}
bool hasTitle() const
Definition docnode.h:613

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

◆ operator()() [53/58]

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

Definition at line 250 of file docbookvisitor.cpp.

251{
253 if (m_hide) return;
254 m_t << "<link xlink:href=\"";
255 if (u.isEmail()) m_t << "mailto:";
256 filter(u.url());
257 m_t << "\">";
258 filter(u.url());
259 m_t << "</link>";
260}
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()() [54/58]

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

Definition at line 332 of file docbookvisitor.cpp.

333{
335 if (m_hide) return;
336 QCString lang = m_langExt;
337 if (!s.language().isEmpty()) // explicit language setting
338 {
339 lang = s.language();
340 }
341 SrcLangExt langExt = getLanguageFromCodeLang(lang);
342 switch(s.type())
343 {
345 m_t << "<literallayout><computeroutput>";
347 s.text(),
348 langExt,
349 Config_getBool(STRIP_CODE_COMMENTS),
350 s.isExample(),
351 s.exampleFile());
352 m_t << "</computeroutput></literallayout>";
353 break;
355 m_t << "<literallayout><computeroutput>";
356 filter(s.text());
357 m_t << "</computeroutput></literallayout>";
358 break;
360 filter(s.text(), true);
361 break;
363 m_t << "<computeroutput>";
364 filter(s.text(), true);
365 m_t << "</computeroutput>";
366 break;
368 break;
370 break;
372 break;
374 break;
376 break;
378 m_t << s.text();
379 break;
380 case DocVerbatim::Dot:
381 {
382 static int dotindex = 1;
383 QCString baseName(4096, QCString::ExplicitSize);
384 QCString name;
385 QCString stext = s.text();
386 m_t << "<para>\n";
387 name.sprintf("%s%d", "dot_inline_dotgraph_", dotindex);
388 baseName.sprintf("%s%d",
389 qPrint(Config_getString(DOCBOOK_OUTPUT)+"/inline_dotgraph_"),
390 dotindex++
391 );
392 QCString fileName = baseName+".dot";
393 std::ofstream file = Portable::openOutputStream(fileName);
394 if (!file.is_open())
395 {
396 err("Could not open file {} for writing\n",fileName);
397 }
398 file.write( stext.data(), stext.length() );
399 file.close();
400 writeDotFile(baseName, s);
401 m_t << "</para>\n";
402 if (Config_getBool(DOT_CLEANUP)) Dir().remove(fileName.str());
403 }
404 break;
405 case DocVerbatim::Msc:
406 {
407 static int mscindex = 1;
408 QCString baseName(4096, QCString::ExplicitSize);
409 QCString name;
410 QCString stext = s.text();
411 m_t << "<para>\n";
412 name.sprintf("%s%d", "msc_inline_mscgraph_", mscindex);
413 baseName.sprintf("%s%d",
414 (Config_getString(DOCBOOK_OUTPUT)+"/inline_mscgraph_").data(),
415 mscindex++
416 );
417 QCString fileName = baseName+".msc";
418 std::ofstream file = Portable::openOutputStream(fileName);
419 if (!file.is_open())
420 {
421 err("Could not open file {} for writing\n",fileName);
422 }
423 QCString text = "msc {";
424 text+=stext;
425 text+="}";
426 file.write( text.data(), text.length() );
427 file.close();
428 writeMscFile(baseName,s);
429 m_t << "</para>\n";
430 if (Config_getBool(DOT_CLEANUP)) Dir().remove(fileName.str());
431 }
432 break;
434 {
435 QCString docbookOutput = Config_getString(DOCBOOK_OUTPUT);
436 auto baseNameVector = PlantumlManager::instance().writePlantUMLSource(docbookOutput,
438 s.engine(),s.srcFile(),s.srcLine(),true);
439 for (const auto &baseName: baseNameVector)
440 {
441 m_t << "<para>\n";
442 writePlantUMLFile(QCString(baseName),s);
443 m_t << "</para>\n";
444 }
445 }
446 break;
447 }
448}
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 writeDotFile(const QCString &fileName, const DocVerbatim &s)
void writeMscFile(const QCString &fileName, const DocVerbatim &s)
void writePlantUMLFile(const QCString &fileName, const DocVerbatim &s)
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
size_t length() const
Returns the length of the string, not counting the 0-terminator.
Definition qcstring.h:153
QCString & sprintf(const char *format,...)
Definition qcstring.cpp:29
@ ExplicitSize
Definition qcstring.h:133
std::ofstream openOutputStream(const QCString &name, bool append=false)
Definition portable.cpp:665
const char * qPrint(const char *s)
Definition qcstring.h:672
SrcLangExt getLanguageFromCodeLang(QCString &fileName)
Routine to handle the language attribute of the \code command.
Definition util.cpp:5736

References DocVerbatim::Code, Config_getBool, Config_getString, DocVerbatim::context(), QCString::data(), DB_VIS_C, DocVerbatim::DocbookOnly, DocVerbatim::Dot, DocVerbatim::engine(), err, DocVerbatim::exampleFile(), QCString::ExplicitSize, filter(), DocVisitor::getCodeParser(), getLanguageFromCodeLang(), DocVerbatim::HtmlOnly, PlantumlManager::instance(), QCString::isEmpty(), DocVerbatim::isExample(), DocVerbatim::JavaDocCode, DocVerbatim::JavaDocLiteral, DocVerbatim::language(), DocVerbatim::LatexOnly, QCString::length(), m_ci, m_hide, m_langExt, m_t, DocVerbatim::ManOnly, DocVerbatim::Msc, Portable::openOutputStream(), CodeParserInterface::parseCode(), DocVerbatim::PlantUML, PlantumlManager::PUML_BITMAP, qPrint(), Dir::remove(), DocVerbatim::RtfOnly, QCString::sprintf(), DocVerbatim::srcFile(), DocVerbatim::srcLine(), QCString::str(), DocVerbatim::text(), DocVerbatim::type(), DocVerbatim::Verbatim, writeDotFile(), writeMscFile(), writePlantUMLFile(), PlantumlManager::writePlantUMLSource(), and DocVerbatim::XmlOnly.

◆ operator()() [55/58]

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

Definition at line 1509 of file docbookvisitor.cpp.

1510{
1512 // TODO: to be implemented
1513}

References DB_VIS_C.

◆ operator()() [56/58]

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

Definition at line 206 of file docbookvisitor.cpp.

207{
209 if (m_hide) return;
210 if (m_insidePre)
211 {
212 m_t << w.chars();
213 }
214 else
215 {
216 m_t << " ";
217 }
218}
QCString chars() const
Definition docnode.h:358

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

◆ operator()() [57/58]

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

Definition at line 190 of file docbookvisitor.cpp.

191{
193 if (m_hide) return;
194 filter(w.word());
195}
QCString word() const
Definition docnode.h:156

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

◆ operator()() [58/58]

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

Definition at line 1467 of file docbookvisitor.cpp.

1468{
1470 if (m_hide) return;
1471 if (x.title().isEmpty()) return;
1472 m_t << "<para><link linkend=\"_";
1473 m_t << stripPath(x.file()) << "_1" << x.anchor();
1474 m_t << "\">";
1475 filter(x.title());
1476 m_t << "</link>";
1477 m_t << " ";
1478 visitChildren(x);
1479 if (x.title().isEmpty()) return;
1480 m_t << "</para>";
1481}
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 )
private

Definition at line 1643 of file docbookvisitor.cpp.

1652{
1654 QCString baseName=makeBaseName(fileName);
1655 baseName.prepend("dia_");
1656 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1657 writeDiaGraphFromFile(fileName,outDir,baseName,DiaOutputFormat::BITMAP,srcFile,srcLine);
1658 m_t << "<para>\n";
1659 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1660}
void writeDiaGraphFromFile(const QCString &inFile, const QCString &outDir, const QCString &outFile, DiaOutputFormat format, const QCString &srcFile, int srcLine)
Definition dia.cpp:26
static QCString makeBaseName(const QCString &name)

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 )
private

Definition at line 1681 of file docbookvisitor.cpp.

1690{
1692 QCString baseName=makeBaseName(fileName);
1693 baseName.prepend("dot_");
1694 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1695 QCString imgExt = getDotImageExtension();
1696 writeDotGraphFromFile(fileName,outDir,baseName,GraphOutputFormat::BITMAP,srcFile,srcLine);
1697 m_t << "<para>\n";
1698 visitPreStart(m_t, children, hasCaption, relPath + baseName + "." + imgExt, width, height);
1699}
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:6800

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

1530{
1532 m_t << "<link linkend=\"_" << stripPath(file);
1533 if (!anchor.isEmpty())
1534 {
1535 if (!file.isEmpty()) m_t << "_1";
1536 m_t << anchor;
1537 }
1538 m_t << "\">";
1539}

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

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), and 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 )
private

Definition at line 1605 of file docbookvisitor.cpp.

1614{
1616 QCString baseName=makeBaseName(fileName);
1617 baseName.prepend("msc_");
1618 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1619 writeMscGraphFromFile(fileName,outDir,baseName,MscOutputFormat::BITMAP,srcFile,srcLine);
1620 m_t << "<para>\n";
1621 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1622}
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 1568 of file docbookvisitor.cpp.

1577{
1579 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1580 std::string inBuf;
1581 readInputFile(fileName,inBuf);
1582 auto baseNameVector = PlantumlManager::instance().writePlantUMLSource(outDir,
1583 QCString(),inBuf.c_str(),PlantumlManager::PUML_BITMAP,QCString(),srcFile,srcLine,false);
1584 bool first = true;
1585 for (const auto &bName: baseNameVector)
1586 {
1587 QCString baseName=makeBaseName(QCString(bName));
1589 if (!first) endPlantUmlFile(hasCaption);
1590 first = false;
1591 m_t << "<para>\n";
1592 visitPreStart(m_t, children, hasCaption, relPath + baseName + ".png", width, height);
1593 }
1594}
void generatePlantUMLOutput(const QCString &baseName, const QCString &outDir, OutputFormat format)
Convert a PlantUML file to an image.
Definition plantuml.cpp:202
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:6047

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

111{
112 for (const auto &n : children)
113 {
114 std::visit(*this,n);
115 }
116}

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

◆ visitChildren()

◆ visitPostEnd()

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

Definition at line 161 of file docbookvisitor.cpp.

162{
163 t << "\n";
164 if (hasCaption && !inlineImage)
165 {
166 t << " -->\n"; // Needed for general formatting with title for other formats
167 }
168 t << " </mediaobject>\n";
169 if (hasCaption && !inlineImage)
170 {
171 t << " </figure>\n";
172 }
173 else
174 {
175 t << " </informalfigure>\n";
176 }
177}

Referenced by endDiaFile(), endDotFile(), endMscFile(), endPlantUmlFile(), operator()(), writeDiaFile(), writeDotFile(), 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 118 of file docbookvisitor.cpp.

125{
126 if (hasCaption && !inlineImage)
127 {
128 t << " <figure>\n";
129 t << " <title>\n";
130 visitCaption(children);
131 t << " </title>\n";
132 }
133 else
134 {
135 t << " <informalfigure>\n";
136 }
137 t << " <mediaobject>\n";
138 t << " <imageobject>\n";
139 t << " <imagedata";
140 if (!width.isEmpty())
141 {
142 t << " width=\"" << convertToDocBook(width) << "\"";
143 }
144 else
145 {
146 if (!height.isEmpty() && !inlineImage) t << " width=\"50%\"";
147 }
148 if (!height.isEmpty())
149 {
150 t << " depth=\"" << convertToDocBook(height) << "\"";
151 }
152 t << " align=\"center\" valign=\"middle\" scalefit=\"0\" fileref=\"" << name << "\">";
153 t << "</imagedata>\n";
154 t << " </imageobject>\n";
155 if (hasCaption && !inlineImage)
156 {
157 t << " <!--\n"; // Needed for general formatting with title for other formats
158 }
159}
void visitCaption(const DocNodeList &children)

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

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

◆ writeDiaFile()

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

Definition at line 1632 of file docbookvisitor.cpp.

1633{
1635 QCString shortName = makeShortName(baseName);
1636 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1637 writeDiaGraphFromFile(baseName+".dia",outDir,shortName,DiaOutputFormat::BITMAP,s.srcFile(),s.srcLine());
1638 visitPreStart(m_t, s.children(), s.hasCaption(), shortName, s.width(),s.height());
1641}
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, makeShortName(), DocVerbatim::srcFile(), DocVerbatim::srcLine(), visitCaption(), visitPostEnd(), visitPreStart(), DocVerbatim::width(), and writeDiaGraphFromFile().

◆ writeDotFile()

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

◆ writeMscFile()

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

Definition at line 1547 of file docbookvisitor.cpp.

1548{
1550 QCString shortName = makeShortName(baseName);
1551 QCString outDir = Config_getString(DOCBOOK_OUTPUT);
1552 writeMscGraphFromFile(baseName+".msc",outDir,shortName,MscOutputFormat::BITMAP,s.srcFile(),s.srcLine());
1553 visitPreStart(m_t, s.children(), s.hasCaption(), s.relPath() + shortName + ".png", s.width(), s.height());
1556}

References BITMAP, DocVerbatim::children(), Config_getString, DB_VIS_C, DocVerbatim::hasCaption(), DocVerbatim::height(), m_t, makeShortName(), 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 156 of file docbookvisitor.h.

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

◆ m_ci

OutputCodeList& DocbookDocVisitor::m_ci
private

Definition at line 150 of file docbookvisitor.h.

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

◆ m_colCnt

int DocbookDocVisitor::m_colCnt = 0
private

Definition at line 155 of file docbookvisitor.h.

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

◆ m_enabled

BoolStack DocbookDocVisitor::m_enabled
private

Definition at line 153 of file docbookvisitor.h.

◆ m_hide

◆ m_insidePre

bool DocbookDocVisitor::m_insidePre = false
private

Definition at line 151 of file docbookvisitor.h.

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

◆ m_langExt

QCString DocbookDocVisitor::m_langExt
private

Definition at line 154 of file docbookvisitor.h.

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

◆ m_t


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