MermaidManager Class Reference

Singleton that manages Mermaid diagram rendering via the mmdc CLI tool. More...

#include <src/mermaid.h>

Classes
struct	MermaidDiagram

Public Types
enum class	OutputFormat { HTML , LaTeX , RTF , Docbook }
	Mermaid output image formats. More...
enum class	ImageFormat { PNG , SVG , PDF }
using	DiagramList = std::vector<MermaidDiagram>

Public Member Functions
void	setHasInlineDiagrams ()
bool	hasInlineDiagrams () const
bool	needToRun () const
void	run ()
	Run mmdc tool for all collected diagrams.
DString	writeMermaidSource (const DString &outDirArg, const DString &fileName, const DString &content, ImageFormat format, const DString &srcFile, int srcLine)
	Write a Mermaid source file and register it for CLI rendering.
void	generateMermaidOutput (const DString &baseName, const DString &outDir, ImageFormat format, bool toIndex)
	Register a generated Mermaid image with the index.

Static Public Member Functions
static MermaidManager &	instance ()
static DString	imageExtension (ImageFormat imageFormat)
static ImageFormat	convertToImageFormat (OutputFormat outputFormat)

Private Member Functions
	MermaidManager ()

Private Attributes
DiagramList	m_diagrams
bool	m_hasInlineDiagrams = false

Detailed Description

Singleton that manages Mermaid diagram rendering via the mmdc CLI tool.

Definition at line 40 of file mermaid.h.

Member Typedef Documentation

DiagramList

using MermaidManager::DiagramList = std::vector<MermaidDiagram>

Definition at line 83 of file mermaid.h.

Member Enumeration Documentation

ImageFormat

enum class MermaidManager::ImageFormat

strong

Enumerator
PNG
SVG
PDF

Definition at line 45 of file mermaid.h.

{ PNG, SVG, PDF };

OutputFormat

enum class MermaidManager::OutputFormat

strong

Mermaid output image formats.

Enumerator
HTML
LaTeX
RTF
Docbook

Definition at line 44 of file mermaid.h.

{ HTML, LaTeX, RTF, Docbook };

Constructor & Destructor Documentation

MermaidManager()

MermaidManager::MermaidManager ( )

private

Definition at line 44 of file mermaid.cpp.

{
}

Referenced by instance().

Member Function Documentation

convertToImageFormat()

MermaidManager::ImageFormat MermaidManager::convertToImageFormat ( OutputFormat outputFormat )

static

Definition at line 59 of file mermaid.cpp.

{
  switch(outputFormat)
  {
    case OutputFormat::HTML:
      // fall through
    case OutputFormat::RTF:
      // fall through
    case OutputFormat::Docbook:
      return getDotImageExtension()=="svg" ? ImageFormat::SVG : ImageFormat::PNG;
    case OutputFormat::LaTeX:
      return Config_getBool(USE_PDFLATEX) ? ImageFormat::PDF : ImageFormat::PNG;
  }
  return ImageFormat::PNG;
}

References Config_getBool, Docbook, getDotImageExtension(), HTML, LaTeX, PDF, PNG, RTF, and SVG.

Referenced by DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), RTFDocVisitor::operator()(), RTFDocVisitor::operator()(), DocbookDocVisitor::startMermaidFile(), LatexDocVisitor::startMermaidFile(), DocbookDocVisitor::writeMermaidFile(), HtmlDocVisitor::writeMermaidFile(), LatexDocVisitor::writeMermaidFile(), and RTFDocVisitor::writeMermaidFile().

generateMermaidOutput()

void MermaidManager::generateMermaidOutput	(	const DString &	baseName,
		const DString &	outDir,
		ImageFormat	format,
		bool	toIndex )

Register a generated Mermaid image with the index.

Parameters

[in]	baseName	the name of the generated file (as returned by writeMermaidSource())
[in]	outDir	the directory containing the resulting image.
[in]	format	the image format that was generated.
[in]	toIndex	add the file to the index lists for htmlhelp / qhc etc.

Definition at line 121 of file mermaid.cpp.

{
  if (!toIndex) return;
  DString imgName = baseName;
  if (size_t i = imgName.rfind('/'); i!=DString::npos)
  {
    imgName = imgName.mid(i + 1);
  }
  imgName += "." + imageExtension(imageFormat);
  Doxygen::indexList->addImageFile(imgName);
}

References IndexList::addImageFile(), imageExtension(), Doxygen::indexList, DString::mid(), DString::npos, and DString::rfind().

Referenced by DocbookDocVisitor::startMermaidFile(), LatexDocVisitor::startMermaidFile(), DocbookDocVisitor::writeMermaidFile(), HtmlDocVisitor::writeMermaidFile(), LatexDocVisitor::writeMermaidFile(), and RTFDocVisitor::writeMermaidFile().

hasInlineDiagrams()

bool MermaidManager::hasInlineDiagrams ( ) const

inline

Definition at line 50 of file mermaid.h.

{ return m_hasInlineDiagrams; }

References m_hasInlineDiagrams.

imageExtension()

DString MermaidManager::imageExtension ( ImageFormat imageFormat )

static

Definition at line 48 of file mermaid.cpp.

{
  switch (format)
  {
    case ImageFormat::PNG: return "png";
    case ImageFormat::SVG: return "svg";
    case ImageFormat::PDF: return "pdf";
  }
  return "png";
}

References PDF, PNG, and SVG.

Referenced by generateMermaidOutput(), runMermaid(), DocbookDocVisitor::startMermaidFile(), LatexDocVisitor::startMermaidFile(), DocbookDocVisitor::writeMermaidFile(), HtmlDocVisitor::writeMermaidFile(), LatexDocVisitor::writeMermaidFile(), and RTFDocVisitor::writeMermaidFile().

instance()

MermaidManager & MermaidManager::instance ( )

static

Definition at line 38 of file mermaid.cpp.

{
  static MermaidManager theInstance;
  return theInstance;
}

References MermaidManager().

Referenced by generateOutput(), handleFormatBlock(), handleMermaidFile(), DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), RTFDocVisitor::operator()(), RTFDocVisitor::operator()(), DocbookDocVisitor::startMermaidFile(), LatexDocVisitor::startMermaidFile(), substituteHtmlKeywords(), DocbookDocVisitor::writeMermaidFile(), HtmlDocVisitor::writeMermaidFile(), LatexDocVisitor::writeMermaidFile(), and RTFDocVisitor::writeMermaidFile().

needToRun()

bool MermaidManager::needToRun ( ) const

inline

Definition at line 51 of file mermaid.h.

{ return !m_diagrams.empty(); }

References m_diagrams.

run()

void MermaidManager::run

(

)

Run mmdc tool for all collected diagrams.

Definition at line 255 of file mermaid.cpp.

{
  Debug::print(Debug::Mermaid, 0, "*** MermaidManager::run\n");
  runMermaid(m_diagrams);
}

References m_diagrams, Debug::Mermaid, Debug::print(), and runMermaid().

Referenced by generateOutput().

setHasInlineDiagrams()

void MermaidManager::setHasInlineDiagrams

(

)

Definition at line 248 of file mermaid.cpp.

{
  // CLI mode creates images locally, other modes create inline diagram descriptions
  // in the HTML output and rely on rendering them in the browser.
  m_hasInlineDiagrams=Config_getEnum(MERMAID_RENDER_MODE)!=MERMAID_RENDER_MODE_t::CLI;
}

References Config_getEnum, and m_hasInlineDiagrams.

Referenced by handleFormatBlock(), and handleMermaidFile().

writeMermaidSource()

DString MermaidManager::writeMermaidSource	(	const DString &	outDirArg,
		const DString &	fileName,
		const DString &	content,
		ImageFormat	format,
		const DString &	srcFile,
		int	srcLine )

Write a Mermaid source file and register it for CLI rendering.

Parameters

[in]	outDirArg	the output directory to write the file to.
[in]	fileName	the name of the file. If empty a name will be chosen automatically.
[in]	content	the Mermaid diagram source.
[in]	format	the image format to generate.
[in]	srcFile	the source file resulting in the write command.
[in]	srcLine	the line number resulting in the write command.

Returns

The base name of the generated file (without extension).

Definition at line 75 of file mermaid.cpp.

{
  DString outDir(outDirArg);
  DString baseName;
 
  // strip any trailing slashes and backslashes
  while (!outDir.empty() && (outDir.at(outDir.length()-1)=='/' || outDir.at(outDir.length()-1)=='\\'))
  {
    outDir = outDir.left(outDir.length()-1);
  }
 
  if (fileName.empty())
  {
    std::lock_guard<std::mutex> lock(g_mermaidMutex);
    baseName = outDir + "/inline_mermaid_" + DString().setNum(g_mermaidIndex++);
  }
  else
  {
    baseName = fileName;
    if (size_t i = baseName.rfind('.'); i!=DString::npos) baseName = baseName.left(i);
    baseName.prepend(outDir + "/");
  }
 
  DString mmdName = baseName + ".mmd";
 
  Debug::print(Debug::Mermaid, 0, "*** writeMermaidSource baseName: {}\n", baseName);
  Debug::print(Debug::Mermaid, 0, "*** writeMermaidSource mmdName: {}\n", mmdName);
 
  // Write the .mmd source file
  std::ofstream file = Portable::openOutputStream(mmdName);
  if (!file.is_open())
  {
    err_full(srcFile, srcLine, "Could not open file {} for writing", mmdName);
    return baseName;
  }
  file.write(content.data(), content.length());
  file.close();
 
  // Store for batch processing in run()
  m_diagrams.emplace_back(imageFormat,MermaidDiagramInfo(baseName, content, outDir, srcFile, srcLine));
 
  return baseName;
}

References DString::at(), DString::data(), DString::empty(), err_full, g_mermaidIndex, g_mermaidMutex, DString::left(), DString::length(), m_diagrams, Debug::Mermaid, DString::npos, Portable::openOutputStream(), DString::prepend(), Debug::print(), DString::rfind(), and DString::setNum().

Referenced by DocbookDocVisitor::operator()(), HtmlDocVisitor::operator()(), HtmlDocVisitor::operator()(), LatexDocVisitor::operator()(), RTFDocVisitor::operator()(), RTFDocVisitor::operator()(), DocbookDocVisitor::startMermaidFile(), and LatexDocVisitor::startMermaidFile().

Member Data Documentation

m_diagrams

DiagramList MermaidManager::m_diagrams

private

Definition at line 91 of file mermaid.h.

Referenced by needToRun(), run(), and writeMermaidSource().

m_hasInlineDiagrams

bool MermaidManager::m_hasInlineDiagrams = false

private

Definition at line 92 of file mermaid.h.

Referenced by hasInlineDiagrams(), and setHasInlineDiagrams().

---

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

• src/mermaid.h
• src/mermaid.cpp