/****************************************************************************** * * Copyright (C) 1997-2020 by Dimitri van Heesch. * * Permission to use, copy, modify, and distribute this software and its * documentation under the terms of the GNU General Public License is hereby * granted. No representations are made about the suitability of this software * for any purpose. It is provided "as is" without express or implied warranty. * See the GNU General Public License for more details. * * Documents produced by Doxygen are derivative works derived from the * input used in their production; they are not affected by this license. * */ #include #include "docbookvisitor.h" #include "docparser.h" #include "language.h" #include "doxygen.h" #include "outputgen.h" #include "docbookgen.h" #include "dot.h" #include "message.h" #include "util.h" #include "parserintf.h" #include "filename.h" #include "config.h" #include "filedef.h" #include "msc.h" #include "dia.h" #include "htmlentity.h" #include "emoji.h" #include "plantuml.h" #include "growbuf.h" #include "fileinfo.h" #if 0 #define DB_VIS_C DB_VIS_C1(m_t) #define DB_VIS_C1(x) x << "\n"; #define DB_VIS_C2(y) DB_VIS_C2a(m_t,y) #define DB_VIS_C2a(x,y) x << "\n"; #else #define DB_VIS_C #define DB_VIS_C1(x) #define DB_VIS_C2(y) #define DB_VIS_C2a(x,y) #endif static QCString filterId(const char *s) { static GrowBuf growBuf; growBuf.clear(); if (s==0) return ""; const char *p=s; char c; while ((c=*p++)) { switch (c) { case ':': growBuf.addStr("_1"); break; default: growBuf.addChar(c); break; } } growBuf.addChar(0); return growBuf.get(); } static bool supportedHtmlAttribute(const QCString &name) { return (name=="align" || name=="bgcolor" || name=="border" || name=="cellpadding" || name=="cellspacing" || name=="class" || name=="frame" || name=="label" || name=="style" || name=="width" || name=="tabstyle" || name=="title"); } void DocbookDocVisitor::visitCaption(const DocNodeList &children) { for (const auto &n : children) n->accept(this); } void DocbookDocVisitor::visitPreStart(TextStream &t, const DocNodeList &children, bool hasCaption, const QCString &name, const QCString &width, const QCString &height, bool inlineImage) { if (hasCaption && !inlineImage) { t << "
\n"; t << " \n"; visitCaption(children); t << " \n"; } else { t << " \n"; } t << " \n"; t << " \n"; t << " "; t << "\n"; t << " \n"; if (hasCaption && !inlineImage) { t << " \n"; // Needed for general formatting with title for other formats } t << " \n"; if (hasCaption && !inlineImage) { t << "
\n"; } else { t << " \n"; } } DocbookDocVisitor::DocbookDocVisitor(TextStream &t,CodeOutputInterface &ci,const char *langExt) : DocVisitor(DocVisitor_Docbook), m_t(t), m_ci(ci),m_langExt(langExt) { DB_VIS_C // m_t << "
\n"; } DocbookDocVisitor::~DocbookDocVisitor() { DB_VIS_C // m_t << "
\n"; } //-------------------------------------- // visitor functions for leaf nodes //-------------------------------------- void DocbookDocVisitor::visit(DocWord *w) { DB_VIS_C if (m_hide) return; filter(w->word()); } void DocbookDocVisitor::visit(DocLinkedWord *w) { DB_VIS_C if (m_hide) return; startLink(w->file(),w->anchor()); filter(w->word()); endLink(); } void DocbookDocVisitor::visit(DocWhiteSpace *w) { DB_VIS_C if (m_hide) return; if (m_insidePre) { m_t << w->chars(); } else { m_t << " "; } } void DocbookDocVisitor::visit(DocSymbol *s) { DB_VIS_C if (m_hide) return; const char *res = HtmlEntityMapper::instance()->docbook(s->symbol()); if (res) { m_t << res; } else { err("DocBook: non supported HTML-entity found: %s\n",HtmlEntityMapper::instance()->html(s->symbol(),TRUE)); } } void DocbookDocVisitor::visit(DocEmoji *s) { DB_VIS_C if (m_hide) return; const char *res = EmojiEntityMapper::instance()->unicode(s->index()); if (res) { m_t << res; } else { m_t << s->name(); } } void DocbookDocVisitor::visit(DocURL *u) { DB_VIS_C if (m_hide) return; m_t << "isEmail()) m_t << "mailto:"; filter(u->url()); m_t << "\">"; filter(u->url()); m_t << ""; } void DocbookDocVisitor::visit(DocLineBreak *) { DB_VIS_C if (m_hide) return; m_t << "\n  \n"; // gives nicer results but gives problems as it is not allowed in and also problems with dblatex // m_t << "\n" << "\n"; } void DocbookDocVisitor::visit(DocHorRuler *) { DB_VIS_C if (m_hide) return; m_t << "\n"; m_t << "\n"; } void DocbookDocVisitor::visit(DocStyleChange *s) { DB_VIS_C if (m_hide) return; switch (s->style()) { case DocStyleChange::Bold: if (s->enable()) m_t << ""; else m_t << ""; break; case DocStyleChange::Italic: if (s->enable()) m_t << ""; else m_t << ""; break; case DocStyleChange::Code: if (s->enable()) m_t << ""; else m_t << ""; break; case DocStyleChange::Subscript: if (s->enable()) m_t << ""; else m_t << ""; break; case DocStyleChange::Superscript: if (s->enable()) m_t << ""; else m_t << ""; break; case DocStyleChange::Center: if (s->enable()) m_t << ""; else m_t << ""; break; case DocStyleChange::Preformatted: if (s->enable()) { m_t << ""; m_insidePre=TRUE; } else { m_t << ""; m_insidePre=FALSE; } break; /* There is no equivalent Docbook tag for rendering Small text */ case DocStyleChange::Small: /* XSLT Stylesheets can be used */ break; /* HTML only */ case DocStyleChange::S: break; case DocStyleChange::Strike: break; case DocStyleChange::Del: break; case DocStyleChange::Underline: break; case DocStyleChange::Ins: break; case DocStyleChange::Div: /* HTML only */ break; case DocStyleChange::Span: /* HTML only */ break; } } void DocbookDocVisitor::visit(DocVerbatim *s) { DB_VIS_C if (m_hide) return; SrcLangExt langExt = getLanguageFromFileName(m_langExt); switch(s->type()) { case DocVerbatim::Code: // fall though m_t << ""; getCodeParser(m_langExt).parseCode(m_ci,s->context(), s->text(), langExt, s->isExample(), s->exampleFile()); m_t << ""; break; case DocVerbatim::Verbatim: m_t << ""; filter(s->text()); m_t << ""; break; case DocVerbatim::HtmlOnly: break; case DocVerbatim::RtfOnly: break; case DocVerbatim::ManOnly: break; case DocVerbatim::LatexOnly: break; case DocVerbatim::XmlOnly: break; case DocVerbatim::DocbookOnly: m_t << s->text(); break; case DocVerbatim::Dot: { static int dotindex = 1; QCString baseName(4096); QCString name; QCString stext = s->text(); m_t << "\n"; name.sprintf("%s%d", "dot_inline_dotgraph_", dotindex); baseName.sprintf("%s%d", (Config_getString(DOCBOOK_OUTPUT)+"/inline_dotgraph_").data(), dotindex++ ); std::string fileName = baseName.str()+".dot"; std::ofstream file(fileName,std::ofstream::out | std::ofstream::binary); if (!file.is_open()) { err("Could not open file %s for writing\n",fileName.c_str()); } file.write( stext.data(), stext.length() ); file.close(); writeDotFile(baseName, s); m_t << "\n"; if (Config_getBool(DOT_CLEANUP)) Dir().remove(fileName); } break; case DocVerbatim::Msc: { static int mscindex = 1; QCString baseName(4096); QCString name; QCString stext = s->text(); m_t << "\n"; name.sprintf("%s%d", "msc_inline_mscgraph_", mscindex); baseName.sprintf("%s%d", (Config_getString(DOCBOOK_OUTPUT)+"/inline_mscgraph_").data(), mscindex++ ); std::string fileName = baseName.str()+".msc"; std::ofstream file(fileName,std::ofstream::out | std::ofstream::binary); if (!file.is_open()) { err("Could not open file %s for writing\n",fileName.c_str()); } QCString text = "msc {"; text+=stext; text+="}"; file.write( text.data(), text.length() ); file.close(); writeMscFile(baseName,s); m_t << "\n"; if (Config_getBool(DOT_CLEANUP)) Dir().remove(fileName); } break; case DocVerbatim::PlantUML: { static QCString docbookOutput = Config_getString(DOCBOOK_OUTPUT); QCString baseName = PlantumlManager::instance().writePlantUMLSource(docbookOutput,s->exampleFile(),s->text(),PlantumlManager::PUML_BITMAP); QCString shortName = baseName; int i; if ((i=shortName.findRev('/'))!=-1) { shortName=shortName.right((int)shortName.length()-i-1); } m_t << "\n"; writePlantUMLFile(baseName,s); m_t << "\n"; } break; } } void DocbookDocVisitor::visit(DocAnchor *anc) { DB_VIS_C if (m_hide) return; m_t << "file()) << "_1" << filterId(anc->anchor()) << "\"/>"; } void DocbookDocVisitor::visit(DocInclude *inc) { DB_VIS_C if (m_hide) return; SrcLangExt langExt = getLanguageFromFileName(inc->extension()); switch(inc->type()) { case DocInclude::IncWithLines: { m_t << ""; FileInfo cfi( inc->file().str() ); FileDef *fd = createFileDef( cfi.dirPath(), cfi.fileName() ); getCodeParser(inc->extension()).parseCode(m_ci,inc->context(), inc->text(), langExt, inc->isExample(), inc->exampleFile(), fd); delete fd; m_t << ""; } break; case DocInclude::Include: m_t << ""; getCodeParser(inc->extension()).parseCode(m_ci,inc->context(), inc->text(), langExt, inc->isExample(), inc->exampleFile()); m_t << ""; break; case DocInclude::DontInclude: case DocInclude::DontIncWithLines: case DocInclude::HtmlInclude: case DocInclude::LatexInclude: case DocInclude::RtfInclude: case DocInclude::ManInclude: case DocInclude::XmlInclude: break; case DocInclude::DocbookInclude: m_t << inc->text(); break; case DocInclude::VerbInclude: m_t << ""; filter(inc->text()); m_t << ""; break; case DocInclude::Snippet: m_t << ""; getCodeParser(inc->extension()).parseCode(m_ci, inc->context(), extractBlock(inc->text(),inc->blockId()), langExt, inc->isExample(), inc->exampleFile() ); m_t << ""; break; case DocInclude::SnipWithLines: { FileInfo cfi( inc->file().str() ); FileDef *fd = createFileDef( cfi.dirPath(), cfi.fileName() ); m_t << ""; getCodeParser(inc->extension()).parseCode(m_ci, inc->context(), extractBlock(inc->text(),inc->blockId()), langExt, inc->isExample(), inc->exampleFile(), fd, lineBlock(inc->text(),inc->blockId()), -1, // endLine FALSE, // inlineFragment 0, // memberDef TRUE // show line number ); delete fd; m_t << ""; } break; case DocInclude::SnippetDoc: case DocInclude::IncludeDoc: err("Internal inconsistency: found switch SnippetDoc / IncludeDoc in file: %s" "Please create a bug report\n",__FILE__); break; } } void DocbookDocVisitor::visit(DocIncOperator *op) { DB_VIS_C if (op->isFirst()) { if (!m_hide) { m_t << ""; } pushHidden(m_hide); m_hide = TRUE; } QCString locLangExt = getFileNameExtension(op->includeFileName()); if (locLangExt.isEmpty()) locLangExt = m_langExt; SrcLangExt langExt = getLanguageFromFileName(locLangExt); if (op->type()!=DocIncOperator::Skip) { m_hide = popHidden(); if (!m_hide) { FileDef *fd = 0; if (!op->includeFileName().isEmpty()) { FileInfo cfi( op->includeFileName().str() ); fd = createFileDef( cfi.dirPath(), cfi.fileName() ); } getCodeParser(locLangExt).parseCode(m_ci,op->context(), op->text(),langExt,op->isExample(), op->exampleFile(), fd, // fileDef op->line(), // startLine -1, // endLine FALSE, // inline fragment 0, // memberDef op->showLineNo() // show line numbers ); if (fd) delete fd; } pushHidden(m_hide); m_hide=TRUE; } if (op->isLast()) { m_hide = popHidden(); if (!m_hide) m_t << ""; } else { if (!m_hide) m_t << "\n"; } } void DocbookDocVisitor::visit(DocFormula *f) { DB_VIS_C if (m_hide) return; if (f->isInline()) m_t << "\n"; else m_t << " \n"; m_t << " \n"; m_t << " relPath() << f->name() << ".png\"/>\n"; m_t << " \n"; if (f->isInline()) m_t << "\n"; else m_t << " \n"; } void DocbookDocVisitor::visit(DocIndexEntry *ie) { DB_VIS_C if (m_hide) return; m_t << ""; filter(ie->entry()); m_t << "\n"; } void DocbookDocVisitor::visit(DocSimpleSectSep *) { DB_VIS_C // m_t << ""; } void DocbookDocVisitor::visit(DocCite *cite) { DB_VIS_C if (m_hide) return; if (!cite->file().isEmpty()) startLink(cite->file(),filterId(cite->anchor())); filter(cite->text()); if (!cite->file().isEmpty()) endLink(); } //-------------------------------------- // visitor functions for compound nodes //-------------------------------------- void DocbookDocVisitor::visitPre(DocAutoList *l) { DB_VIS_C if (m_hide) return; if (l->isEnumList()) { m_t << "\n"; } else { m_t << "\n"; } } void DocbookDocVisitor::visitPost(DocAutoList *l) { DB_VIS_C if (m_hide) return; if (l->isEnumList()) { m_t << "\n"; } else { m_t << "\n"; } } void DocbookDocVisitor::visitPre(DocAutoListItem *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPost(DocAutoListItem *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPre(DocPara *) { DB_VIS_C if (m_hide) return; m_t << "\n"; m_t << ""; } void DocbookDocVisitor::visitPost(DocPara *) { DB_VIS_C if (m_hide) return; m_t << ""; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocRoot *) { DB_VIS_C //m_t << "

New parser:

\n"; } void DocbookDocVisitor::visitPost(DocRoot *) { DB_VIS_C //m_t << "

Old parser:

\n"; } void DocbookDocVisitor::visitPre(DocSimpleSect *s) { DB_VIS_C if (m_hide) return; switch(s->type()) { case DocSimpleSect::See: if (m_insidePre) { m_t << "" << theTranslator->trSeeAlso() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trSeeAlso()) << "\n"; } break; case DocSimpleSect::Return: if (m_insidePre) { m_t << "" << theTranslator->trReturns()<< "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trReturns()) << "\n"; } break; case DocSimpleSect::Author: if (m_insidePre) { m_t << "" << theTranslator->trAuthor(TRUE, TRUE) << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trAuthor(TRUE, TRUE)) << "\n"; } break; case DocSimpleSect::Authors: if (m_insidePre) { m_t << "" << theTranslator->trAuthor(TRUE, FALSE) << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trAuthor(TRUE, FALSE)) << "\n"; } break; case DocSimpleSect::Version: if (m_insidePre) { m_t << "" << theTranslator->trVersion() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trVersion()) << "\n"; } break; case DocSimpleSect::Since: if (m_insidePre) { m_t << "" << theTranslator->trSince() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trSince()) << "\n"; } break; case DocSimpleSect::Date: if (m_insidePre) { m_t << "" << theTranslator->trDate() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trDate()) << "\n"; } break; case DocSimpleSect::Note: if (m_insidePre) { m_t << "" << theTranslator->trNote() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trNote()) << "\n"; } break; case DocSimpleSect::Warning: if (m_insidePre) { m_t << "" << theTranslator->trWarning() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trWarning()) << "\n"; } break; case DocSimpleSect::Pre: if (m_insidePre) { m_t << "" << theTranslator->trPrecondition() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trPrecondition()) << "\n"; } break; case DocSimpleSect::Post: if (m_insidePre) { m_t << "" << theTranslator->trPostcondition() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trPostcondition()) << "\n"; } break; case DocSimpleSect::Copyright: if (m_insidePre) { m_t << "" << theTranslator->trCopyright() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trCopyright()) << "\n"; } break; case DocSimpleSect::Invar: if (m_insidePre) { m_t << "" << theTranslator->trInvariant() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trInvariant()) << "\n"; } break; case DocSimpleSect::Remark: // is miising the possibility if (m_insidePre) { m_t << "<formalpara><title>" << theTranslator->trRemarks() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trRemarks()) << "\n"; } break; case DocSimpleSect::Attention: if (m_insidePre) { m_t << "" << theTranslator->trAttention() << "\n"; } else { m_t << "" << convertToDocBook(theTranslator->trAttention()) << "\n"; } break; case DocSimpleSect::User: case DocSimpleSect::Rcs: case DocSimpleSect::Unknown: if (s->hasTitle()) m_t << "\n"; else m_t << "\n"; break; } } void DocbookDocVisitor::visitPost(DocSimpleSect *s) { DB_VIS_C if (m_hide) return; switch(s->type()) { case DocSimpleSect::User: case DocSimpleSect::Rcs: case DocSimpleSect::Unknown: if (s->hasTitle()) m_t << "\n"; else m_t << "\n"; break; case DocSimpleSect::Note: m_t << "\n"; break; case DocSimpleSect::Attention: m_t << "\n"; break; case DocSimpleSect::Warning: m_t << "\n"; break; default: m_t << "\n"; break; } } void DocbookDocVisitor::visitPre(DocTitle *t) { DB_VIS_C if (m_hide) return; if (t->hasTitle()) m_t << ""; } void DocbookDocVisitor::visitPost(DocTitle *t) { DB_VIS_C if (m_hide) return; if (t->hasTitle()) m_t << ""; } void DocbookDocVisitor::visitPre(DocSimpleList *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPost(DocSimpleList *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocSimpleListItem *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPost(DocSimpleListItem *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocSection *s) { DB_VIS_C if (m_hide) return; m_t << "
file()); if (!s->anchor().isEmpty()) m_t << "_1" << s->anchor(); m_t << "\">\n"; m_t << ""; filter(s->title()); m_t << "\n"; } void DocbookDocVisitor::visitPost(DocSection *) { DB_VIS_C m_t << "
\n"; } void DocbookDocVisitor::visitPre(DocHtmlList *s) { DB_VIS_C if (m_hide) return; if (s->type()==DocHtmlList::Ordered) m_t << "\n"; else m_t << "\n"; } void DocbookDocVisitor::visitPost(DocHtmlList *s) { DB_VIS_C if (m_hide) return; if (s->type()==DocHtmlList::Ordered) m_t << "\n"; else m_t << "\n"; } void DocbookDocVisitor::visitPre(DocHtmlListItem *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPost(DocHtmlListItem *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocHtmlDescList *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPost(DocHtmlDescList *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocHtmlDescTitle *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPost(DocHtmlDescTitle *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocHtmlDescData *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPost(DocHtmlDescData *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocHtmlTable *t) { DB_VIS_C m_bodySet.push(false); if (m_hide) return; m_t << "\n"; m_t << " numColumns() << "\" align=\"left\" colsep=\"1\" rowsep=\"1\">\n"; for (uint i = 0; i numColumns(); i++) { // do something with colwidth based of cell width specification (be aware of possible colspan in the header)? m_t << " \n"; } } void DocbookDocVisitor::visitPost(DocHtmlTable *) { DB_VIS_C if (m_hide) return; if (m_bodySet.top()) m_t << " \n"; m_bodySet.pop(); m_t << " \n"; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocHtmlRow *tr) { DB_VIS_C m_colCnt = 0; if (m_hide) return; if (tr->isHeading()) { if (m_bodySet.top()) m_t << "\n"; m_bodySet.top() = false; m_t << "\n"; } else if (!m_bodySet.top()) { m_bodySet.top() = true; m_t << "\n"; } m_t << " attribs()) { if (supportedHtmlAttribute(opt.name)) { // process supported attributes only m_t << " " << opt.name << "='" << convertToDocBook(opt.value) << "'"; } } m_t << ">\n"; } void DocbookDocVisitor::visitPost(DocHtmlRow *tr) { DB_VIS_C if (m_hide) return; m_t << "\n"; if (tr->isHeading()) { m_t << "\n"; m_bodySet.top() = true; } } void DocbookDocVisitor::visitPre(DocHtmlCell *c) { DB_VIS_C m_colCnt++; if (m_hide) return; m_t << "attribs()) { if (opt.name=="colspan") { m_t << " namest='c" << m_colCnt << "'"; int cols = opt.value.toInt(); m_colCnt += (cols - 1); m_t << " nameend='c" << m_colCnt << "'"; } else if (opt.name=="rowspan") { int extraRows = opt.value.toInt() - 1; m_t << " morerows='" << extraRows << "'"; } else if (opt.name=="class") { if (opt.value.left(13)=="markdownTable") // handle markdown generated attributes { if (opt.value.right(5)=="Right") { m_t << " align='right'"; } else if (opt.value.right(4)=="Left") { m_t << " align='left'"; } else if (opt.value.right(6)=="Center") { m_t << " align='center'"; } // skip 'markdownTable*' value ending with "None" } else { m_t << " class='" << convertToDocBook(opt.value) << "'"; } } else if (supportedHtmlAttribute(opt.name)) { // process supported attributes only m_t << " " << opt.name << "='" << convertToDocBook(opt.value) << "'"; } } m_t << ">"; } void DocbookDocVisitor::visitPost(DocHtmlCell *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPre(DocHtmlCaption *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPost(DocHtmlCaption *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocInternal *) { DB_VIS_C if (m_hide) return; // TODO: to be implemented } void DocbookDocVisitor::visitPost(DocInternal *) { DB_VIS_C if (m_hide) return; // TODO: to be implemented } void DocbookDocVisitor::visitPre(DocHRef *href) { DB_VIS_C if (m_hide) return; m_t << "url()) << "\">"; } void DocbookDocVisitor::visitPost(DocHRef *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPre(DocHtmlHeader *) { DB_VIS_C if (m_hide) return; m_t << ""; } void DocbookDocVisitor::visitPost(DocHtmlHeader *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocImage *img) { DB_VIS_C if (img->type()==DocImage::DocBook) { if (m_hide) return; m_t << "\n"; QCString baseName=img->name(); int i; if ((i=baseName.findRev('/'))!=-1 || (i=baseName.findRev('\\'))!=-1) { baseName=baseName.right((int)baseName.length()-i-1); } visitPreStart(m_t, img->children(), img->hasCaption(), img->relPath() + baseName, img->width(), img->height(), img->isInlineImage()); } else { pushHidden(m_hide); m_hide=TRUE; } } void DocbookDocVisitor::visitPost(DocImage *img) { DB_VIS_C if (img->type()==DocImage::DocBook) { if (m_hide) return; visitPostEnd(m_t, img -> hasCaption(),img -> isInlineImage()); // copy the image to the output dir QCString baseName=img->name(); int i; if ((i=baseName.findRev('/'))!=-1 || (i=baseName.findRev('\\'))!=-1) { baseName=baseName.right((int)baseName.length()-i-1); } QCString m_file; bool ambig; FileDef *fd=findFileDef(Doxygen::imageNameLinkedMap, baseName, ambig); if (fd) { m_file=fd->absFilePath(); } copyFile(m_file,Config_getString(DOCBOOK_OUTPUT)+"/"+baseName.data()); } else { m_hide = popHidden(); } } void DocbookDocVisitor::visitPre(DocDotFile *df) { DB_VIS_C if (m_hide) return; startDotFile(df->file(),df->width(),df->height(),df->hasCaption(),df->children()); } void DocbookDocVisitor::visitPost(DocDotFile *df) { DB_VIS_C if (m_hide) return; endDotFile(df->hasCaption()); } void DocbookDocVisitor::visitPre(DocMscFile *df) { DB_VIS_C if (m_hide) return; startMscFile(df->file(),df->width(),df->height(),df->hasCaption(),df->children()); } void DocbookDocVisitor::visitPost(DocMscFile *df) { DB_VIS_C if (m_hide) return; endMscFile(df->hasCaption()); } void DocbookDocVisitor::visitPre(DocDiaFile *df) { DB_VIS_C if (m_hide) return; startDiaFile(df->file(),df->width(),df->height(),df->hasCaption(),df->children()); } void DocbookDocVisitor::visitPost(DocDiaFile *df) { DB_VIS_C if (m_hide) return; endDiaFile(df->hasCaption()); } void DocbookDocVisitor::visitPre(DocLink *lnk) { DB_VIS_C if (m_hide) return; startLink(lnk->file(),lnk->anchor()); } void DocbookDocVisitor::visitPost(DocLink *) { DB_VIS_C if (m_hide) return; endLink(); } void DocbookDocVisitor::visitPre(DocRef *ref) { DB_VIS_C if (m_hide) return; if (ref->isSubPage()) { startLink(0,ref->anchor()); } else { if (!ref->file().isEmpty()) startLink(ref->file(),ref->anchor()); } if (!ref->hasLinkText()) filter(ref->targetTitle()); } void DocbookDocVisitor::visitPost(DocRef *ref) { DB_VIS_C if (m_hide) return; if (!ref->file().isEmpty()) endLink(); } void DocbookDocVisitor::visitPre(DocSecRefItem *) { DB_VIS_C if (m_hide) return; //m_t << "file()) << "_1" << ref->anchor() << "\">"; m_t << ""; } void DocbookDocVisitor::visitPost(DocSecRefItem *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocSecRefList *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPost(DocSecRefList *) { DB_VIS_C if (m_hide) return; m_t << "\n"; } void DocbookDocVisitor::visitPre(DocParamSect *s) { DB_VIS_C if (m_hide) return; m_t << "\n"; m_t << " \n"; m_t << " \n"; switch(s->type()) { case DocParamSect::Param: m_t << theTranslator->trParameters(); break; case DocParamSect::RetVal: m_t << theTranslator->trReturnValues(); break; case DocParamSect::Exception: m_t << theTranslator->trExceptions(); break; case DocParamSect::TemplateParam: m_t << theTranslator->trTemplateParameters(); break; default: ASSERT(0); } m_t << " \n"; m_t << " \n"; m_t << " \n"; int ncols = 2; if (s->type() == DocParamSect::Param) { bool hasInOutSpecs = s->hasInOutSpecifier(); bool hasTypeSpecs = s->hasTypeSpecifier(); if (hasInOutSpecs && hasTypeSpecs) ncols += 2; else if (hasInOutSpecs || hasTypeSpecs) ncols += 1; } m_t << " \n"; for (int i = 1; i <= ncols; i++) { if (i == ncols) m_t << " \n"; else m_t << " \n"; } m_t << " \n"; } void DocbookDocVisitor::visitPost(DocParamSect *) { DB_VIS_C if (m_hide) return; m_t << " \n"; m_t << " \n"; m_t << "
\n"; m_t << "
\n"; m_t << "
\n"; m_t << " "; } void DocbookDocVisitor::visitPre(DocParamList *pl) { DB_VIS_C if (m_hide) return; m_t << " \n"; DocParamSect *sect = 0; if (pl->parent() && pl->parent()->kind()==DocNode::Kind_ParamSect) { sect=(DocParamSect*)pl->parent(); } if (sect && sect->hasInOutSpecifier()) { m_t << " "; if (pl->direction()!=DocParamSect::Unspecified) { if (pl->direction()==DocParamSect::In) { m_t << "in"; } else if (pl->direction()==DocParamSect::Out) { m_t << "out"; } else if (pl->direction()==DocParamSect::InOut) { m_t << "in,out"; } } m_t << " "; } if (sect && sect->hasTypeSpecifier()) { m_t << " "; for (const auto &type : pl->paramTypes()) { if (type->kind()==DocNode::Kind_Word) { visit((DocWord*)type.get()); } else if (type->kind()==DocNode::Kind_LinkedWord) { visit((DocLinkedWord*)type.get()); } else if (type->kind()==DocNode::Kind_Sep) { m_t << " " << ((DocSeparator *)type.get())->chars() << " "; } } m_t << " "; } if (pl->parameters().empty()) { m_t << " \n"; } else { m_t << " "; int cnt = 0; for (const auto ¶m : pl->parameters()) { if (cnt) { m_t << ", "; } if (param->kind()==DocNode::Kind_Word) { visit((DocWord*)param.get()); } else if (param->kind()==DocNode::Kind_LinkedWord) { visit((DocLinkedWord*)param.get()); } cnt++; } m_t << "\n"; } m_t << " "; } void DocbookDocVisitor::visitPost(DocParamList *) { DB_VIS_C if (m_hide) return; m_t << "\n"; m_t << " \n"; } void DocbookDocVisitor::visitPre(DocXRefItem *x) { DB_VIS_C if (m_hide) return; if (x->title().isEmpty()) return; m_t << "file()) << "_1" << x->anchor(); m_t << "\">"; filter(x->title()); m_t << ""; m_t << " "; } void DocbookDocVisitor::visitPost(DocXRefItem *x) { DB_VIS_C if (m_hide) return; if (x->title().isEmpty()) return; m_t << ""; } void DocbookDocVisitor::visitPre(DocInternalRef *ref) { DB_VIS_C if (m_hide) return; startLink(ref->file(),ref->anchor()); } void DocbookDocVisitor::visitPost(DocInternalRef *) { DB_VIS_C if (m_hide) return; endLink(); m_t << " "; } void DocbookDocVisitor::visitPre(DocText *) { DB_VIS_C // TODO: to be implemented } void DocbookDocVisitor::visitPost(DocText *) { DB_VIS_C // TODO: to be implemented } void DocbookDocVisitor::visitPre(DocHtmlBlockQuote *) { DB_VIS_C if (m_hide) return; m_t << "
"; } void DocbookDocVisitor::visitPost(DocHtmlBlockQuote *) { DB_VIS_C if (m_hide) return; m_t << "
"; } void DocbookDocVisitor::visitPre(DocVhdlFlow *) { DB_VIS_C // TODO: to be implemented } void DocbookDocVisitor::visitPost(DocVhdlFlow *) { DB_VIS_C // TODO: to be implemented } void DocbookDocVisitor::visitPre(DocParBlock *) { DB_VIS_C } void DocbookDocVisitor::visitPost(DocParBlock *) { DB_VIS_C } void DocbookDocVisitor::filter(const char *str) { DB_VIS_C m_t << convertToDocBook(str); } void DocbookDocVisitor::startLink(const QCString &file,const QCString &anchor) { DB_VIS_C m_t << ""; } void DocbookDocVisitor::endLink() { DB_VIS_C m_t << ""; } void DocbookDocVisitor::writeMscFile(const QCString &baseName, DocVerbatim *s) { DB_VIS_C QCString shortName = baseName; int i; if ((i=shortName.findRev('/'))!=-1) { shortName=shortName.right((int)shortName.length()-i-1); } QCString outDir = Config_getString(DOCBOOK_OUTPUT); writeMscGraphFromFile(baseName+".msc",outDir,shortName,MSC_BITMAP); visitPreStart(m_t, s->children(), s->hasCaption(), s->relPath() + shortName + ".png", s->width(), s->height()); visitCaption(s->children()); visitPostEnd(m_t, s->hasCaption()); } void DocbookDocVisitor::writePlantUMLFile(const QCString &baseName, DocVerbatim *s) { DB_VIS_C QCString shortName = baseName; int i; if ((i=shortName.findRev('/'))!=-1) { shortName=shortName.right((int)shortName.length()-i-1); } QCString outDir = Config_getString(DOCBOOK_OUTPUT); PlantumlManager::instance().generatePlantUMLOutput(baseName,outDir,PlantumlManager::PUML_BITMAP); visitPreStart(m_t, s->children(), s->hasCaption(), s->relPath() + shortName + ".png", s->width(),s->height()); visitCaption(s->children()); visitPostEnd(m_t, s->hasCaption()); } void DocbookDocVisitor::startMscFile(const QCString &fileName, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children ) { DB_VIS_C QCString baseName=fileName; int i; if ((i=baseName.findRev('/'))!=-1) { baseName=baseName.right((int)baseName.length()-i-1); } if ((i=baseName.find('.'))!=-1) { baseName=baseName.left(i); } baseName.prepend("msc_"); QCString outDir = Config_getString(DOCBOOK_OUTPUT); writeMscGraphFromFile(fileName,outDir,baseName,MSC_BITMAP); m_t << "\n"; visitPreStart(m_t, children, hasCaption, baseName + ".png", width, height); } void DocbookDocVisitor::endMscFile(bool hasCaption) { DB_VIS_C if (m_hide) return; visitPostEnd(m_t, hasCaption); m_t << "\n"; } void DocbookDocVisitor::writeDiaFile(const QCString &baseName, DocVerbatim *s) { DB_VIS_C QCString shortName = baseName; int i; if ((i=shortName.findRev('/'))!=-1) { shortName=shortName.right((int)shortName.length()-i-1); } QCString outDir = Config_getString(DOCBOOK_OUTPUT); writeDiaGraphFromFile(baseName+".dia",outDir,shortName,DIA_BITMAP); visitPreStart(m_t, s->children(), s->hasCaption(), shortName, s->width(),s->height()); visitCaption(s->children()); visitPostEnd(m_t, s->hasCaption()); } void DocbookDocVisitor::startDiaFile(const QCString &fileName, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children ) { DB_VIS_C QCString baseName=fileName; int i; if ((i=baseName.findRev('/'))!=-1) { baseName=baseName.right((int)baseName.length()-i-1); } if ((i=baseName.find('.'))!=-1) { baseName=baseName.left(i); } baseName.prepend("dia_"); QCString outDir = Config_getString(DOCBOOK_OUTPUT); writeDiaGraphFromFile(fileName,outDir,baseName,DIA_BITMAP); m_t << "\n"; visitPreStart(m_t, children, hasCaption, baseName + ".png", width, height); } void DocbookDocVisitor::endDiaFile(bool hasCaption) { DB_VIS_C if (m_hide) return; visitPostEnd(m_t, hasCaption); m_t << "\n"; } void DocbookDocVisitor::writeDotFile(const QCString &baseName, DocVerbatim *s) { DB_VIS_C QCString shortName = baseName; int i; if ((i=shortName.findRev('/'))!=-1) { shortName=shortName.right((int)shortName.length()-i-1); } QCString outDir = Config_getString(DOCBOOK_OUTPUT); writeDotGraphFromFile(baseName+".dot",outDir,shortName,GOF_BITMAP); visitPreStart(m_t, s->children(), s->hasCaption(), s->relPath() + shortName + "." + getDotImageExtension(), s->width(),s->height()); visitCaption(s->children()); visitPostEnd(m_t, s->hasCaption()); } void DocbookDocVisitor::startDotFile(const QCString &fileName, const QCString &width, const QCString &height, bool hasCaption, const DocNodeList &children ) { DB_VIS_C QCString baseName=fileName; int i; if ((i=baseName.findRev('/'))!=-1) { baseName=baseName.right((int)baseName.length()-i-1); } if ((i=baseName.find('.'))!=-1) { baseName=baseName.left(i); } baseName.prepend("dot_"); QCString outDir = Config_getString(DOCBOOK_OUTPUT); QCString imgExt = getDotImageExtension(); writeDotGraphFromFile(fileName,outDir,baseName,GOF_BITMAP); m_t << "\n"; visitPreStart(m_t, children, hasCaption, baseName + "." + imgExt, width, height); } void DocbookDocVisitor::endDotFile(bool hasCaption) { DB_VIS_C if (m_hide) return; m_t << "\n"; visitPostEnd(m_t, hasCaption); m_t << "\n"; }