diff --git a/compiler/docgen.nim b/compiler/docgen.nim
index 35acf1379f..ab513d2cc8 100644
--- a/compiler/docgen.nim
+++ b/compiler/docgen.nim
@@ -23,6 +23,7 @@ type
id: int # for generating IDs
toc, section: TSections
indexValFilename: string
+ gaId: string # Google Analytics ID, null if doesn't exist
seenSymbols: StringTableRef # avoids duplicate symbol generation for HTML.
PDoc* = ref TDocumentor ## Alias to type less.
@@ -61,6 +62,8 @@ proc newDocumentor*(filename: string, config: StringTableRef): PDoc =
initRstGenerator(result[], (if gCmd != cmdRst2tex: outHtml else: outLatex),
options.gConfigVars, filename, {roSupportRawDirective},
docgenFindFile, compilerMsgHandler)
+ if config.hasKey("doc.googleAnalytics"):
+ result.gaId = config["doc.googleAnalytics"]
result.seenSymbols = newStringTable(modeCaseInsensitive)
result.id = 100
@@ -534,6 +537,7 @@ proc genOutFile(d: PDoc): PRope =
var
code, content: PRope
title = ""
+ analytics = ""
var j = 0
var tmp = ""
renderTocEntries(d[], j, 1, tmp)
@@ -553,6 +557,21 @@ proc genOutFile(d: PDoc): PRope =
# Modules get an automatic title for the HTML, but no entry in the index.
title = "Module " & extractFilename(changeFileExt(d.filename, ""))
+ # if there exists an analytics id, use it
+ if d.gaId != nil:
+ analytics = """
+
+ """ % [d.gaId]
+
let bodyname = if d.hasToc: "doc.body_toc" else: "doc.body_no_toc"
content = ropeFormatNamedVars(getConfigVar(bodyname), ["title",
"tableofcontents", "moduledesc", "date", "time", "content"],
@@ -562,10 +581,10 @@ proc genOutFile(d: PDoc): PRope =
# XXX what is this hack doing here? 'optCompileOnly' means raw output!?
code = ropeFormatNamedVars(getConfigVar("doc.file"), ["title",
"tableofcontents", "moduledesc", "date", "time",
- "content", "author", "version"],
+ "content", "author", "version", "analytics"],
[title.toRope, toc, d.modDesc, toRope(getDateStr()),
toRope(getClockStr()), content, d.meta[metaAuthor].toRope,
- d.meta[metaVersion].toRope])
+ d.meta[metaVersion].toRope, analytics.toRope])
else:
code = content
result = code
diff --git a/config/nimdoc.cfg b/config/nimdoc.cfg
index 3abae73885..3375460ccc 100644
--- a/config/nimdoc.cfg
+++ b/config/nimdoc.cfg
@@ -86,6 +86,7 @@ $moduledesc
$content
"""
+# * $analytics: Google analytics location, includes