|
|
|
|
@@ -34,14 +34,14 @@ type
|
|
|
|
|
TOutputTarget* = enum ## which document type to generate
|
|
|
|
|
outHtml, # output is HTML
|
|
|
|
|
outLatex # output is Latex
|
|
|
|
|
|
|
|
|
|
TTocEntry = object
|
|
|
|
|
|
|
|
|
|
TTocEntry = object
|
|
|
|
|
n*: PRstNode
|
|
|
|
|
refname*, header*: string
|
|
|
|
|
|
|
|
|
|
TMetaEnum* = enum
|
|
|
|
|
TMetaEnum* = enum
|
|
|
|
|
metaNone, metaTitle, metaSubtitle, metaAuthor, metaVersion
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
TRstGenerator* = object of RootObj
|
|
|
|
|
target*: TOutputTarget
|
|
|
|
|
config*: StringTableRef
|
|
|
|
|
@@ -60,7 +60,7 @@ type
|
|
|
|
|
seenIndexTerms: Table[string, int] ## \
|
|
|
|
|
## Keeps count of same text index terms to generate different identifiers
|
|
|
|
|
## for hyperlinks. See renderIndexTerm proc for details.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
PDoc = var TRstGenerator ## Alias to type less.
|
|
|
|
|
|
|
|
|
|
CodeBlockParams = object ## Stores code block params.
|
|
|
|
|
@@ -136,7 +136,7 @@ proc initRstGenerator*(g: var TRstGenerator, target: TOutputTarget,
|
|
|
|
|
g.currentSection = "Module " & fileParts.name
|
|
|
|
|
g.seenIndexTerms = initTable[string, int]()
|
|
|
|
|
g.msgHandler = msgHandler
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
let s = config["split.item.toc"]
|
|
|
|
|
if s != "": g.splitAfter = parseInt(s)
|
|
|
|
|
for i in low(g.meta)..high(g.meta): g.meta[i] = ""
|
|
|
|
|
@@ -147,23 +147,23 @@ proc writeIndexFile*(g: var TRstGenerator, outfile: string) =
|
|
|
|
|
## You previously need to add entries to the index with the `setIndexTerm()
|
|
|
|
|
## <#setIndexTerm>`_ proc. If the index is empty the file won't be created.
|
|
|
|
|
if g.theIndex.len > 0: writeFile(outfile, g.theIndex)
|
|
|
|
|
|
|
|
|
|
proc addXmlChar(dest: var string, c: char) =
|
|
|
|
|
|
|
|
|
|
proc addXmlChar(dest: var string, c: char) =
|
|
|
|
|
case c
|
|
|
|
|
of '&': add(dest, "&")
|
|
|
|
|
of '<': add(dest, "<")
|
|
|
|
|
of '>': add(dest, ">")
|
|
|
|
|
of '\"': add(dest, """)
|
|
|
|
|
else: add(dest, c)
|
|
|
|
|
|
|
|
|
|
proc addRtfChar(dest: var string, c: char) =
|
|
|
|
|
|
|
|
|
|
proc addRtfChar(dest: var string, c: char) =
|
|
|
|
|
case c
|
|
|
|
|
of '{': add(dest, "\\{")
|
|
|
|
|
of '}': add(dest, "\\}")
|
|
|
|
|
of '\\': add(dest, "\\\\")
|
|
|
|
|
else: add(dest, c)
|
|
|
|
|
|
|
|
|
|
proc addTexChar(dest: var string, c: char) =
|
|
|
|
|
|
|
|
|
|
proc addTexChar(dest: var string, c: char) =
|
|
|
|
|
case c
|
|
|
|
|
of '_': add(dest, "\\_")
|
|
|
|
|
of '{': add(dest, "\\symbol{123}")
|
|
|
|
|
@@ -183,54 +183,54 @@ proc addTexChar(dest: var string, c: char) =
|
|
|
|
|
|
|
|
|
|
var splitter*: string = "<wbr />"
|
|
|
|
|
|
|
|
|
|
proc escChar*(target: TOutputTarget, dest: var string, c: char) {.inline.} =
|
|
|
|
|
proc escChar*(target: TOutputTarget, dest: var string, c: char) {.inline.} =
|
|
|
|
|
case target
|
|
|
|
|
of outHtml: addXmlChar(dest, c)
|
|
|
|
|
of outLatex: addTexChar(dest, c)
|
|
|
|
|
|
|
|
|
|
proc nextSplitPoint*(s: string, start: int): int =
|
|
|
|
|
|
|
|
|
|
proc nextSplitPoint*(s: string, start: int): int =
|
|
|
|
|
result = start
|
|
|
|
|
while result < len(s) + 0:
|
|
|
|
|
while result < len(s) + 0:
|
|
|
|
|
case s[result]
|
|
|
|
|
of '_': return
|
|
|
|
|
of 'a'..'z':
|
|
|
|
|
if result + 1 < len(s) + 0:
|
|
|
|
|
if s[result + 1] in {'A'..'Z'}: return
|
|
|
|
|
of '_': return
|
|
|
|
|
of 'a'..'z':
|
|
|
|
|
if result + 1 < len(s) + 0:
|
|
|
|
|
if s[result + 1] in {'A'..'Z'}: return
|
|
|
|
|
else: discard
|
|
|
|
|
inc(result)
|
|
|
|
|
dec(result) # last valid index
|
|
|
|
|
|
|
|
|
|
proc esc*(target: TOutputTarget, s: string, splitAfter = -1): string =
|
|
|
|
|
|
|
|
|
|
proc esc*(target: TOutputTarget, s: string, splitAfter = -1): string =
|
|
|
|
|
result = ""
|
|
|
|
|
if splitAfter >= 0:
|
|
|
|
|
if splitAfter >= 0:
|
|
|
|
|
var partLen = 0
|
|
|
|
|
var j = 0
|
|
|
|
|
while j < len(s):
|
|
|
|
|
while j < len(s):
|
|
|
|
|
var k = nextSplitPoint(s, j)
|
|
|
|
|
if (splitter != " ") or (partLen + k - j + 1 > splitAfter):
|
|
|
|
|
if (splitter != " ") or (partLen + k - j + 1 > splitAfter):
|
|
|
|
|
partLen = 0
|
|
|
|
|
add(result, splitter)
|
|
|
|
|
for i in countup(j, k): escChar(target, result, s[i])
|
|
|
|
|
inc(partLen, k - j + 1)
|
|
|
|
|
j = k + 1
|
|
|
|
|
else:
|
|
|
|
|
else:
|
|
|
|
|
for i in countup(0, len(s) - 1): escChar(target, result, s[i])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
proc disp(target: TOutputTarget, xml, tex: string): string =
|
|
|
|
|
if target != outLatex: result = xml
|
|
|
|
|
if target != outLatex: result = xml
|
|
|
|
|
else: result = tex
|
|
|
|
|
|
|
|
|
|
proc dispF(target: TOutputTarget, xml, tex: string,
|
|
|
|
|
args: varargs[string]): string =
|
|
|
|
|
if target != outLatex: result = xml % args
|
|
|
|
|
|
|
|
|
|
proc dispF(target: TOutputTarget, xml, tex: string,
|
|
|
|
|
args: varargs[string]): string =
|
|
|
|
|
if target != outLatex: result = xml % args
|
|
|
|
|
else: result = tex % args
|
|
|
|
|
|
|
|
|
|
proc dispA(target: TOutputTarget, dest: var string,
|
|
|
|
|
|
|
|
|
|
proc dispA(target: TOutputTarget, dest: var string,
|
|
|
|
|
xml, tex: string, args: varargs[string]) =
|
|
|
|
|
if target != outLatex: addf(dest, xml, args)
|
|
|
|
|
else: addf(dest, tex, args)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
proc `or`(x, y: string): string {.inline.} =
|
|
|
|
|
result = if x.isNil: y else: x
|
|
|
|
|
|
|
|
|
|
@@ -248,7 +248,7 @@ proc renderRstToOut*(d: var TRstGenerator, n: PRstNode, result: var string)
|
|
|
|
|
## renderRstToOut(gen, rst, generatedHTML)
|
|
|
|
|
## echo generatedHTML
|
|
|
|
|
|
|
|
|
|
proc renderAux(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
proc renderAux(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
for i in countup(0, len(n)-1): renderRstToOut(d, n.sons[i], result)
|
|
|
|
|
|
|
|
|
|
proc renderAux(d: PDoc, n: PRstNode, frmtA, frmtB: string, result: var string) =
|
|
|
|
|
@@ -347,7 +347,7 @@ proc renderIndexTerm*(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
var term = ""
|
|
|
|
|
renderAux(d, n, term)
|
|
|
|
|
setIndexTerm(d, id, term, d.currentSection)
|
|
|
|
|
dispA(d.target, result, "<span id=\"$1\">$2</span>", "$2\\label{$1}",
|
|
|
|
|
dispA(d.target, result, "<span id=\"$1\">$2</span>", "$2\\label{$1}",
|
|
|
|
|
[id, term])
|
|
|
|
|
|
|
|
|
|
type
|
|
|
|
|
@@ -656,7 +656,7 @@ proc mergeIndexes*(dir: string): string =
|
|
|
|
|
result.add("<h2>API symbols</h2>\n")
|
|
|
|
|
result.add(generateSymbolIndex(symbols))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# ----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
proc stripTOCHTML(s: string): string =
|
|
|
|
|
@@ -677,7 +677,7 @@ proc stripTOCHTML(s: string): string =
|
|
|
|
|
result.delete(first, last)
|
|
|
|
|
first = result.find('<', first)
|
|
|
|
|
|
|
|
|
|
proc renderHeadline(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
proc renderHeadline(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
var tmp = ""
|
|
|
|
|
for i in countup(0, len(n) - 1): renderRstToOut(d, n.sons[i], tmp)
|
|
|
|
|
d.currentSection = tmp
|
|
|
|
|
@@ -700,9 +700,9 @@ proc renderHeadline(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
"id=\"$2\" href=\"#$2\">$3</a></h$1>", "\\rsth$4{$3}\\label{$2}\n",
|
|
|
|
|
[$n.level, d.tocPart[length].refname, tmp, $chr(n.level - 1 + ord('A'))])
|
|
|
|
|
else:
|
|
|
|
|
dispA(d.target, result, "\n<h$1 id=\"$2\">$3</h$1>",
|
|
|
|
|
dispA(d.target, result, "\n<h$1 id=\"$2\">$3</h$1>",
|
|
|
|
|
"\\rsth$4{$3}\\label{$2}\n", [
|
|
|
|
|
$n.level, refname, tmp,
|
|
|
|
|
$n.level, refname, tmp,
|
|
|
|
|
$chr(n.level - 1 + ord('A'))])
|
|
|
|
|
|
|
|
|
|
# Generate index entry using spaces to indicate TOC level for the output HTML.
|
|
|
|
|
@@ -710,7 +710,7 @@ proc renderHeadline(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
setIndexTerm(d, refname, tmp.stripTOCHTML,
|
|
|
|
|
spaces(max(0, n.level)) & tmp)
|
|
|
|
|
|
|
|
|
|
proc renderOverline(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
proc renderOverline(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
if d.meta[metaTitle].len == 0:
|
|
|
|
|
for i in countup(0, len(n)-1):
|
|
|
|
|
renderRstToOut(d, n.sons[i], d.meta[metaTitle])
|
|
|
|
|
@@ -723,14 +723,14 @@ proc renderOverline(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
var tmp = ""
|
|
|
|
|
for i in countup(0, len(n) - 1): renderRstToOut(d, n.sons[i], tmp)
|
|
|
|
|
d.currentSection = tmp
|
|
|
|
|
dispA(d.target, result, "<h$1 id=\"$2\"><center>$3</center></h$1>",
|
|
|
|
|
dispA(d.target, result, "<h$1 id=\"$2\"><center>$3</center></h$1>",
|
|
|
|
|
"\\rstov$4{$3}\\label{$2}\n", [$n.level,
|
|
|
|
|
rstnodeToRefname(n), tmp, $chr(n.level - 1 + ord('A'))])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
proc renderTocEntry(d: PDoc, e: TTocEntry, result: var string) =
|
|
|
|
|
|
|
|
|
|
proc renderTocEntry(d: PDoc, e: TTocEntry, result: var string) =
|
|
|
|
|
dispA(d.target, result,
|
|
|
|
|
"<li><a class=\"reference\" id=\"$1_toc\" href=\"#$1\">$2</a></li>\n",
|
|
|
|
|
"<li><a class=\"reference\" id=\"$1_toc\" href=\"#$1\">$2</a></li>\n",
|
|
|
|
|
"\\item\\label{$1_toc} $2\\ref{$1}\n", [e.refname, e.header])
|
|
|
|
|
|
|
|
|
|
proc renderTocEntries*(d: var TRstGenerator, j: var int, lvl: int,
|
|
|
|
|
@@ -759,33 +759,33 @@ proc renderImage(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
var options = ""
|
|
|
|
|
var s = getFieldValue(n, "scale")
|
|
|
|
|
if s.valid: dispA(d.target, options, " scale=\"$1\"", " scale=$1", [strip(s)])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
s = getFieldValue(n, "height")
|
|
|
|
|
if s.valid: dispA(d.target, options, " height=\"$1\"", " height=$1", [strip(s)])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
s = getFieldValue(n, "width")
|
|
|
|
|
if s.valid: dispA(d.target, options, " width=\"$1\"", " width=$1", [strip(s)])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
s = getFieldValue(n, "alt")
|
|
|
|
|
if s.valid: dispA(d.target, options, " alt=\"$1\"", "", [strip(s)])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
s = getFieldValue(n, "align")
|
|
|
|
|
if s.valid: dispA(d.target, options, " align=\"$1\"", "", [strip(s)])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
if options.len > 0: options = dispF(d.target, "$1", "[$1]", [options])
|
|
|
|
|
|
|
|
|
|
let arg = getArgument(n)
|
|
|
|
|
if arg.valid:
|
|
|
|
|
dispA(d.target, result, "<img src=\"$1\"$2 />", "\\includegraphics$2{$1}",
|
|
|
|
|
dispA(d.target, result, "<img src=\"$1\"$2 />", "\\includegraphics$2{$1}",
|
|
|
|
|
[arg, options])
|
|
|
|
|
if len(n) >= 3: renderRstToOut(d, n.sons[2], result)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
proc renderSmiley(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
dispA(d.target, result,
|
|
|
|
|
"""<img src="$1" width="15"
|
|
|
|
|
"""<img src="$1" width="15"
|
|
|
|
|
height="17" hspace="2" vspace="2" class="smiley" />""",
|
|
|
|
|
"\\includegraphics{$1}", [d.config["doc.smiley_format"] % n.text])
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
proc parseCodeBlockField(d: PDoc, n: PRstNode, params: var CodeBlockParams) =
|
|
|
|
|
## Parses useful fields which can appear before a code block.
|
|
|
|
|
##
|
|
|
|
|
@@ -880,11 +880,11 @@ proc renderCodeBlock(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
else:
|
|
|
|
|
var g: TGeneralTokenizer
|
|
|
|
|
initGeneralTokenizer(g, m.text)
|
|
|
|
|
while true:
|
|
|
|
|
while true:
|
|
|
|
|
getNextToken(g, params.lang)
|
|
|
|
|
case g.kind
|
|
|
|
|
of gtEof: break
|
|
|
|
|
of gtNone, gtWhitespace:
|
|
|
|
|
of gtEof: break
|
|
|
|
|
of gtNone, gtWhitespace:
|
|
|
|
|
add(result, substr(m.text, g.start, g.length + g.start - 1))
|
|
|
|
|
else:
|
|
|
|
|
dispA(d.target, result, "<span class=\"$2\">$1</span>", "\\span$2{$1}", [
|
|
|
|
|
@@ -893,36 +893,36 @@ proc renderCodeBlock(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
deinitGeneralTokenizer(g)
|
|
|
|
|
dispA(d.target, result, blockEnd, "\n\\end{rstpre}\n")
|
|
|
|
|
|
|
|
|
|
proc renderContainer(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
proc renderContainer(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
var tmp = ""
|
|
|
|
|
renderRstToOut(d, n.sons[2], tmp)
|
|
|
|
|
var arg = strip(getArgument(n))
|
|
|
|
|
if arg == "":
|
|
|
|
|
if arg == "":
|
|
|
|
|
dispA(d.target, result, "<div>$1</div>", "$1", [tmp])
|
|
|
|
|
else:
|
|
|
|
|
dispA(d.target, result, "<div class=\"$1\">$2</div>", "$2", [arg, tmp])
|
|
|
|
|
|
|
|
|
|
proc texColumns(n: PRstNode): string =
|
|
|
|
|
|
|
|
|
|
proc texColumns(n: PRstNode): string =
|
|
|
|
|
result = ""
|
|
|
|
|
for i in countup(1, len(n)): add(result, "|X")
|
|
|
|
|
|
|
|
|
|
proc renderField(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
|
|
|
|
|
proc renderField(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
var b = false
|
|
|
|
|
if d.target == outLatex:
|
|
|
|
|
if d.target == outLatex:
|
|
|
|
|
var fieldname = addNodes(n.sons[0])
|
|
|
|
|
var fieldval = esc(d.target, strip(addNodes(n.sons[1])))
|
|
|
|
|
if cmpIgnoreStyle(fieldname, "author") == 0 or
|
|
|
|
|
if cmpIgnoreStyle(fieldname, "author") == 0 or
|
|
|
|
|
cmpIgnoreStyle(fieldname, "authors") == 0:
|
|
|
|
|
if d.meta[metaAuthor].len == 0:
|
|
|
|
|
d.meta[metaAuthor] = fieldval
|
|
|
|
|
b = true
|
|
|
|
|
elif cmpIgnoreStyle(fieldname, "version") == 0:
|
|
|
|
|
elif cmpIgnoreStyle(fieldname, "version") == 0:
|
|
|
|
|
if d.meta[metaVersion].len == 0:
|
|
|
|
|
d.meta[metaVersion] = fieldval
|
|
|
|
|
b = true
|
|
|
|
|
if not b:
|
|
|
|
|
renderAux(d, n, "<tr>$1</tr>\n", "$1", result)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
proc renderRstToOut(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
if n == nil: return
|
|
|
|
|
case n.kind
|
|
|
|
|
@@ -947,54 +947,54 @@ proc renderRstToOut(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
of rnDefBody: renderAux(d, n, "<dd>$1</dd>\n", "$1\n", result)
|
|
|
|
|
of rnFieldList:
|
|
|
|
|
var tmp = ""
|
|
|
|
|
for i in countup(0, len(n) - 1):
|
|
|
|
|
for i in countup(0, len(n) - 1):
|
|
|
|
|
renderRstToOut(d, n.sons[i], tmp)
|
|
|
|
|
if tmp.len != 0:
|
|
|
|
|
if tmp.len != 0:
|
|
|
|
|
dispA(d.target, result,
|
|
|
|
|
"<table class=\"docinfo\" frame=\"void\" rules=\"none\">" &
|
|
|
|
|
"<col class=\"docinfo-name\" />" &
|
|
|
|
|
"<col class=\"docinfo-content\" />" &
|
|
|
|
|
"<col class=\"docinfo-content\" />" &
|
|
|
|
|
"<tbody valign=\"top\">$1" &
|
|
|
|
|
"</tbody></table>",
|
|
|
|
|
"\\begin{description}$1\\end{description}\n",
|
|
|
|
|
"</tbody></table>",
|
|
|
|
|
"\\begin{description}$1\\end{description}\n",
|
|
|
|
|
[tmp])
|
|
|
|
|
of rnField: renderField(d, n, result)
|
|
|
|
|
of rnFieldName:
|
|
|
|
|
of rnFieldName:
|
|
|
|
|
renderAux(d, n, "<th class=\"docinfo-name\">$1:</th>",
|
|
|
|
|
"\\item[$1:]", result)
|
|
|
|
|
of rnFieldBody:
|
|
|
|
|
of rnFieldBody:
|
|
|
|
|
renderAux(d, n, "<td>$1</td>", " $1\n", result)
|
|
|
|
|
of rnIndex:
|
|
|
|
|
of rnIndex:
|
|
|
|
|
renderRstToOut(d, n.sons[2], result)
|
|
|
|
|
of rnOptionList:
|
|
|
|
|
renderAux(d, n, "<table frame=\"void\">$1</table>",
|
|
|
|
|
of rnOptionList:
|
|
|
|
|
renderAux(d, n, "<table frame=\"void\">$1</table>",
|
|
|
|
|
"\\begin{description}\n$1\\end{description}\n", result)
|
|
|
|
|
of rnOptionListItem:
|
|
|
|
|
of rnOptionListItem:
|
|
|
|
|
renderAux(d, n, "<tr>$1</tr>\n", "$1", result)
|
|
|
|
|
of rnOptionGroup:
|
|
|
|
|
of rnOptionGroup:
|
|
|
|
|
renderAux(d, n, "<th align=\"left\">$1</th>", "\\item[$1]", result)
|
|
|
|
|
of rnDescription:
|
|
|
|
|
of rnDescription:
|
|
|
|
|
renderAux(d, n, "<td align=\"left\">$1</td>\n", " $1\n", result)
|
|
|
|
|
of rnOption, rnOptionString, rnOptionArgument:
|
|
|
|
|
of rnOption, rnOptionString, rnOptionArgument:
|
|
|
|
|
doAssert false, "renderRstToOut"
|
|
|
|
|
of rnLiteralBlock:
|
|
|
|
|
renderAux(d, n, "<pre>$1</pre>\n",
|
|
|
|
|
renderAux(d, n, "<pre>$1</pre>\n",
|
|
|
|
|
"\\begin{rstpre}\n$1\n\\end{rstpre}\n", result)
|
|
|
|
|
of rnQuotedLiteralBlock:
|
|
|
|
|
of rnQuotedLiteralBlock:
|
|
|
|
|
doAssert false, "renderRstToOut"
|
|
|
|
|
of rnLineBlock:
|
|
|
|
|
of rnLineBlock:
|
|
|
|
|
renderAux(d, n, "<p>$1</p>", "$1\n\n", result)
|
|
|
|
|
of rnLineBlockItem:
|
|
|
|
|
of rnLineBlockItem:
|
|
|
|
|
renderAux(d, n, "$1<br />", "$1\\\\\n", result)
|
|
|
|
|
of rnBlockQuote:
|
|
|
|
|
renderAux(d, n, "<blockquote><p>$1</p></blockquote>\n",
|
|
|
|
|
of rnBlockQuote:
|
|
|
|
|
renderAux(d, n, "<blockquote><p>$1</p></blockquote>\n",
|
|
|
|
|
"\\begin{quote}$1\\end{quote}\n", result)
|
|
|
|
|
of rnTable, rnGridTable:
|
|
|
|
|
renderAux(d, n,
|
|
|
|
|
"<table border=\"1\" class=\"docutils\">$1</table>",
|
|
|
|
|
of rnTable, rnGridTable:
|
|
|
|
|
renderAux(d, n,
|
|
|
|
|
"<table border=\"1\" class=\"docutils\">$1</table>",
|
|
|
|
|
"\\begin{table}\\begin{rsttab}{" &
|
|
|
|
|
texColumns(n) & "|}\n\\hline\n$1\\end{rsttab}\\end{table}", result)
|
|
|
|
|
of rnTableRow:
|
|
|
|
|
of rnTableRow:
|
|
|
|
|
if len(n) >= 1:
|
|
|
|
|
if d.target == outLatex:
|
|
|
|
|
#var tmp = ""
|
|
|
|
|
@@ -1007,25 +1007,25 @@ proc renderRstToOut(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
result.add("<tr>")
|
|
|
|
|
renderAux(d, n, result)
|
|
|
|
|
result.add("</tr>\n")
|
|
|
|
|
of rnTableDataCell:
|
|
|
|
|
of rnTableDataCell:
|
|
|
|
|
renderAux(d, n, "<td>$1</td>", "$1", result)
|
|
|
|
|
of rnTableHeaderCell:
|
|
|
|
|
of rnTableHeaderCell:
|
|
|
|
|
renderAux(d, n, "<th>$1</th>", "\\textbf{$1}", result)
|
|
|
|
|
of rnLabel:
|
|
|
|
|
of rnLabel:
|
|
|
|
|
doAssert false, "renderRstToOut" # used for footnotes and other
|
|
|
|
|
of rnFootnote:
|
|
|
|
|
of rnFootnote:
|
|
|
|
|
doAssert false, "renderRstToOut" # a footnote
|
|
|
|
|
of rnCitation:
|
|
|
|
|
of rnCitation:
|
|
|
|
|
doAssert false, "renderRstToOut" # similar to footnote
|
|
|
|
|
of rnRef:
|
|
|
|
|
of rnRef:
|
|
|
|
|
var tmp = ""
|
|
|
|
|
renderAux(d, n, tmp)
|
|
|
|
|
dispA(d.target, result,
|
|
|
|
|
"<a class=\"reference external\" href=\"#$2\">$1</a>",
|
|
|
|
|
"$1\\ref{$2}", [tmp, rstnodeToRefname(n)])
|
|
|
|
|
of rnStandaloneHyperlink:
|
|
|
|
|
renderAux(d, n,
|
|
|
|
|
"<a class=\"reference external\" href=\"$1\">$1</a>",
|
|
|
|
|
of rnStandaloneHyperlink:
|
|
|
|
|
renderAux(d, n,
|
|
|
|
|
"<a class=\"reference external\" href=\"$1\">$1</a>",
|
|
|
|
|
"\\href{$1}{$1}", result)
|
|
|
|
|
of rnHyperlink:
|
|
|
|
|
var tmp0 = ""
|
|
|
|
|
@@ -1042,11 +1042,11 @@ proc renderRstToOut(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
of rnRawLatex:
|
|
|
|
|
if d.target == outLatex:
|
|
|
|
|
result.add addNodes(lastSon(n))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
of rnImage, rnFigure: renderImage(d, n, result)
|
|
|
|
|
of rnCodeBlock: renderCodeBlock(d, n, result)
|
|
|
|
|
of rnContainer: renderContainer(d, n, result)
|
|
|
|
|
of rnSubstitutionReferences, rnSubstitutionDef:
|
|
|
|
|
of rnSubstitutionReferences, rnSubstitutionDef:
|
|
|
|
|
renderAux(d, n, "|$1|", "|$1|", result)
|
|
|
|
|
of rnDirective:
|
|
|
|
|
renderAux(d, n, "", "", result)
|
|
|
|
|
@@ -1063,15 +1063,15 @@ proc renderRstToOut(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
of rnStrongEmphasis:
|
|
|
|
|
renderAux(d, n, "<strong>$1</strong>", "\\textbf{$1}", result)
|
|
|
|
|
of rnTripleEmphasis:
|
|
|
|
|
renderAux(d, n, "<strong><em>$1</em></strong>",
|
|
|
|
|
renderAux(d, n, "<strong><em>$1</em></strong>",
|
|
|
|
|
"\\textbf{emph{$1}}", result)
|
|
|
|
|
of rnInterpretedText:
|
|
|
|
|
renderAux(d, n, "<cite>$1</cite>", "\\emph{$1}", result)
|
|
|
|
|
of rnIdx:
|
|
|
|
|
renderIndexTerm(d, n, result)
|
|
|
|
|
of rnInlineLiteral:
|
|
|
|
|
renderAux(d, n,
|
|
|
|
|
"<tt class=\"docutils literal\"><span class=\"pre\">$1</span></tt>",
|
|
|
|
|
of rnInlineLiteral:
|
|
|
|
|
renderAux(d, n,
|
|
|
|
|
"<tt class=\"docutils literal\"><span class=\"pre\">$1</span></tt>",
|
|
|
|
|
"\\texttt{$1}", result)
|
|
|
|
|
of rnSmiley: renderSmiley(d, n, result)
|
|
|
|
|
of rnLeaf: result.add(esc(d.target, n.text))
|
|
|
|
|
@@ -1082,55 +1082,55 @@ proc renderRstToOut(d: PDoc, n: PRstNode, result: var string) =
|
|
|
|
|
|
|
|
|
|
# -----------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
proc getVarIdx(varnames: openArray[string], id: string): int =
|
|
|
|
|
for i in countup(0, high(varnames)):
|
|
|
|
|
if cmpIgnoreStyle(varnames[i], id) == 0:
|
|
|
|
|
proc getVarIdx(varnames: openArray[string], id: string): int =
|
|
|
|
|
for i in countup(0, high(varnames)):
|
|
|
|
|
if cmpIgnoreStyle(varnames[i], id) == 0:
|
|
|
|
|
return i
|
|
|
|
|
result = -1
|
|
|
|
|
|
|
|
|
|
proc formatNamedVars*(frmt: string, varnames: openArray[string],
|
|
|
|
|
varvalues: openArray[string]): string =
|
|
|
|
|
proc formatNamedVars*(frmt: string, varnames: openArray[string],
|
|
|
|
|
varvalues: openArray[string]): string =
|
|
|
|
|
var i = 0
|
|
|
|
|
var L = len(frmt)
|
|
|
|
|
result = ""
|
|
|
|
|
var num = 0
|
|
|
|
|
while i < L:
|
|
|
|
|
if frmt[i] == '$':
|
|
|
|
|
while i < L:
|
|
|
|
|
if frmt[i] == '$':
|
|
|
|
|
inc(i) # skip '$'
|
|
|
|
|
case frmt[i]
|
|
|
|
|
of '#':
|
|
|
|
|
of '#':
|
|
|
|
|
add(result, varvalues[num])
|
|
|
|
|
inc(num)
|
|
|
|
|
inc(i)
|
|
|
|
|
of '$':
|
|
|
|
|
of '$':
|
|
|
|
|
add(result, "$")
|
|
|
|
|
inc(i)
|
|
|
|
|
of '0'..'9':
|
|
|
|
|
of '0'..'9':
|
|
|
|
|
var j = 0
|
|
|
|
|
while true:
|
|
|
|
|
while true:
|
|
|
|
|
j = (j * 10) + ord(frmt[i]) - ord('0')
|
|
|
|
|
inc(i)
|
|
|
|
|
if i > L-1 or frmt[i] notin {'0'..'9'}: break
|
|
|
|
|
if i > L-1 or frmt[i] notin {'0'..'9'}: break
|
|
|
|
|
if j > high(varvalues) + 1:
|
|
|
|
|
raise newException(ValueError, "invalid index: " & $j)
|
|
|
|
|
num = j
|
|
|
|
|
add(result, varvalues[j - 1])
|
|
|
|
|
of 'A'..'Z', 'a'..'z', '\x80'..'\xFF':
|
|
|
|
|
of 'A'..'Z', 'a'..'z', '\x80'..'\xFF':
|
|
|
|
|
var id = ""
|
|
|
|
|
while true:
|
|
|
|
|
while true:
|
|
|
|
|
add(id, frmt[i])
|
|
|
|
|
inc(i)
|
|
|
|
|
if frmt[i] notin {'A'..'Z', '_', 'a'..'z', '\x80'..'\xFF'}: break
|
|
|
|
|
if frmt[i] notin {'A'..'Z', '_', 'a'..'z', '\x80'..'\xFF'}: break
|
|
|
|
|
var idx = getVarIdx(varnames, id)
|
|
|
|
|
if idx >= 0:
|
|
|
|
|
if idx >= 0:
|
|
|
|
|
add(result, varvalues[idx])
|
|
|
|
|
else:
|
|
|
|
|
raise newException(ValueError, "unknown substitution var: " & id)
|
|
|
|
|
of '{':
|
|
|
|
|
of '{':
|
|
|
|
|
var id = ""
|
|
|
|
|
inc(i)
|
|
|
|
|
while frmt[i] != '}':
|
|
|
|
|
if frmt[i] == '\0':
|
|
|
|
|
while frmt[i] != '}':
|
|
|
|
|
if frmt[i] == '\0':
|
|
|
|
|
raise newException(ValueError, "'}' expected")
|
|
|
|
|
add(id, frmt[i])
|
|
|
|
|
inc(i)
|
|
|
|
|
@@ -1138,12 +1138,12 @@ proc formatNamedVars*(frmt: string, varnames: openArray[string],
|
|
|
|
|
# search for the variable:
|
|
|
|
|
var idx = getVarIdx(varnames, id)
|
|
|
|
|
if idx >= 0: add(result, varvalues[idx])
|
|
|
|
|
else:
|
|
|
|
|
else:
|
|
|
|
|
raise newException(ValueError, "unknown substitution var: " & id)
|
|
|
|
|
else:
|
|
|
|
|
raise newException(ValueError, "unknown substitution: $" & $frmt[i])
|
|
|
|
|
var start = i
|
|
|
|
|
while i < L:
|
|
|
|
|
while i < L:
|
|
|
|
|
if frmt[i] != '$': inc(i)
|
|
|
|
|
else: break
|
|
|
|
|
if i-1 >= start: add(result, substr(frmt, start, i - 1))
|
|
|
|
|
@@ -1163,10 +1163,10 @@ proc defaultConfig*(): StringTableRef =
|
|
|
|
|
## pages, while this proc returns just the content for procs like
|
|
|
|
|
## ``rstToHtml`` to generate the bare minimum HTML.
|
|
|
|
|
result = newStringTable(modeStyleInsensitive)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
template setConfigVar(key, val: expr) =
|
|
|
|
|
result[key] = val
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# If you need to modify these values, it might be worth updating the template
|
|
|
|
|
# file in config/nimdoc.cfg.
|
|
|
|
|
setConfigVar("split.item.toc", "20")
|
|
|
|
|
@@ -1214,7 +1214,7 @@ $content
|
|
|
|
|
|
|
|
|
|
# ---------- forum ---------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
proc rstToHtml*(s: string, options: TRstParseOptions,
|
|
|
|
|
proc rstToHtml*(s: string, options: TRstParseOptions,
|
|
|
|
|
config: StringTableRef): string =
|
|
|
|
|
## Converts an input rst string into embeddable HTML.
|
|
|
|
|
##
|
|
|
|
|
@@ -1236,13 +1236,13 @@ proc rstToHtml*(s: string, options: TRstParseOptions,
|
|
|
|
|
## output you have to create your own ``TRstGenerator`` with
|
|
|
|
|
## ``initRstGenerator`` and related procs.
|
|
|
|
|
|
|
|
|
|
proc myFindFile(filename: string): string =
|
|
|
|
|
proc myFindFile(filename: string): string =
|
|
|
|
|
# we don't find any files in online mode:
|
|
|
|
|
result = ""
|
|
|
|
|
|
|
|
|
|
const filen = "input"
|
|
|
|
|
var d: TRstGenerator
|
|
|
|
|
initRstGenerator(d, outHtml, config, filen, options, myFindFile,
|
|
|
|
|
initRstGenerator(d, outHtml, config, filen, options, myFindFile,
|
|
|
|
|
rst.defaultMsgHandler)
|
|
|
|
|
var dummyHasToc = false
|
|
|
|
|
var rst = rstParse(s, filen, 0, 1, dummyHasToc, options)
|
|
|
|
|
|