Move document format classes to new folder

2024-10-15 19:29:56 +02:00
parent 2f12a8cc93
commit b56095224a
15 changed files with 76 additions and 76 deletions
@@ -0,0 +1,737 @@
+"""
+novelWriter – ToHtml Class Tester
+=================================
+
+This file is a part of novelWriter
+Copyright 2018–2024, Veronica Berglyd Olsen
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+"""
+from __future__ import annotations
+
+import json
+
+import pytest
+
+from novelwriter import CONFIG
+from novelwriter.core.project import NWProject
+from novelwriter.formats.tohtml import ToHtml
+
+
+@pytest.mark.core
+def testFmtToHtml_ConvertHeaders(mockGUI):
+    """Test header formats in the ToHtml class."""
+    project = NWProject()
+    html = ToHtml(project)
+
+    # Novel Files Headers
+    # ===================
+
+    html._isNovel = True
+    html._isFirst = True
+
+    # Header 1
+    html._text = "# Partition\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: center;'>Partition</h1>\n"
+    )
+
+    # Header 2
+    html._text = "## Chapter Title\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 style='page-break-before: always;'>Chapter Title</h1>\n"
+    )
+
+    # Header 3
+    html._text = "### Scene Title\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h2>Scene Title</h2>\n"
+
+    # Header 4
+    html._text = "#### Section Title\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h3>Section Title</h3>\n"
+
+    # Title
+    html._text = "#! Title\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: center; page-break-before: always;'>Title</h1>\n"
+    )
+
+    # Unnumbered
+    html._text = "##! Prologue\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h1 style='page-break-before: always;'>Prologue</h1>\n"
+
+    # Note Files Headers
+    # ==================
+
+    html._isNovel = False
+    html._isFirst = True
+    html._handle = "0000000000000"
+    html.setLinkHeadings(True)
+
+    # Header 1
+    html._text = "# Heading One\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h1><a name='0000000000000:T0001'></a>Heading One</h1>\n"
+
+    # Header 2
+    html._text = "## Heading Two\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h2><a name='0000000000000:T0001'></a>Heading Two</h2>\n"
+
+    # Header 3
+    html._text = "### Heading Three\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h3><a name='0000000000000:T0001'></a>Heading Three</h3>\n"
+
+    # Header 4
+    html._text = "#### Heading Four\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h4><a name='0000000000000:T0001'></a>Heading Four</h4>\n"
+
+    # Title
+    html._text = "#! Heading One\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: center; page-break-before: always;'>"
+        "<a name='0000000000000:T0001'></a>Heading One</h1>\n"
+    )
+
+    # Unnumbered
+    html._text = "##! Heading Two\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == "<h2><a name='0000000000000:T0001'></a>Heading Two</h2>\n"
+
+
+@pytest.mark.core
+def testFmtToHtml_ConvertParagraphs(mockGUI):
+    """Test paragraph formats in the ToHtml class."""
+    project = NWProject()
+    html = ToHtml(project)
+
+    html._isNovel = True
+    html._isFirst = True
+
+    # Paragraphs
+    # ==========
+
+    # Text
+    html._text = "Some **nested bold and _italic_ and ~~strikethrough~~ text** here\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Some <strong>nested bold and <em>italic</em> and "
+        "<del>strikethrough</del> text</strong> here</p>\n"
+    )
+
+    # Shortcodes
+    html._text = (
+        "Some [b]bold[/b], [i]italic[/i], [s]strike[/s], [u]underline[/u], [m]mark[/m], "
+        "super[sup]script[/sup], sub[sub]script[/sub] here\n"
+    )
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Some <strong>bold</strong>, <em>italic</em>, <del>strike</del>, "
+        "<span style='text-decoration: underline;'>underline</span>, <mark>mark</mark>, "
+        "super<sup>script</sup>, sub<sub>script</sub> here</p>\n"
+    )
+
+    # Text w/Hard Break
+    html._text = "Line one\nLine two\nLine three\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Line one<br>Line two<br>Line three</p>\n"
+    )
+
+    # Synopsis, Short
+    html._text = "%synopsis: The synopsis ...\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == ""
+
+    html.setSynopsis(True)
+    html._text = "%synopsis: The synopsis ...\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p class='synopsis'><strong>Synopsis:</strong> The synopsis ...</p>\n"
+    )
+
+    html.setSynopsis(True)
+    html._text = "%short: A short description ...\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p class='synopsis'><strong>Short Description:</strong> A short description ...</p>\n"
+    )
+
+    # Comment
+    html._text = "% A comment ...\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == ""
+
+    html.setComments(True)
+    html._text = "% A comment ...\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p class='comment'><strong>Comment:</strong> A comment ...</p>\n"
+    )
+
+    # Keywords
+    html._text = "@char: Bod, Jane\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == ""
+
+    html.setKeywords(True)
+    html._text = "@char: Bod, Jane\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p class='meta meta-char'><span class='keyword'>Characters:</span> "
+        "<a class='tag' href='#tag_Bod'>Bod</a>, "
+        "<a class='tag' href='#tag_Jane'>Jane</a></p>\n"
+    )
+
+    # Tags
+    html._text = "@tag: Bod\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p class='meta meta-tag'><span class='keyword'>Tag:</span> "
+        "<a class='tag' name='tag_Bod'>Bod</a></p>\n"
+    )
+
+    html._text = "@tag: Bod | Nobody Owens\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p class='meta meta-tag'><span class='keyword'>Tag:</span> "
+        "<a class='tag' name='tag_Bod'>Bod</a> | <span class='optional'>Nobody Owens</a></p>\n"
+    )
+
+    # Multiple Keywords
+    html._isFirst = False
+    html.setKeywords(True)
+    html._text = "## Chapter\n\n@pov: Bod\n@plot: Main\n@location: Europe\n\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 style='page-break-before: always;'>Chapter</h1>\n"
+        "<p class='meta meta-pov' style='margin-bottom: 0;'>"
+        "<span class='keyword'>Point of View:</span> "
+        "<a class='tag' href='#tag_Bod'>Bod</a></p>\n"
+        "<p class='meta meta-plot' style='margin-bottom: 0; margin-top: 0;'>"
+        "<span class='keyword'>Plot:</span> "
+        "<a class='tag' href='#tag_Main'>Main</a></p>\n"
+        "<p class='meta meta-location' style='margin-top: 0;'>"
+        "<span class='keyword'>Locations:</span> "
+        "<a class='tag' href='#tag_Europe'>Europe</a></p>\n"
+    )
+
+    # Dialogue
+    html.setDialogueHighlight(True)
+    html._text = "## Chapter\n\nThis text \u201chas dialogue\u201d in it.\n\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 style='page-break-before: always;'>Chapter</h1>\n"
+        "<p>This text <span class='dialog'>\u201chas dialogue\u201d</span> in it.</p>\n"
+    )
+
+    # Alt. Dialogue
+    CONFIG.altDialogOpen = "::"
+    CONFIG.altDialogClose = "::"
+    html.setDialogueHighlight(True)
+    html._text = "## Chapter\n\nThis text ::has alt dialogue:: in it.\n\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 style='page-break-before: always;'>Chapter</h1>\n"
+        "<p>This text <span class='altdialog'>::has alt dialogue::</span> in it.</p>\n"
+    )
+
+    # Footnotes
+    # =========
+
+    html._text = (
+        "Text with one[footnote:fa] or two[footnote:fb] footnotes.\n\n"
+        "%footnote.fa: Footnote text A.\n\n"
+    )
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text with one<sup><a href='#footnote_1'>1</a></sup> "
+        "or two<sup>ERR</sup> footnotes.</p>\n"
+    )
+
+    html.appendFootnotes()
+    assert html.result == (
+        "<p>Text with one<sup><a href='#footnote_1'>1</a></sup> "
+        "or two<sup>ERR</sup> footnotes.</p>\n"
+        "<h3>Footnotes</h3>\n"
+        "<ol>\n"
+        "<li id='footnote_1'><p>Footnote text A.</p></li>\n"
+        "</ol>\n"
+    )
+
+
+@pytest.mark.core
+def testFmtToHtml_CloseTags(mockGUI):
+    """Test automatic closing of HTML tags for shortcodes."""
+    project = NWProject()
+    html = ToHtml(project)
+
+    html._isNovel = True
+    html._isFirst = True
+
+    # Unclosed Shortcodes
+    html._text = "Text [b][i][s][u][m][sup][sub]text text text.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text <strong><em><del><span style='text-decoration: underline;'><mark><sup><sub>"
+        "text text text.</strong></em></del></span></mark></sup></sub></p>\n"
+    )
+
+    # Double Shortcodes
+    html._text = "Text [b][i][s][u][m][sup][sub]text [b][i][s][u][m][sup][sub]text text.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text <strong><em><del><span style='text-decoration: underline;'><mark><sup><sub>"
+        "text text text.</strong></em></del></span></mark></sup></sub></p>\n"
+    )
+
+    # Redundant Close Shortcodes
+    html._text = "Text text [/b][/i][/s][/u][/m][/sup][/sub]text text.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text text text text.</p>\n"
+    )
+
+
+@pytest.mark.core
+def testFmtToHtml_ConvertDirect(mockGUI):
+    """Test the converter directly using the ToHtml class."""
+    project = NWProject()
+    html = ToHtml(project)
+
+    html._isNovel = True
+    html._handle = "0000000000000"
+    html.setLinkHeadings(True)
+
+    # Special Titles
+    # ==============
+
+    # Title
+    html._tokens = [
+        (html.T_TITLE, 1, "A Title", [], html.A_PBB | html.A_CENTRE),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: center; page-break-before: always;'>"
+        "<a name='0000000000000:T0001'></a>A Title</h1>\n"
+    )
+
+    # Unnumbered
+    html._tokens = [
+        (html.T_HEAD2, 1, "Prologue", [], html.A_PBB),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 style='page-break-before: always;'>"
+        "<a name='0000000000000:T0001'></a>Prologue</h1>\n"
+    )
+
+    # Separators
+    # ==========
+
+    # Separator
+    html._tokens = [
+        (html.T_SEP, 1, "* * *", [], html.A_CENTRE),
+    ]
+    html.doConvert()
+    assert html.result == "<p class='sep' style='text-align: center;'>* * *</p>\n"
+
+    # Skip
+    html._tokens = [
+        (html.T_SKIP, 1, "", [], html.A_NONE),
+    ]
+    html.doConvert()
+    assert html.result == "<p class='skip'>&nbsp;</p>\n"
+
+    # Alignment
+    # =========
+
+    html.setLinkHeadings(False)
+
+    # Align Left
+    html.setStyles(False)
+    html._tokens = [
+        (html.T_HEAD1, 1, "A Title", [], html.A_LEFT),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title'>A Title</h1>\n"
+    )
+
+    html.setStyles(True)
+
+    # Align Left
+    html._tokens = [
+        (html.T_HEAD1, 1, "A Title", [], html.A_LEFT),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: left;'>A Title</h1>\n"
+    )
+
+    # Align Right
+    html._tokens = [
+        (html.T_HEAD1, 1, "A Title", [], html.A_RIGHT),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: right;'>A Title</h1>\n"
+    )
+
+    # Align Centre
+    html._tokens = [
+        (html.T_HEAD1, 1, "A Title", [], html.A_CENTRE),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: center;'>A Title</h1>\n"
+    )
+
+    # Align Justify
+    html._tokens = [
+        (html.T_HEAD1, 1, "A Title", [], html.A_JUSTIFY),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' style='text-align: justify;'>A Title</h1>\n"
+    )
+
+    # Page Break
+    # ==========
+
+    # Page Break Always
+    html._tokens = [
+        (html.T_HEAD1, 1, "A Title", [], html.A_PBB | html.A_PBA),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<h1 class='title' "
+        "style='page-break-before: always; page-break-after: always;'>A Title</h1>\n"
+    )
+
+    # Indent
+    # ======
+
+    # Indent Left
+    html._tokens = [
+        (html.T_TEXT, 1, "Some text ...", [], html.A_IND_L),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<p style='margin-left: 4.00em;'>Some text ...</p>\n"
+    )
+
+    # Indent Right
+    html._tokens = [
+        (html.T_TEXT, 1, "Some text ...", [], html.A_IND_R),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<p style='margin-right: 4.00em;'>Some text ...</p>\n"
+    )
+
+    # Text Indent
+    html._tokens = [
+        (html.T_TEXT, 1, "Some text ...", [], html.A_IND_T),
+    ]
+    html.doConvert()
+    assert html.result == (
+        "<p style='text-indent: 1.40em;'>Some text ...</p>\n"
+    )
+
+
+@pytest.mark.core
+def testFmtToHtml_SpecialCases(mockGUI):
+    """Test some special cases that have caused errors in the past."""
+    project = NWProject()
+    html = ToHtml(project)
+    html._isNovel = True
+
+    # Greater/Lesser than symbols
+    # ===========================
+
+    html._text = "Text with > and < with some **bold text** in it.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text with &gt; and &lt; with some <strong>bold text</strong> in it.</p>\n"
+    )
+
+    html._text = "Text with some <**bold text**> in it.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text with some &lt;<strong>bold text</strong>&gt; in it.</p>\n"
+    )
+
+    html._text = "Let's > be > _difficult **shall** > we_?\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Let's &gt; be &gt; <em>difficult <strong>shall</strong> &gt; we</em>?</p>\n"
+    )
+
+    html._text = "Test > text _<**bold**>_ and more.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Test &gt; text <em>&lt;<strong>bold</strong>&gt;</em> and more.</p>\n"
+    )
+
+    # Test for issue #950
+    # ===================
+    # See: https://github.com/vkbo/novelWriter/issues/950
+
+    html.setComments(True)
+    html._text = "% Test > text _<**bold**>_ and more.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p class='comment'>"
+        "<strong>Comment:</strong> Test &gt; text <em>&lt;<strong>bold</strong>&gt;</em> and more."
+        "</p>\n"
+    )
+
+    html._isFirst = False
+    html._text = "## Heading <1>\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<h1 style='page-break-before: always;'>Heading &lt;1&gt;</h1>\n"
+    )
+
+    # Test for issue #1412
+    # ====================
+    # See: https://github.com/vkbo/novelWriter/issues/1412
+
+    html._text = "Test text \\**_bold_** and more.\n"
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Test text **<em>bold</em>** and more.</p>\n"
+    )
+
+
+@pytest.mark.core
+def testFmtToHtml_Save(mockGUI, fncPath):
+    """Test the save method of the ToHtml class."""
+    project = NWProject()
+    html = ToHtml(project)
+    html._isNovel = True
+
+    # Build Project
+    # =============
+
+    docText = [
+        "# My Novel\n**By Jane Doh**\n",
+        "## Chapter 1\n\nThe text of chapter one.\n",
+        "### Scene 1\n\nThe text of scene one.\n",
+        "#### A Section\n\nMore text in scene one.\n",
+        "## Chapter 2\n\nThe text of chapter two.\n",
+        "### Scene 2\n\nThe text of scene two.\n",
+        "#### A Section\n\n\tMore text in scene two.\n",
+    ]
+    resText = [(
+        "<h1 class='title' style='text-align: center;'>My Novel</h1>\n"
+        "<p><strong>By Jane Doh</strong></p>\n"
+    ), (
+        "<h1 style='page-break-before: always;'>Chapter 1</h1>\n"
+        "<p>The text of chapter one.</p>\n"
+    ), (
+        "<h2>Scene 1</h2>\n"
+        "<p>The text of scene one.</p>\n"
+    ), (
+        "<h3>A Section</h3>\n"
+        "<p>More text in scene one.</p>\n"
+    ), (
+        "<h1 style='page-break-before: always;'>Chapter 2</h1>\n"
+        "<p>The text of chapter two.</p>\n"
+    ),  (
+        "<h2>Scene 2</h2>\n"
+        "<p>The text of scene two.</p>\n"
+    ),  (
+        "<h3>A Section</h3>\n"
+        "<p>\tMore text in scene two.</p>\n"
+    )]
+
+    for i in range(len(docText)):
+        html._text = docText[i]
+        html.doPreProcessing()
+        html.tokenizeText()
+        html.doConvert()
+        assert html.result == resText[i]
+
+    assert html.fullHTML == resText
+
+    html.replaceTabs(nSpaces=2, spaceChar="&nbsp;")
+    resText[6] = "<h3>A Section</h3>\n<p>&nbsp;&nbsp;More text in scene two.</p>\n"
+
+    # Check Files
+    # ===========
+
+    # HTML
+    hStyle = html.getStyleSheet()
+    htmlDoc = (
+        "<!DOCTYPE html>\n"
+        "<html>\n"
+        "<head>\n"
+        "<meta charset='utf-8'>\n"
+        "<title></title>\n"
+        "</head>\n"
+        "<style>\n"
+        "{htmlStyle:s}\n"
+        "</style>\n"
+        "<body>\n"
+        "<article>\n"
+        "{bodyText:s}\n"
+        "</article>\n"
+        "</body>\n"
+        "</html>\n"
+    ).format(
+        htmlStyle="\n".join(hStyle),
+        bodyText="".join(resText).rstrip()
+    )
+
+    saveFile = fncPath / "outFile.htm"
+    html.saveHtml5(saveFile)
+    assert saveFile.read_text(encoding="utf-8") == htmlDoc
+
+    # JSON + HTML
+    saveFile = fncPath / "outFile.json"
+    html.saveHtmlJson(saveFile)
+    data = json.loads(saveFile.read_text(encoding="utf-8"))
+    assert data["meta"]["projectName"] == ""
+    assert data["meta"]["novelAuthor"] == ""
+    assert data["meta"]["buildTime"] > 0
+    assert data["meta"]["buildTimeStr"] != ""
+    assert data["text"]["css"] == hStyle
+    assert len(data["text"]["html"]) == len(resText)
+
+
+@pytest.mark.core
+def testFmtToHtml_Methods(mockGUI):
+    """Test all the other methods of the ToHtml class."""
+    project = NWProject()
+    html = ToHtml(project)
+    html.setKeepMarkdown(True)
+
+    # Auto-Replace, keep Unicode
+    docText = "Text with <brackets> & short–dash, long—dash …\n"
+    html._text = docText
+    html.setReplaceUnicode(False)
+    html.doPreProcessing()
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text with &lt;brackets&gt; &amp; short–dash, long—dash …</p>\n"
+    )
+
+    # Auto-Replace, replace Unicode
+    docText = "Text with <brackets> & short–dash, long—dash …\n"
+    html._text = docText
+    html.setReplaceUnicode(True)
+    html.doPreProcessing()
+    html.tokenizeText()
+    html.doConvert()
+    assert html.result == (
+        "<p>Text with &lt;brackets&gt; &amp; short&ndash;dash, long&mdash;dash &hellip;</p>\n"
+    )
+
+    # Result Size
+    assert html.getFullResultSize() == 147
+
+    # CSS
+    # ===
+
+    assert len(html.getStyleSheet()) > 1
+    assert "p {text-align: left;" in " ".join(html.getStyleSheet())
+    assert "p {text-align: justify;" not in " ".join(html.getStyleSheet())
+
+    html.setJustify(True)
+    assert "p {text-align: left;" not in " ".join(html.getStyleSheet())
+    assert "p {text-align: justify;" in " ".join(html.getStyleSheet())
+
+    html.setStyles(False)
+    assert html.getStyleSheet() == []
+
+
+@pytest.mark.core
+def testFmtToHtml_Format(mockGUI):
+    """Test all the formatters for the ToHtml class."""
+    project = NWProject()
+    html = ToHtml(project)
+
+    # Export Mode
+    # ===========
+
+    assert html._formatSynopsis("synopsis text", True) == (
+        "<p class='synopsis'><strong>Synopsis:</strong> synopsis text</p>\n"
+    )
+    assert html._formatSynopsis("short text", False) == (
+        "<p class='synopsis'><strong>Short Description:</strong> short text</p>\n"
+    )
+    assert html._formatComments("comment text") == (
+        "<p class='comment'><strong>Comment:</strong> comment text</p>\n"
+    )
+
+    assert html._formatKeywords("") == ("", "")
+    assert html._formatKeywords("tag: Jane") == (
+        "tag", "<span class='keyword'>Tag:</span> <a class='tag' name='tag_Jane'>Jane</a>"
+    )
+    assert html._formatKeywords("char: Bod, Jane") == (
+        "char",
+        "<span class='keyword'>Characters:</span> "
+        "<a class='tag' href='#tag_Bod'>Bod</a>, "
+        "<a class='tag' href='#tag_Jane'>Jane</a>"
+    )