bb1a778277
* Merge novel layouts and simplify the Tokenizer class * Fix core tests * Delete auto-layout code * Remove no longer needed item layouts * Remove references to deleted item layouts in test * Make some minor changes to Tokenizer class and update tests * Update test reference files * Update sample project * Fix a few issues with the Tokenizer * Centre some text in the sample documents * Make some minor changes to how new projects are generated * Add support for New Page and VSpace commands to the Tokenizer * Remove Title and Page layouts and add codes for page break and vertical space * Add document layout and fix some issues in index class with new title formats * Update tests and reference files * Bump the project file version and fix a minor issue in items class * Update tests and test coverage * Clean up some warnings and issues in tests
740 lines
25 KiB
Python
740 lines
25 KiB
Python
"""
|
||
novelWriter – Text Tokenizer
|
||
============================
|
||
Splits a piece of novelWriter markdown text into its elements
|
||
|
||
File History:
|
||
Created: 2019-05-05 [0.0.1]
|
||
|
||
This file is a part of novelWriter
|
||
Copyright 2018–2021, 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/>.
|
||
"""
|
||
|
||
import nw
|
||
import re
|
||
import logging
|
||
|
||
from operator import itemgetter
|
||
from functools import partial
|
||
|
||
from PyQt5.QtCore import QCoreApplication, QRegularExpression
|
||
|
||
from nw.enum import nwItemLayout, nwItemType
|
||
from nw.common import numberToRoman, checkInt
|
||
from nw.constants import nwConst, nwRegEx, nwUnicode
|
||
from nw.core.document import NWDoc
|
||
|
||
logger = logging.getLogger(__name__)
|
||
|
||
|
||
class Tokenizer():
|
||
|
||
# In-Text Format
|
||
FMT_B_B = 1 # Begin bold
|
||
FMT_B_E = 2 # End bold
|
||
FMT_I_B = 3 # Begin italics
|
||
FMT_I_E = 4 # End italics
|
||
FMT_D_B = 5 # Begin strikeout
|
||
FMT_D_E = 6 # End strikeout
|
||
|
||
# Block Type
|
||
T_EMPTY = 1 # Empty line (new paragraph)
|
||
T_SYNOPSIS = 2 # Synopsis comment
|
||
T_COMMENT = 3 # Comment line
|
||
T_KEYWORD = 4 # Command line
|
||
T_TITLE = 5 # Title
|
||
T_UNNUM = 6 # Unnumbered
|
||
T_HEAD1 = 7 # Header 1
|
||
T_HEAD2 = 8 # Header 2
|
||
T_HEAD3 = 9 # Header 3
|
||
T_HEAD4 = 10 # Header 4
|
||
T_TEXT = 11 # Text line
|
||
T_SEP = 12 # Scene separator
|
||
T_SKIP = 13 # Paragraph break
|
||
|
||
# Block Style
|
||
A_NONE = 0x0000 # No special style
|
||
A_LEFT = 0x0001 # Left aligned
|
||
A_RIGHT = 0x0002 # Right aligned
|
||
A_CENTRE = 0x0004 # Centred
|
||
A_JUSTIFY = 0x0008 # Justified
|
||
A_PBB = 0x0010 # Page break before
|
||
A_PBA = 0x0020 # Page break after
|
||
A_Z_TOPMRG = 0x0040 # Zero top margin
|
||
A_Z_BTMMRG = 0x0080 # Zero bottom margin
|
||
A_IND_L = 0x0100 # Left indentation
|
||
A_IND_R = 0x0200 # Right indentation
|
||
|
||
def __init__(self, theProject):
|
||
|
||
self.theProject = theProject
|
||
self.theParent = theProject.theParent
|
||
self.mainConf = nw.CONFIG
|
||
|
||
# Data Variables
|
||
self.theText = "" # The raw text to be tokenized
|
||
self.theHandle = None # The handle associated with the text
|
||
self.theItem = None # The NWItem associated with the handle
|
||
self.theTokens = [] # The list of the processed tokens
|
||
self.theResult = "" # The result of the last document
|
||
|
||
self.keepMarkdown = False # Whether to keep the markdown text
|
||
self.theMarkdown = [] # The result novelWriter markdown of all documents
|
||
|
||
# User Settings
|
||
self.textFont = "Serif" # Output text font
|
||
self.textSize = 11 # Output text size
|
||
self.textFixed = False # Fixed width text
|
||
self.lineHeight = 1.15 # Line height in units of em
|
||
self.blockIndent = 4.00 # Block indent in units of em
|
||
self.doJustify = False # Justify text
|
||
self.doBodyText = True # Include body text
|
||
self.doSynopsis = False # Also process synopsis comments
|
||
self.doComments = False # Also process comments
|
||
self.doKeywords = False # Also process keywords like tags and references
|
||
|
||
# Margins
|
||
self.marginTitle = (1.000, 0.500)
|
||
self.marginHead1 = (1.000, 0.500)
|
||
self.marginHead2 = (0.834, 0.500)
|
||
self.marginHead3 = (0.584, 0.500)
|
||
self.marginHead4 = (0.584, 0.500)
|
||
self.marginText = (0.000, 0.584)
|
||
self.marginMeta = (0.000, 0.584)
|
||
|
||
# Title Formats
|
||
self.fmtTitle = "%title%" # Formatting for titles
|
||
self.fmtChapter = "%title%" # Formatting for numbered chapters
|
||
self.fmtUnNum = "%title%" # Formatting for unnumbered chapters
|
||
self.fmtScene = "%title%" # Formatting for scenes
|
||
self.fmtSection = "%title%" # Formatting for sections
|
||
|
||
self.hideScene = False # Do not include scene headers
|
||
self.hideSection = False # Do not include section headers
|
||
|
||
self.linkHeaders = False # Add an anchor before headers
|
||
|
||
# Instance Variables
|
||
self.numChapter = 0 # Counter for chapter numbers
|
||
self.numChScene = 0 # Counter for scene number within chapter
|
||
self.numAbsScene = 0 # Counter for scene number within novel
|
||
self.firstScene = False # Flag to indicate that the first scene of the chapter
|
||
|
||
# This File
|
||
self.isNone = False
|
||
self.isNovel = False
|
||
self.isNote = False
|
||
self.isFirst = True
|
||
|
||
# Error Handling
|
||
self.errData = []
|
||
|
||
# Function Mapping
|
||
self._localLookup = self.theProject.localLookup
|
||
self.tr = partial(QCoreApplication.translate, "Tokenizer")
|
||
|
||
# Cached Translations
|
||
self._trSynopsis = self.tr("Synopsis")
|
||
|
||
return
|
||
|
||
##
|
||
# Setters
|
||
##
|
||
|
||
def setTitleFormat(self, fmtTitle):
|
||
self.fmtTitle = fmtTitle
|
||
return
|
||
|
||
def setChapterFormat(self, fmtChapter):
|
||
self.fmtChapter = fmtChapter
|
||
return
|
||
|
||
def setUnNumberedFormat(self, fmtUnNum):
|
||
self.fmtUnNum = fmtUnNum
|
||
return
|
||
|
||
def setSceneFormat(self, fmtScene, hideScene):
|
||
self.fmtScene = fmtScene
|
||
self.hideScene = hideScene
|
||
return
|
||
|
||
def setSectionFormat(self, fmtSection, hideSection):
|
||
self.fmtSection = fmtSection
|
||
self.hideSection = hideSection
|
||
return
|
||
|
||
def setFont(self, textFont, textSize, textFixed=False):
|
||
self.textFont = textFont
|
||
self.textSize = round(int(textSize))
|
||
self.textFixed = textFixed
|
||
return
|
||
|
||
def setLineHeight(self, lineHeight):
|
||
self.lineHeight = min(max(float(lineHeight), 0.5), 5.0)
|
||
return
|
||
|
||
def setBlockIndent(self, blockIndent):
|
||
self.blockIndent = min(max(float(blockIndent), 0.0), 10.0)
|
||
return
|
||
|
||
def setJustify(self, doJustify):
|
||
self.doJustify = doJustify
|
||
return
|
||
|
||
def setTitleMargins(self, mUpper, mLower):
|
||
self.marginTitle = (float(mUpper), float(mLower))
|
||
return
|
||
|
||
def setHead1Margins(self, mUpper, mLower):
|
||
self.marginHead1 = (float(mUpper), float(mLower))
|
||
return
|
||
|
||
def setHead2Margins(self, mUpper, mLower):
|
||
self.marginHead2 = (float(mUpper), float(mLower))
|
||
return
|
||
|
||
def setHead3Margins(self, mUpper, mLower):
|
||
self.marginHead3 = (float(mUpper), float(mLower))
|
||
return
|
||
|
||
def setHead4Margins(self, mUpper, mLower):
|
||
self.marginHead4 = (float(mUpper), float(mLower))
|
||
return
|
||
|
||
def setTextMargins(self, mUpper, mLower):
|
||
self.marginText = (float(mUpper), float(mLower))
|
||
return
|
||
|
||
def setMetaMargins(self, mUpper, mLower):
|
||
self.marginMeta = (float(mUpper), float(mLower))
|
||
return
|
||
|
||
def setLinkHeaders(self, linkHeaders):
|
||
self.linkHeaders = linkHeaders
|
||
return
|
||
|
||
def setBodyText(self, doBodyText):
|
||
self.doBodyText = doBodyText
|
||
return
|
||
|
||
def setSynopsis(self, doSynopsis):
|
||
self.doSynopsis = doSynopsis
|
||
return
|
||
|
||
def setComments(self, doComments):
|
||
self.doComments = doComments
|
||
return
|
||
|
||
def setKeywords(self, doKeywords):
|
||
self.doKeywords = doKeywords
|
||
return
|
||
|
||
def setKeepMarkdown(self, keepMarkdown):
|
||
self.keepMarkdown = keepMarkdown
|
||
return
|
||
|
||
##
|
||
# Class Methods
|
||
##
|
||
|
||
def addRootHeading(self, theHandle):
|
||
"""Add a heading at the start of a new root folder.
|
||
"""
|
||
theItem = self.theProject.projTree[theHandle]
|
||
if theItem is None:
|
||
return False
|
||
|
||
if theItem.itemType != nwItemType.ROOT:
|
||
return False
|
||
|
||
if self.isFirst:
|
||
textAlign = self.A_CENTRE
|
||
self.isFirst = False
|
||
else:
|
||
textAlign = self.A_PBB | self.A_CENTRE
|
||
|
||
theTitle = "%s: %s" % (self._localLookup("Notes"), theItem.itemName)
|
||
self.theTokens = []
|
||
self.theTokens.append((
|
||
self.T_TITLE, 0, theTitle, None, textAlign
|
||
))
|
||
if self.keepMarkdown:
|
||
self.theMarkdown.append("# %s\n\n" % theTitle)
|
||
|
||
return True
|
||
|
||
def setText(self, theHandle, theText=None):
|
||
"""Set the text for the tokenizer from a handle. If theText is
|
||
not set, load it from the file.
|
||
"""
|
||
self.theHandle = theHandle
|
||
self.theItem = self.theProject.projTree[theHandle]
|
||
if self.theItem is None:
|
||
return False
|
||
|
||
self.theText = ""
|
||
if theText is not None:
|
||
# If the text is set, just use that
|
||
self.theText = theText
|
||
else:
|
||
# Otherwise, load it from file
|
||
theDoc = NWDoc(self.theProject, theHandle)
|
||
theText = theDoc.readDocument()
|
||
if theText:
|
||
self.theText = theText
|
||
|
||
docSize = len(self.theText)
|
||
if docSize > nwConst.MAX_DOCSIZE:
|
||
errVal = self.tr("Document '{0}' is too big ({1} MB). Skipping.").format(
|
||
self.theItem.itemName, f"{docSize/1.0e6:.2f}"
|
||
)
|
||
self.theText = "# %s\n\n%s\n\n" % (self.tr("ERROR"), errVal)
|
||
self.errData.append(errVal)
|
||
|
||
self.isNone = self.theItem.itemLayout == nwItemLayout.NO_LAYOUT
|
||
self.isNovel = self.theItem.itemLayout == nwItemLayout.DOCUMENT
|
||
self.isNote = self.theItem.itemLayout == nwItemLayout.NOTE
|
||
|
||
return True
|
||
|
||
def doPreProcessing(self):
|
||
"""Run trough the various replace doctionaries.
|
||
"""
|
||
# Process the user's auto-replace dictionary
|
||
if len(self.theProject.autoReplace) > 0:
|
||
repDict = {}
|
||
for aKey, aVal in self.theProject.autoReplace.items():
|
||
repDict["<%s>" % aKey] = aVal
|
||
xRep = re.compile("|".join([re.escape(k) for k in repDict.keys()]), flags=re.DOTALL)
|
||
self.theText = xRep.sub(lambda x: repDict[x.group(0)], self.theText)
|
||
|
||
# Process the character translation map
|
||
trDict = {nwUnicode.U_MAPOSS: nwUnicode.U_RSQUO}
|
||
self.theText = self.theText.translate(str.maketrans(trDict))
|
||
|
||
return
|
||
|
||
def doPostProcessing(self):
|
||
"""Do some postprocessing. Overloaded by subclasses. This just
|
||
does the standard escaped characters.
|
||
"""
|
||
escapeDict = {
|
||
r"\*": "*",
|
||
r"\~": "~",
|
||
r"\_": "_",
|
||
}
|
||
escReplace = re.compile(
|
||
"|".join([re.escape(k) for k in escapeDict.keys()]), flags=re.DOTALL
|
||
)
|
||
self.theResult = escReplace.sub(
|
||
lambda x: escapeDict[x.group(0)], self.theResult
|
||
)
|
||
return
|
||
|
||
def tokenizeText(self):
|
||
"""Scan the text for either lines starting with specific
|
||
characters that indicate headers, comments, commands etc, or
|
||
just contain plain text. In the case of plain text, apply the
|
||
same RegExes that the syntax highlighter uses and save the
|
||
locations of these formatting tags into the token array.
|
||
|
||
The format of the token list is an entry with a five-tuple for
|
||
each line in the file. The tuple is as follows:
|
||
1: The type of the block, self.T_*
|
||
2: The line in file where this block occurred
|
||
3: The text content of the block, without leading tags
|
||
4: The internal formatting map of the text, self.FMT_*
|
||
5: The style of the block, self.A_*
|
||
"""
|
||
# RegExes for adding formatting tags within text lines
|
||
rxFormats = [
|
||
(QRegularExpression(nwRegEx.FMT_EI), [None, self.FMT_I_B, None, self.FMT_I_E]),
|
||
(QRegularExpression(nwRegEx.FMT_EB), [None, self.FMT_B_B, None, self.FMT_B_E]),
|
||
(QRegularExpression(nwRegEx.FMT_ST), [None, self.FMT_D_B, None, self.FMT_D_E]),
|
||
]
|
||
|
||
self.theTokens = []
|
||
tmpMarkdown = []
|
||
nLine = 0
|
||
breakNext = False
|
||
for aLine in self.theText.splitlines():
|
||
nLine += 1
|
||
sLine = aLine.strip()
|
||
|
||
# Check for blank lines
|
||
if len(sLine) == 0:
|
||
self.theTokens.append((
|
||
self.T_EMPTY, nLine, "", None, self.A_NONE
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("\n")
|
||
|
||
continue
|
||
|
||
if breakNext:
|
||
sAlign = self.A_PBB
|
||
breakNext = False
|
||
else:
|
||
sAlign = self.A_NONE
|
||
|
||
# Check Line Format
|
||
# =================
|
||
|
||
if aLine[0] == "[":
|
||
# Parse special formatting line
|
||
|
||
if sLine in ("[NEWPAGE]", "[NEW PAGE]"):
|
||
breakNext = True
|
||
continue
|
||
|
||
elif sLine == "[VSPACE]":
|
||
self.theTokens.append(
|
||
(self.T_SKIP, nLine, "", None, sAlign)
|
||
)
|
||
continue
|
||
|
||
elif sLine.startswith("[VSPACE:") and sLine.endswith("]"):
|
||
nSkip = checkInt(sLine[8:-1], 0)
|
||
if nSkip >= 1:
|
||
self.theTokens.append(
|
||
(self.T_SKIP, nLine, "", None, sAlign)
|
||
)
|
||
if nSkip > 1:
|
||
self.theTokens += (nSkip - 1) * [
|
||
(self.T_SKIP, nLine, "", None, self.A_NONE)
|
||
]
|
||
continue
|
||
|
||
elif aLine[0] == "%":
|
||
cLine = aLine[1:].lstrip()
|
||
synTag = cLine[:9].lower()
|
||
if synTag == "synopsis:":
|
||
self.theTokens.append((
|
||
self.T_SYNOPSIS, nLine, cLine[9:].strip(), None, sAlign
|
||
))
|
||
if self.doSynopsis and self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
else:
|
||
self.theTokens.append((
|
||
self.T_COMMENT, nLine, aLine[1:].strip(), None, sAlign
|
||
))
|
||
if self.doComments and self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
elif aLine[0] == "@":
|
||
self.theTokens.append((
|
||
self.T_KEYWORD, nLine, aLine[1:].strip(), None, sAlign
|
||
))
|
||
if self.doKeywords and self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
elif aLine[:2] == "# ":
|
||
if self.isNovel:
|
||
sAlign |= self.A_CENTRE
|
||
|
||
if self.isNovel and not self.isFirst:
|
||
sAlign |= self.A_PBB
|
||
|
||
self.theTokens.append((
|
||
self.T_HEAD1, nLine, aLine[2:].strip(), None, sAlign
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
elif aLine[:3] == "## ":
|
||
if self.isNovel and not self.isFirst:
|
||
sAlign |= self.A_PBB
|
||
|
||
self.theTokens.append((
|
||
self.T_HEAD2, nLine, aLine[3:].strip(), None, sAlign
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
elif aLine[:4] == "### ":
|
||
self.theTokens.append((
|
||
self.T_HEAD3, nLine, aLine[4:].strip(), None, sAlign
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
elif aLine[:5] == "#### ":
|
||
self.theTokens.append((
|
||
self.T_HEAD4, nLine, aLine[5:].strip(), None, sAlign
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
elif aLine[:3] == "#! ":
|
||
if self.isNovel:
|
||
tStyle = self.T_TITLE
|
||
else:
|
||
tStyle = self.T_HEAD1
|
||
|
||
if self.isNovel and not self.isFirst:
|
||
sAlign |= self.A_PBB
|
||
|
||
self.theTokens.append((
|
||
tStyle, nLine, aLine[3:].strip(), None, sAlign | self.A_CENTRE
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
elif aLine[:4] == "##! ":
|
||
if self.isNovel:
|
||
tStyle = self.T_UNNUM
|
||
else:
|
||
tStyle = self.T_HEAD2
|
||
|
||
if self.isNovel and not self.isFirst:
|
||
sAlign |= self.A_PBB
|
||
|
||
self.theTokens.append((
|
||
tStyle, nLine, aLine[4:].strip(), None, sAlign
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
else:
|
||
if not self.doBodyText:
|
||
# Skip all body text
|
||
continue
|
||
|
||
# Check Alignment and Indentation
|
||
alnLeft = False
|
||
alnRight = False
|
||
indLeft = False
|
||
indRight = False
|
||
if aLine.startswith(">>"):
|
||
alnRight = True
|
||
aLine = aLine[2:].lstrip(" ")
|
||
elif aLine.startswith(">"):
|
||
indLeft = True
|
||
aLine = aLine[1:].lstrip(" ")
|
||
|
||
if aLine.endswith("<<"):
|
||
alnLeft = True
|
||
aLine = aLine[:-2].rstrip(" ")
|
||
elif aLine.endswith("<"):
|
||
indRight = True
|
||
aLine = aLine[:-1].rstrip(" ")
|
||
|
||
if alnLeft and alnRight:
|
||
sAlign |= self.A_CENTRE
|
||
elif alnLeft:
|
||
sAlign |= self.A_LEFT
|
||
elif alnRight:
|
||
sAlign |= self.A_RIGHT
|
||
|
||
if indLeft:
|
||
sAlign |= self.A_IND_L
|
||
if indRight:
|
||
sAlign |= self.A_IND_R
|
||
|
||
# Otherwise we use RegEx to find formatting tags within a line of text
|
||
fmtPos = []
|
||
for theRX, theKeys in rxFormats:
|
||
rxThis = theRX.globalMatch(aLine, 0)
|
||
while rxThis.hasNext():
|
||
rxMatch = rxThis.next()
|
||
for n in range(1, len(theKeys)):
|
||
if theKeys[n] is not None:
|
||
xPos = rxMatch.capturedStart(n)
|
||
xLen = rxMatch.capturedLength(n)
|
||
fmtPos.append([xPos, xLen, theKeys[n]])
|
||
|
||
# Save the line as is, but append the array of formatting locations
|
||
# sorted by position
|
||
fmtPos = sorted(fmtPos, key=itemgetter(0))
|
||
self.theTokens.append((
|
||
self.T_TEXT, nLine, aLine, fmtPos, sAlign
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("%s\n" % aLine)
|
||
|
||
# If we have content, turn off the first page flag
|
||
if self.isFirst and self.theTokens:
|
||
self.isFirst = False
|
||
|
||
# Always add an empty line at the end of the file
|
||
self.theTokens.append((
|
||
self.T_EMPTY, nLine, "", None, self.A_NONE
|
||
))
|
||
if self.keepMarkdown:
|
||
tmpMarkdown.append("\n")
|
||
|
||
if self.keepMarkdown:
|
||
self.theMarkdown.append("".join(tmpMarkdown))
|
||
|
||
# Second Pass
|
||
# ===========
|
||
# Some items need a second pass
|
||
|
||
pToken = (self.T_EMPTY, 0, "", None, self.A_NONE)
|
||
nToken = (self.T_EMPTY, 0, "", None, self.A_NONE)
|
||
tCount = len(self.theTokens)
|
||
for n, tToken in enumerate(self.theTokens):
|
||
|
||
if n > 0:
|
||
pToken = self.theTokens[n-1]
|
||
if n < tCount - 1:
|
||
nToken = self.theTokens[n+1]
|
||
|
||
if tToken[0] == self.T_KEYWORD:
|
||
aStyle = tToken[4]
|
||
if pToken[0] == self.T_KEYWORD:
|
||
aStyle |= self.A_Z_TOPMRG
|
||
if nToken[0] == self.T_KEYWORD:
|
||
aStyle |= self.A_Z_BTMMRG
|
||
self.theTokens[n] = (
|
||
tToken[0], tToken[1], tToken[2], tToken[3], aStyle
|
||
)
|
||
|
||
return
|
||
|
||
def doHeaders(self):
|
||
"""Apply formatting to the text headers for novel files. This
|
||
also applies chapter and scene numbering.
|
||
"""
|
||
if not self.isNovel:
|
||
return False
|
||
|
||
for n, tToken in enumerate(self.theTokens):
|
||
|
||
# In case we see text before a scene, we reset the flag
|
||
if tToken[0] == self.T_TEXT:
|
||
self.firstScene = False
|
||
|
||
elif tToken[0] == self.T_HEAD1:
|
||
# Partition
|
||
|
||
tTemp = self._formatHeading(self.fmtTitle, tToken[2])
|
||
self.theTokens[n] = (
|
||
tToken[0], tToken[1], tTemp, None, tToken[4]
|
||
)
|
||
|
||
elif tToken[0] in (self.T_HEAD2, self.T_UNNUM):
|
||
# Chapter
|
||
|
||
# Numbered or Unnumbered
|
||
if tToken[2].startswith("*"):
|
||
tTemp = self._formatHeading(self.fmtUnNum, tToken[2][1:].lstrip())
|
||
elif tToken[0] == self.T_UNNUM:
|
||
tTemp = self._formatHeading(self.fmtUnNum, tToken[2])
|
||
else:
|
||
self.numChapter += 1
|
||
tTemp = self._formatHeading(self.fmtChapter, tToken[2])
|
||
|
||
# Format the chapter header
|
||
self.theTokens[n] = (
|
||
tToken[0], tToken[1], tTemp, None, tToken[4]
|
||
)
|
||
|
||
# Set scene variables
|
||
self.firstScene = True
|
||
self.numChScene = 0
|
||
|
||
elif tToken[0] == self.T_HEAD3:
|
||
# Scene
|
||
|
||
self.numChScene += 1
|
||
self.numAbsScene += 1
|
||
|
||
tTemp = self._formatHeading(self.fmtScene, tToken[2])
|
||
if tTemp == "" and self.hideScene:
|
||
self.theTokens[n] = (
|
||
self.T_EMPTY, tToken[1], "", None, self.A_NONE
|
||
)
|
||
elif tTemp == "" and not self.hideScene:
|
||
if self.firstScene:
|
||
self.theTokens[n] = (
|
||
self.T_EMPTY, tToken[1], "", None, self.A_NONE
|
||
)
|
||
else:
|
||
self.theTokens[n] = (
|
||
self.T_SKIP, tToken[1], "", None, self.A_NONE
|
||
)
|
||
elif tTemp == self.fmtScene:
|
||
if self.firstScene:
|
||
self.theTokens[n] = (
|
||
self.T_EMPTY, tToken[1], "", None, self.A_NONE
|
||
)
|
||
else:
|
||
self.theTokens[n] = (
|
||
self.T_SEP, tToken[1], tTemp, None, self.A_CENTRE
|
||
)
|
||
else:
|
||
self.theTokens[n] = (
|
||
tToken[0], tToken[1], tTemp, None, self.A_NONE
|
||
)
|
||
|
||
# Definitely no longer the first scene
|
||
self.firstScene = False
|
||
|
||
elif tToken[0] == self.T_HEAD4:
|
||
# Section
|
||
|
||
tTemp = self._formatHeading(self.fmtSection, tToken[2])
|
||
if tTemp == "" and self.hideSection:
|
||
self.theTokens[n] = (
|
||
self.T_EMPTY, tToken[1], "", None, self.A_NONE
|
||
)
|
||
elif tTemp == "" and not self.hideSection:
|
||
self.theTokens[n] = (
|
||
self.T_SKIP, tToken[1], "", None, self.A_NONE
|
||
)
|
||
elif tTemp == self.fmtSection:
|
||
self.theTokens[n] = (
|
||
self.T_SEP, tToken[1], tTemp, None, self.A_CENTRE
|
||
)
|
||
else:
|
||
self.theTokens[n] = (
|
||
tToken[0], tToken[1], tTemp, None, self.A_NONE
|
||
)
|
||
|
||
return True
|
||
|
||
def saveRawMarkdown(self, savePath):
|
||
"""Save the data to a plain text file.
|
||
"""
|
||
with open(savePath, mode="w", encoding="utf-8") as outFile:
|
||
for nwdPage in self.theMarkdown:
|
||
outFile.write(nwdPage)
|
||
return
|
||
|
||
##
|
||
# Internal Functions
|
||
##
|
||
|
||
def _formatHeading(self, theTitle, theText):
|
||
"""Replaces the %keyword% strings.
|
||
"""
|
||
theTitle = theTitle.replace(r"%title%", theText)
|
||
theTitle = theTitle.replace(r"%ch%", str(self.numChapter))
|
||
theTitle = theTitle.replace(r"%sc%", str(self.numChScene))
|
||
theTitle = theTitle.replace(r"%sca%", str(self.numAbsScene))
|
||
if r"%chw%" in theTitle:
|
||
theTitle = theTitle.replace(r"%chw%", self._localLookup(self.numChapter))
|
||
if r"%chi%" in theTitle:
|
||
theTitle = theTitle.replace(r"%chi%", numberToRoman(self.numChapter, True))
|
||
if r"%chI%" in theTitle:
|
||
theTitle = theTitle.replace(r"%chI%", numberToRoman(self.numChapter, False))
|
||
|
||
return theTitle[:1].upper() + theTitle[1:]
|
||
|
||
# END Class Tokenizer
|