HtmlCodeGenerator Class Reference

Generator for HTML code fragments. More...

#include <src/htmlgen.h>

Inheritance diagram for HtmlCodeGenerator:

Collaboration diagram for HtmlCodeGenerator:

Classes
struct	LineInfo

Public Member Functions
	HtmlCodeGenerator (TextStream *t, const DString &relPath)
	HtmlCodeGenerator (TextStream *t)
void	setTextStream (TextStream *t)
void	setFileName (const DString fileName)
DString	fileName ()
OutputType	type () const override
std::unique_ptr< OutputCodeIntf >	clone () override
void	codify (const DString &text) override
void	stripCodeComments (bool b) override
void	startSpecialComment () override
void	endSpecialComment () override
void	setStripIndentAmount (size_t amount) override
void	writeCodeLink (CodeSymbolType type, const DString &ref, const DString &file, const DString &anchor, const DString &name, const DString &tooltip) override
void	writeTooltip (const DString &id, const DocLinkInfo &docInfo, const DString &decl, const DString &desc, const SourceLinkInfo &defInfo, const SourceLinkInfo &declInfo) override
void	writeLineNumber (const DString &, const DString &, const DString &, int, bool) override
void	startCodeLine (int) override
void	endCodeLine () override
void	startFontClass (const DString &s) override
void	endFontClass () override
void	writeCodeAnchor (const DString &anchor) override
void	startCodeFragment (const DString &style) override
void	endCodeFragment (const DString &) override
void	startFold (int, const DString &, const DString &) override
void	endFold () override
void	setRelativePath (const DString &path)
Public Member Functions inherited from OutputCodeIntf
	OutputCodeIntf ()=default

Private Member Functions
void	_writeCodeLink (const DString &className, const DString &ref, const DString &file, const DString &anchor, const DString &name, const DString &tooltip)
void	_startOpenLine ()

Private Attributes
TextStream *	m_t
size_t	m_col = 0
DString	m_relPath
DString	m_fileName
bool	m_lineOpen = false
bool	m_stripCodeComments = false
bool	m_hide = false
LineInfo	m_lastLineInfo
size_t	m_stripIndentAmount = 0

Detailed Description

Generator for HTML code fragments.

Definition at line 22 of file htmlgen.h.

Constructor & Destructor Documentation

HtmlCodeGenerator() [1/2]

HtmlCodeGenerator::HtmlCodeGenerator	(	TextStream *	t,
		const DString &	relPath )

Definition at line 838 of file htmlgen.cpp.

  : m_t(t), m_relPath(relPath)
{
  //printf("%p:HtmlCodeGenerator()\n",(void*)this);
}

References m_relPath, and m_t.

HtmlCodeGenerator() [2/2]

HtmlCodeGenerator::HtmlCodeGenerator

(

TextStream *

t

)

Definition at line 833 of file htmlgen.cpp.

                                                  : m_t(t)
{
  //printf("%p:HtmlCodeGenerator()\n",(void*)this);
}

References m_t.

Member Function Documentation

_startOpenLine()

void HtmlCodeGenerator::_startOpenLine ( )

private

Definition at line 1196 of file htmlgen.cpp.

{
  //printf("_startOpenLine open=%d\n",m_lineOpen);
  *m_t << "<div class=\"line\">";
  bool wasHidden=m_hide;
  m_hide = false;
  m_lineOpen = true;
  writeLineNumber(m_lastLineInfo.ref,
      m_lastLineInfo.fileName,
      m_lastLineInfo.anchor,
      m_lastLineInfo.line+1,
      m_lastLineInfo.writeAnchor);
  m_hide = wasHidden;
}

References HtmlCodeGenerator::LineInfo::anchor, HtmlCodeGenerator::LineInfo::fileName, HtmlCodeGenerator::LineInfo::line, m_hide, m_lastLineInfo, m_lineOpen, m_t, HtmlCodeGenerator::LineInfo::ref, HtmlCodeGenerator::LineInfo::writeAnchor, and writeLineNumber().

Referenced by endFold().

_writeCodeLink()

void HtmlCodeGenerator::_writeCodeLink ( const DString & className, const DString & ref, const DString & file, const DString & anchor, const DString & name, const DString & tooltip )

private

Definition at line 1004 of file htmlgen.cpp.

{
  m_col+=name.length();
  if (m_hide) return;
  if (!ref.empty())
  {
    *m_t << "<a class=\"" << className << "Ref\" ";
    *m_t << externalLinkTarget();
  }
  else
  {
    *m_t << "<a class=\"" << className << "\" ";
  }
  *m_t << "href=\"";
  DString fn = f;
  addHtmlExtensionIfMissing(fn);
  *m_t << createHtmlUrl(m_relPath,ref,
                        fileName()==fn,fn,anchor);
  *m_t << "\"";
  if (!tooltip.empty()) *m_t << " title=\"" << convertToHtml(tooltip) << "\"";
  *m_t << ">";
  codify(name);
  *m_t << "</a>";
}

References addHtmlExtensionIfMissing(), codify(), convertToHtml(), createHtmlUrl(), DString::empty(), externalLinkTarget(), fileName(), DString::length(), m_col, m_hide, m_relPath, and m_t.

Referenced by writeCodeLink(), and writeLineNumber().

clone()

std::unique_ptr< OutputCodeIntf > HtmlCodeGenerator::clone ( )

inlineoverridevirtual

Implements OutputCodeIntf.

Definition at line 33 of file htmlgen.h.

{ return std::make_unique<HtmlCodeGenerator>(*this); }

codify()

void HtmlCodeGenerator::codify ( const DString & text )

overridevirtual

Implements OutputCodeIntf.

Definition at line 849 of file htmlgen.cpp.

{
  if (!str.empty())
  {
    int tabSize = Config_getInt(TAB_SIZE);
    const char *p=str.data();
    if (m_hide) // only update column count
    {
      m_col = updateColumnCount(p,m_col);
    }
    else // actually output content and keep track of m_col
    {
      while (*p)
      {
        char c=*p++;
        switch(c)
        {
          case '\t': {
                       int spacesToNextTabStop = tabSize - (m_col%tabSize);
                       while (spacesToNextTabStop--)
                       {
                         if (m_col>=m_stripIndentAmount) *m_t << " ";
                         m_col++;
                       }
                     }
                     break;
          case ' ':  if (m_col>=m_stripIndentAmount) *m_t << " ";
                     m_col++;
                     break;
          case '\n': *m_t << "\n"; m_col=0;
                     break;
          case '\r': break;
          case '<':  *m_t << "&lt;"; m_col++;
                     break;
          case '>':  *m_t << "&gt;"; m_col++;
                     break;
          case '&':  *m_t << "&amp;"; m_col++;
                     break;
          case '\'': *m_t << "&#39;"; m_col++; // &apos; is not valid XHTML
                     break;
          case '"':  *m_t << "&quot;"; m_col++;
                     break;
          case '\\':
                     if (*p=='<')
                     { *m_t << "&lt;"; p++; }
                     else if (*p=='>')
                     { *m_t << "&gt;"; p++; }
                     else if (*p=='[')
                     { *m_t << "\\&zwj;["; m_col++;p++; }
                     else if (*p==']')
                     { *m_t << "\\&zwj;]"; m_col++;p++; }
                     else if (*p=='(')
                     { *m_t << "\\&zwj;("; m_col++;p++; }
                     else if (*p==')')
                     { *m_t << "\\&zwj;)"; m_col++;p++; }
                     else
                       *m_t << "\\";
                     m_col++;
                     break;
          default:
                     {
                       uint8_t uc = static_cast<uint8_t>(c);
                       if (uc<32)
                       {
                         *m_t << "&#x24" << hex[uc>>4] << hex[uc&0xF] << ";";
                         m_col++;
                       }
                       else if (uc<0x80) // printable ASCII char
                       {
                         *m_t << c;
                         m_col++;
                       }
                       else // multibyte UTF-8 char
                       {
                         p=writeUTF8Char(*m_t,p-1);
                         m_col++;
                       }
                     }
                     break;
        }
      }
    }
  }
}

References Config_getInt, DString::data(), DString::empty(), hex, m_col, m_hide, m_stripIndentAmount, m_t, updateColumnCount(), and writeUTF8Char().

Referenced by _writeCodeLink(), writeLineNumber(), and writeTooltip().

endCodeFragment()

void HtmlCodeGenerator::endCodeFragment ( const DString & )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1163 of file htmlgen.cpp.

{
  //printf("endCodeFragment hide=%d open=%d\n",m_hide,m_lineOpen);
  bool wasHidden = m_hide;
  m_hide = false;
  //endCodeLine checks is there is still an open code line, if so closes it.
  endCodeLine();
  m_hide = wasHidden;
 
  *m_t << "</div><!-- fragment -->";
}

References endCodeLine(), m_hide, and m_t.

endCodeLine()

void HtmlCodeGenerator::endCodeLine ( )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1124 of file htmlgen.cpp.

{
  //printf("endCodeLine hide=%d open=%d\n",m_hide,m_lineOpen);
  if (m_hide) return;
  if (m_col == 0)
  {
    *m_t << " ";
    m_col++;
  }
  if (m_lineOpen)
  {
    *m_t << "</div>\n";
    m_lineOpen = false;
  }
}

References m_col, m_hide, m_lineOpen, and m_t.

Referenced by endCodeFragment().

endFold()

void HtmlCodeGenerator::endFold ( )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1211 of file htmlgen.cpp.

{
  //printf("endFold open=%d\n",m_lineOpen);
  if (m_lineOpen) // if we have a hidden comment in a code fold, we need to end the line
  {
    *m_t << "</div>\n";
  }
  *m_t << "</div>\n";
  if (m_lineOpen)
  {
    _startOpenLine();
  }
}

References _startOpenLine(), m_lineOpen, and m_t.

endFontClass()

void HtmlCodeGenerator::endFontClass ( )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1146 of file htmlgen.cpp.

{
  if (m_hide) return;
  *m_t << "</span>";
}

References m_hide, and m_t.

endSpecialComment()

void HtmlCodeGenerator::endSpecialComment ( )

overridevirtual

Implements OutputCodeIntf.

Definition at line 945 of file htmlgen.cpp.

{
  //*m_t << "[END]";
  m_hide = false;
}

References m_hide.

fileName()

DString HtmlCodeGenerator::fileName ( )

inline

Definition at line 30 of file htmlgen.h.

{ return m_fileName; }

References m_fileName.

Referenced by _writeCodeLink(), setFileName(), and writeTooltip().

setFileName()

void HtmlCodeGenerator::setFileName ( const DString fileName )

inline

Definition at line 29 of file htmlgen.h.

{ m_fileName = fileName; }

References fileName(), and m_fileName.

Referenced by HtmlGenerator::startFile().

setRelativePath()

void HtmlCodeGenerator::setRelativePath

(

const DString &

path

)

Definition at line 844 of file htmlgen.cpp.

{
  m_relPath = path;
}

References m_relPath.

Referenced by HtmlGenerator::startFile().

setStripIndentAmount()

void HtmlCodeGenerator::setStripIndentAmount ( size_t amount )

overridevirtual

Implements OutputCodeIntf.

Definition at line 951 of file htmlgen.cpp.

{
  m_stripIndentAmount = amount;
}

References m_stripIndentAmount.

setTextStream()

void HtmlCodeGenerator::setTextStream ( TextStream * t )

inline

Definition at line 28 of file htmlgen.h.

{ m_t = t; }

References m_t.

Referenced by HtmlGenerator::HtmlGenerator(), and HtmlGenerator::operator=().

startCodeFragment()

void HtmlCodeGenerator::startCodeFragment ( const DString & style )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1158 of file htmlgen.cpp.

{
  *m_t << "<div class=\"fragment\">";
}

References m_t.

startCodeLine()

void HtmlCodeGenerator::startCodeLine ( int )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1112 of file htmlgen.cpp.

{
  //printf("startCodeLine open=%d\n",m_lineOpen);
  m_col=0;
  if (m_hide) return;
  if (!m_lineOpen)
  {
    *m_t << "<div class=\"line\">";
    m_lineOpen = true;
  }
}

References m_col, m_hide, m_lineOpen, and m_t.

startFold()

void HtmlCodeGenerator::startFold ( int lineNr, const DString & startMarker, const DString & endMarker )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1175 of file htmlgen.cpp.

{
  //printf("startFold open=%d\n",m_lineOpen);
  if (m_lineOpen) // if we have a hidden comment in a code fold, we need to end the line
  {
    *m_t << "</div>\n";
  }
  const int maxLineNrStr = 10;
  char lineNumber[maxLineNrStr];
  snprintf(lineNumber,maxLineNrStr,"%05d",lineNr);
  *m_t << "<div class=\"foldopen\" id=\"foldopen" << lineNumber <<
          "\" data-start=\"" << startMarker <<
          "\" data-end=\"" << endMarker <<
          "\">\n";
  if (m_lineOpen) // if we have a hidden comment in a code fold, we need to restart the line
  {
    *m_t << "<div class=\"line\">";
  }
  m_hide=false;
}

References m_hide, m_lineOpen, and m_t.

startFontClass()

void HtmlCodeGenerator::startFontClass ( const DString & s )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1140 of file htmlgen.cpp.

{
  if (m_hide) return;
  *m_t << "<span class=\"" << s << "\">";
}

References m_hide, and m_t.

startSpecialComment()

void HtmlCodeGenerator::startSpecialComment ( )

overridevirtual

Implements OutputCodeIntf.

Definition at line 939 of file htmlgen.cpp.

{
  m_hide = m_stripCodeComments;
  //*m_t << "[START]";
}

References m_hide, and m_stripCodeComments.

stripCodeComments()

void HtmlCodeGenerator::stripCodeComments ( bool b )

overridevirtual

Implements OutputCodeIntf.

Definition at line 934 of file htmlgen.cpp.

{
  m_stripCodeComments = b;
}

References m_stripCodeComments.

type()

OutputType HtmlCodeGenerator::type ( ) const

inlineoverridevirtual

Implements OutputCodeIntf.

Definition at line 32 of file htmlgen.h.

{ return OutputType::Html; }

References Html.

Referenced by writeCodeLink().

writeCodeAnchor()

void HtmlCodeGenerator::writeCodeAnchor ( const DString & anchor )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1152 of file htmlgen.cpp.

{
  if (m_hide) return;
  *m_t << "<a id=\"" << anchor << "\" name=\"" << anchor << "\"></a>";
}

References m_hide, and m_t.

writeCodeLink()

void HtmlCodeGenerator::writeCodeLink ( CodeSymbolType type, const DString & ref, const DString & file, const DString & anchor, const DString & name, const DString & tooltip )

overridevirtual

Implements OutputCodeIntf.

Definition at line 988 of file htmlgen.cpp.

{
  if (m_hide) return;
  const char *hl = codeSymbolType2Str(type);
  DString hlClass = "code";
  if (hl)
  {
    hlClass+=" hl_";
    hlClass+=hl;
  }
  _writeCodeLink(hlClass,ref,f,anchor,name,tooltip);
}

References _writeCodeLink(), codeSymbolType2Str(), m_hide, and type().

writeLineNumber()

void HtmlCodeGenerator::writeLineNumber ( const DString & ref, const DString & filename, const DString & anchor, int l, bool writeLineAnchor )

overridevirtual

Implements OutputCodeIntf.

Definition at line 956 of file htmlgen.cpp.

{
  m_lastLineInfo = LineInfo(ref,filename,anchor,l,writeLineAnchor);
  if (m_hide) return;
  const int maxLineNrStr = 10;
  char lineNumber[maxLineNrStr];
  char lineAnchor[maxLineNrStr];
  snprintf(lineNumber,maxLineNrStr,"%5d",l);
  snprintf(lineAnchor,maxLineNrStr,"l%05d",l);
 
  //printf("writeLineNumber open=%d\n",m_lineOpen);
  if (!m_lineOpen)
  {
    *m_t << "<div class=\"line\">";
    m_lineOpen = true;
  }
 
  if (writeLineAnchor) *m_t << "<a id=\"" << lineAnchor << "\" name=\"" << lineAnchor << "\"></a>";
  *m_t << "<span class=\"lineno\">";
  if (!filename.empty())
  {
    _writeCodeLink("line",ref,filename,anchor,lineNumber,DString());
  }
  else
  {
    codify(lineNumber);
  }
  *m_t << "</span>";
  m_col=0;
}

References _writeCodeLink(), codify(), DString::empty(), m_col, m_hide, m_lastLineInfo, m_lineOpen, and m_t.

Referenced by _startOpenLine().

writeTooltip()

void HtmlCodeGenerator::writeTooltip ( const DString & id, const DocLinkInfo & docInfo, const DString & decl, const DString & desc, const SourceLinkInfo & defInfo, const SourceLinkInfo & declInfo )

overridevirtual

Implements OutputCodeIntf.

Definition at line 1032 of file htmlgen.cpp.

{
  if (m_hide) return;
  *m_t << "<div class=\"ttc\" id=\"" << id << "\">";
  *m_t << "<div class=\"ttname\">";
  if (!docInfo.url.empty())
  {
    *m_t << "<a href=\"";
    DString fn = docInfo.url;
    addHtmlExtensionIfMissing(fn);
    *m_t << createHtmlUrl(m_relPath,docInfo.ref,
                          fileName()==fn,fn,docInfo.anchor);
    *m_t << "\">";
  }
  codify(docInfo.name);
  if (!docInfo.url.empty())
  {
    *m_t << "</a>";
  }
  *m_t << "</div>";
 
  if (!decl.empty())
  {
    *m_t << "<div class=\"ttdeci\">";
    codify(decl);
    *m_t << "</div>";
  }
 
  if (!desc.empty())
  {
    *m_t << "<div class=\"ttdoc\">";
    codify(desc);
    *m_t << "</div>";
  }
 
  if (!defInfo.file.empty())
  {
    *m_t << "<div class=\"ttdef\"><b>" << theTranslator->trDefinition() << "</b> ";
    if (!defInfo.url.empty())
    {
      *m_t << "<a href=\"";
      DString fn = defInfo.url;
      addHtmlExtensionIfMissing(fn);
      *m_t << createHtmlUrl(m_relPath,defInfo.ref,
                            fileName()==fn,fn,defInfo.anchor);
      *m_t << "\">";
    }
    *m_t << defInfo.file << ":" << defInfo.line;
    if (!defInfo.url.empty())
    {
      *m_t << "</a>";
    }
    *m_t << "</div>";
  }
  if (!declInfo.file.empty())
  {
    *m_t << "<div class=\"ttdecl\"><b>" << theTranslator->trDeclaration() << "</b> ";
    if (!declInfo.url.empty())
    {
      *m_t << "<a href=\"";
      DString fn = declInfo.url;
      addHtmlExtensionIfMissing(fn);
      *m_t << createHtmlUrl(m_relPath,declInfo.ref,
                            fileName()==fn,fn,declInfo.anchor);
      *m_t << "\">";
    }
    *m_t << declInfo.file << ":" << declInfo.line;
    if (!declInfo.url.empty())
    {
      *m_t << "</a>";
    }
    *m_t << "</div>";
  }
  *m_t << "</div>\n";
}

References addHtmlExtensionIfMissing(), DocLinkInfo::anchor, SourceLinkInfo::anchor, codify(), createHtmlUrl(), DString::empty(), SourceLinkInfo::file, fileName(), SourceLinkInfo::line, m_hide, m_relPath, m_t, DocLinkInfo::name, DocLinkInfo::ref, SourceLinkInfo::ref, theTranslator, Translator::trDeclaration(), Translator::trDefinition(), DocLinkInfo::url, and SourceLinkInfo::url.

Member Data Documentation

m_col

size_t HtmlCodeGenerator::m_col = 0

private

Definition at line 70 of file htmlgen.h.

Referenced by _writeCodeLink(), codify(), endCodeLine(), startCodeLine(), and writeLineNumber().

m_fileName

DString HtmlCodeGenerator::m_fileName

private

Definition at line 72 of file htmlgen.h.

Referenced by fileName(), and setFileName().

m_hide

bool HtmlCodeGenerator::m_hide = false

private

Definition at line 75 of file htmlgen.h.

Referenced by _startOpenLine(), _writeCodeLink(), codify(), endCodeFragment(), endCodeLine(), endFontClass(), endSpecialComment(), startCodeLine(), startFold(), startFontClass(), startSpecialComment(), writeCodeAnchor(), writeCodeLink(), writeLineNumber(), and writeTooltip().

m_lastLineInfo

LineInfo HtmlCodeGenerator::m_lastLineInfo

private

Definition at line 87 of file htmlgen.h.

Referenced by _startOpenLine(), and writeLineNumber().

m_lineOpen

bool HtmlCodeGenerator::m_lineOpen = false

private

Definition at line 73 of file htmlgen.h.

Referenced by _startOpenLine(), endCodeLine(), endFold(), startCodeLine(), startFold(), and writeLineNumber().

m_relPath

DString HtmlCodeGenerator::m_relPath

private

Definition at line 71 of file htmlgen.h.

Referenced by _writeCodeLink(), HtmlCodeGenerator(), setRelativePath(), and writeTooltip().

m_stripCodeComments

bool HtmlCodeGenerator::m_stripCodeComments = false

private

Definition at line 74 of file htmlgen.h.

Referenced by startSpecialComment(), and stripCodeComments().

m_stripIndentAmount

size_t HtmlCodeGenerator::m_stripIndentAmount = 0

private

Definition at line 88 of file htmlgen.h.

Referenced by codify(), and setStripIndentAmount().

m_t

TextStream* HtmlCodeGenerator::m_t

private

Definition at line 69 of file htmlgen.h.

Referenced by _startOpenLine(), _writeCodeLink(), codify(), endCodeFragment(), endCodeLine(), endFold(), endFontClass(), HtmlCodeGenerator(), HtmlCodeGenerator(), setTextStream(), startCodeFragment(), startCodeLine(), startFold(), startFontClass(), writeCodeAnchor(), writeLineNumber(), and writeTooltip().

---

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

• src/htmlgen.h
• src/htmlgen.cpp