The TextHTMLBuilder creates a clean html markup output. More...

#include <cutelee/texthtmlbuilder.h>

Inheritance diagram for Cutelee::TextHTMLBuilder:

Public Member Functions
void	addNewline () override
void	appendLiteralText (const QString &text) override
void	appendRawText (const QString &text) override
void	beginAnchor (const QString &href={}, const QString &name={}) override
void	beginBackground (const QBrush &brush) override
void	beginEmph () override
void	beginFontFamily (const QString &family) override
void	beginFontPointSize (int size) override
void	beginForeground (const QBrush &brush) override
void	beginHeader (int level) override
void	beginList (QTextListFormat::Style type) override
void	beginListItem () override
void	beginParagraph (Qt::Alignment al=Qt::AlignLeft, qreal topMargin=0.0, qreal bottomMargin=0.0, qreal leftMargin=0.0, qreal rightMargin=0.0) override
void	beginStrikeout () override
void	beginStrong () override
void	beginSubscript () override
void	beginSuperscript () override
void	beginTable (qreal cellpadding, qreal cellspacing, const QString &width) override
void	beginTableCell (const QString &width, int colspan, int rowspan) override
void	beginTableHeaderCell (const QString &width, int colspan, int rowspan) override
void	beginTableRow () override
void	beginUnderline () override
void	endAnchor () override
void	endBackground () override
void	endEmph () override
void	endFontFamily () override
void	endFontPointSize () override
void	endForeground () override
void	endHeader (int level) override
void	endList () override
void	endListItem () override
void	endParagraph () override
void	endStrikeout () override
void	endStrong () override
void	endSubscript () override
void	endSuperscript () override
void	endTable () override
void	endTableCell () override
void	endTableHeaderCell () override
void	endTableRow () override
void	endUnderline () override
QString	getResult () override
void	insertHorizontalRule (int width=-1) override
void	insertImage (const QString &src, qreal width, qreal height) override
Public Member Functions inherited from Cutelee::AbstractMarkupBuilder
virtual	~AbstractMarkupBuilder ()

Detailed Description

This class creates html output which is as minimal as possible and restricted to the rich text features supported in Qt. (https://doc.qt.io/qt-5/richtext-html-subset.html)

The output contains only the body content, not the head element or other metadata.

eg:

<p>
  This is some <strong>formatted content</strong> in a paragraph.
</p>

instead of the content produced by Qt:

  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
"http://www.w3.org/TR/REC-html40/strict.dtd">
  <html><head><meta name="qrichtext" content="1" /><meta
http-equiv="Content-Type" content="text/html; charset=UTF-8" /><style
type="text/css">
  p, li { white-space: pre-wrap; }
  </style></head><body style=" font-family:'Sans Serif'; font-size:10pt;
font-weight:400; font-style:normal;">
  <p style=" margin-top:12px; margin-bottom:12px; margin-left:0px;
margin-right:0px; -qt-block-indent:0; text-indent:0px;">This is some <span
style=" font-weight:600;">formatted content</span> in a paragraph.
</p></body></html>

Such tags should be created separately. For example:

auto b = new TextHTMLBuilder();
auto md = new MarkupDirector(b);
md->constructContent();
QString cleanHtml(
  "<head>\n<title>%1</title>\n</head>\n<body>%2</body>\n</html>")
                  .arg(document.metaInformation(QTextDocument::DocumentTitle))
                  .arg(b->getOutput());
file.write(cleanHtml);

Font formatting information on elements is represented by individual span elements.

eg:

<span style"color:blue;">
  <span style="background-color:red;">
    Blue text on red background
  </span>
</span>

instead of

<span style="color:blue;background-color:red;">
  Blue text on red background
</span>

It my be possible to change this if necessary.

Author: Stephen Kelly steve.nosp@m.ire@.nosp@m.gmail.nosp@m..com

Definition at line 107 of file texthtmlbuilder.h.

Constructor & Destructor Documentation

◆ TextHTMLBuilder()

TextHTMLBuilder::TextHTMLBuilder ( )

Definition at line 45 of file texthtmlbuilder.cpp.

◆ ~TextHTMLBuilder()

TextHTMLBuilder::~TextHTMLBuilder ( )

override

Definition at line 50 of file texthtmlbuilder.cpp.

Member Function Documentation

◆ addNewline()

void TextHTMLBuilder::addNewline ( )

overridevirtual

Add a newline to the markup.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 281 of file texthtmlbuilder.cpp.

◆ appendLiteralText()

void TextHTMLBuilder::appendLiteralText ( const QString & text )

overridevirtual

Reimplemented from AbstractMarkupBuilder.

This implementation escapes the text before appending so that

  A sample <b>bold</b> word.

becomes

  A sample &lt;b&gt;bold&lt;/b&gt; word.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 461 of file texthtmlbuilder.cpp.

References QString::toHtmlEscaped().

◆ appendRawText()

void TextHTMLBuilder::appendRawText ( const QString & text )

overridevirtual

Append text without escaping.

This is useful if extending MarkupDirector

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 467 of file texthtmlbuilder.cpp.

◆ beginAnchor()

void TextHTMLBuilder::beginAnchor	(	const QString &	href = {},
		const QString &	name = {} )

overridevirtual

Begin a url anchor element in the markup

Parameters

href	The href of the anchor.
name	The name of the anchor.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 127 of file texthtmlbuilder.cpp.

References QString::isEmpty().

◆ beginBackground()

void TextHTMLBuilder::beginBackground ( const QBrush & brush )

overridevirtual

Begin a decorarated background element in the markup (A text background color) using brush

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 114 of file texthtmlbuilder.cpp.

References QBrush::color(), and QColor::name().

◆ beginEmph()

void TextHTMLBuilder::beginEmph ( )

overridevirtual

Begin an emphasised element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 65 of file texthtmlbuilder.cpp.

◆ beginFontFamily()

void TextHTMLBuilder::beginFontFamily ( const QString & family )

overridevirtual

Begin a new font familiy element in the markup

Parameters

family The name of the font family to begin.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 150 of file texthtmlbuilder.cpp.

◆ beginFontPointSize()

void TextHTMLBuilder::beginFontPointSize ( int size )

overridevirtual

Begin a new font point size

Parameters

size	The new size to begin.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 163 of file texthtmlbuilder.cpp.

References QString::number().

◆ beginForeground()

void TextHTMLBuilder::beginForeground ( const QBrush & brush )

overridevirtual

Begin a decorarated foreground element in the markup (A text color) using brush

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 101 of file texthtmlbuilder.cpp.

References QBrush::color(), and QColor::name().

◆ beginHeader()

void TextHTMLBuilder::beginHeader ( int level )

overridevirtual

Begin a new header element.

Parameters

level The new level to begin.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 221 of file texthtmlbuilder.cpp.

◆ beginList()

void TextHTMLBuilder::beginList ( QTextListFormat::Style style )

overridevirtual

Begin a new list element in the markup. A list element contains list items, and may contain other lists.

Parameters

style The style of list to create.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 307 of file texthtmlbuilder.cpp.

References QTextListFormat::ListCircle, QTextListFormat::ListDecimal, QTextListFormat::ListDisc, QTextListFormat::ListLowerAlpha, QTextListFormat::ListLowerRoman, QTextListFormat::ListSquare, QTextListFormat::ListUpperAlpha, and QTextListFormat::ListUpperRoman.

◆ beginListItem()

void TextHTMLBuilder::beginListItem ( )

overridevirtual

Begin a new list item in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 361 of file texthtmlbuilder.cpp.

◆ beginParagraph()

void TextHTMLBuilder::beginParagraph	(	Qt::Alignment	al = Qt::AlignLeft,
		qreal	topMargin = 0.0,
		qreal	bottomMargin = 0.0,
		qreal	leftMargin = 0.0,
		qreal	rightMargin = 0.0 )

overridevirtual

Begin a new paragraph

Parameters

al	The new paragraph alignment
topMargin	The new paragraph topMargin
bottomMargin	The new paragraph bottomMargin
leftMargin	The new paragraph leftMargin
rightMargin	The new paragraph rightMargin

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 176 of file texthtmlbuilder.cpp.

References Qt::AlignHCenter, Qt::AlignJustify, Qt::AlignLeft, Qt::Alignment, Qt::AlignRight, QString::append(), and QString::isEmpty().

◆ beginStrikeout()

void TextHTMLBuilder::beginStrikeout ( )

overridevirtual

Begin a struck out element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 89 of file texthtmlbuilder.cpp.

◆ beginStrong()

void TextHTMLBuilder::beginStrong ( )

overridevirtual

Begin a bold element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 52 of file texthtmlbuilder.cpp.

◆ beginSubscript()

void TextHTMLBuilder::beginSubscript ( )

overridevirtual

Begin a subscript element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 385 of file texthtmlbuilder.cpp.

◆ beginSuperscript()

void TextHTMLBuilder::beginSuperscript ( )

overridevirtual

Begin a superscript element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 373 of file texthtmlbuilder.cpp.

◆ beginTable()

void TextHTMLBuilder::beginTable	(	qreal	cellpadding,
		qreal	cellspacing,
		const QString &	width )

overridevirtual

Begin a table element.

Parameters

cellpadding	The padding attribute for the table.
cellspacing	The spacing attribute for the table.
width	The width of the table. May be either an integer, or a percentage value.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 397 of file texthtmlbuilder.cpp.

◆ beginTableCell()

void TextHTMLBuilder::beginTableCell	(	const QString &	width,
		int	colSpan,
		int	rowSpan )

overridevirtual

Begin a new table cell.

Parameters

width	The width of the cell.
colSpan	The column span of the cell.
rowSpan	The row span of the cell.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 426 of file texthtmlbuilder.cpp.

◆ beginTableHeaderCell()

void TextHTMLBuilder::beginTableHeaderCell	(	const QString &	width,
		int	colSpan,
		int	rowSpan )

overridevirtual

Begin a new table header cell.

Parameters

width	The width of the cell.
colSpan	The column span of the cell.
rowSpan	The row span of the cell.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 415 of file texthtmlbuilder.cpp.

◆ beginTableRow()

void TextHTMLBuilder::beginTableRow ( )

overridevirtual

Begin a new table row

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 409 of file texthtmlbuilder.cpp.

◆ beginUnderline()

void TextHTMLBuilder::beginUnderline ( )

overridevirtual

Begin an underlined element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 77 of file texthtmlbuilder.cpp.

◆ endAnchor()

void TextHTMLBuilder::endAnchor ( )

overridevirtual

Close the anchor element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 144 of file texthtmlbuilder.cpp.

◆ endBackground()

void TextHTMLBuilder::endBackground ( )

overridevirtual

Close the decorarated background element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 121 of file texthtmlbuilder.cpp.

◆ endEmph()

void TextHTMLBuilder::endEmph ( )

overridevirtual

Close the emphasised element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 71 of file texthtmlbuilder.cpp.

◆ endFontFamily()

void TextHTMLBuilder::endFontFamily ( )

overridevirtual

End font family element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 157 of file texthtmlbuilder.cpp.

◆ endFontPointSize()

void TextHTMLBuilder::endFontPointSize ( )

overridevirtual

End font point size element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 170 of file texthtmlbuilder.cpp.

◆ endForeground()

void TextHTMLBuilder::endForeground ( )

overridevirtual

Close the decorarated foreground element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 108 of file texthtmlbuilder.cpp.

◆ endHeader()

void TextHTMLBuilder::endHeader ( int level )

overridevirtual

End a header element.

Parameters

level The new level to end.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 248 of file texthtmlbuilder.cpp.

◆ endList()

void TextHTMLBuilder::endList ( )

overridevirtual

Close the list.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 340 of file texthtmlbuilder.cpp.

References QTextListFormat::ListCircle, QTextListFormat::ListDecimal, QTextListFormat::ListDisc, QTextListFormat::ListLowerAlpha, QTextListFormat::ListLowerRoman, QTextListFormat::ListSquare, QTextListFormat::ListUpperAlpha, and QTextListFormat::ListUpperRoman.

◆ endListItem()

void TextHTMLBuilder::endListItem ( )

overridevirtual

End the list item

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 367 of file texthtmlbuilder.cpp.

◆ endParagraph()

void TextHTMLBuilder::endParagraph ( )

overridevirtual

Close the paragraph in the markup.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 275 of file texthtmlbuilder.cpp.

◆ endStrikeout()

void TextHTMLBuilder::endStrikeout ( )

overridevirtual

Close the struck out element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 95 of file texthtmlbuilder.cpp.

◆ endStrong()

void TextHTMLBuilder::endStrong ( )

overridevirtual

Close the bold element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 59 of file texthtmlbuilder.cpp.

◆ endSubscript()

void TextHTMLBuilder::endSubscript ( )

overridevirtual

End subscript element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 391 of file texthtmlbuilder.cpp.

◆ endSuperscript()

void TextHTMLBuilder::endSuperscript ( )

overridevirtual

End superscript element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 379 of file texthtmlbuilder.cpp.

◆ endTable()

void TextHTMLBuilder::endTable ( )

overridevirtual

End a table element

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 437 of file texthtmlbuilder.cpp.

◆ endTableCell()

void TextHTMLBuilder::endTableCell ( )

overridevirtual

End a table cell

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 455 of file texthtmlbuilder.cpp.

◆ endTableHeaderCell()

void TextHTMLBuilder::endTableHeaderCell ( )

overridevirtual

End a table header cell

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 449 of file texthtmlbuilder.cpp.

◆ endTableRow()

void TextHTMLBuilder::endTableRow ( )

overridevirtual

End a table row

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 443 of file texthtmlbuilder.cpp.

◆ endUnderline()

void TextHTMLBuilder::endUnderline ( )

overridevirtual

Close the underlined element in the markup

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 83 of file texthtmlbuilder.cpp.

◆ getResult()

QString TextHTMLBuilder::getResult ( )

overridevirtual

Return the fully marked up result of the building process.

This may contain metadata etc, such as a head element in html.

Returns: The fully marked up text.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 473 of file texthtmlbuilder.cpp.

◆ insertHorizontalRule()

void TextHTMLBuilder::insertHorizontalRule ( int width = -1 )

overridevirtual

Insert a horizontal rule into the markup.

Parameters

width The width of the rule. Default is full width.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 287 of file texthtmlbuilder.cpp.

◆ insertImage()

void TextHTMLBuilder::insertImage	(	const QString &	url,
		qreal	width,
		qreal	height )

overridevirtual

Insert a new image element into the markup.

Parameters

url	The url of the image
width	The width of the image
height	The height of the image.

Implements Cutelee::AbstractMarkupBuilder.

Definition at line 296 of file texthtmlbuilder.cpp.

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ TextHTMLBuilder()

◆ ~TextHTMLBuilder()

Member Function Documentation

◆ addNewline()

◆ appendLiteralText()

◆ appendRawText()

◆ beginAnchor()

◆ beginBackground()

◆ beginEmph()

◆ beginFontFamily()

◆ beginFontPointSize()

◆ beginForeground()

◆ beginHeader()

◆ beginList()

◆ beginListItem()

◆ beginParagraph()

◆ beginStrikeout()

◆ beginStrong()

◆ beginSubscript()

◆ beginSuperscript()

◆ beginTable()

◆ beginTableCell()

◆ beginTableHeaderCell()

◆ beginTableRow()

◆ beginUnderline()

◆ endAnchor()

◆ endBackground()

◆ endEmph()

◆ endFontFamily()

◆ endFontPointSize()

◆ endForeground()

◆ endHeader()

◆ endList()

◆ endListItem()

◆ endParagraph()

◆ endStrikeout()

◆ endStrong()

◆ endSubscript()

◆ endSuperscript()

◆ endTable()

◆ endTableCell()

◆ endTableHeaderCell()

◆ endTableRow()

◆ endUnderline()

◆ getResult()

◆ insertHorizontalRule()

◆ insertImage()