Add documentation for Google Analytics internal template

Fixes #1654

diff --git a/docs/content/extras/aliases.md b/docs/content/extras/aliases.md
index 59c51dc94adb39811e340b5810254552c309200f..9fd252cbec63c0802f3d7dc9c0921b29c9ddae80 100644 (file)
--- a/docs/content/extras/aliases.md
+++ b/docs/content/extras/aliases.md
@@ -8,7 +8,7 @@ date: 2013-07-09
 menu:
   main:
     parent: extras
-next: /extras/builders
+next: /extras/analytics
 prev: /taxonomies/ordering
 title: Aliases
 weight: 10

diff --git a/docs/content/extras/analytics.md b/docs/content/extras/analytics.md
new file mode 100644 (file)
index 0000000..112671d
--- /dev/null
+++ b/docs/content/extras/analytics.md
@@ -0,0 +1,29 @@
+---
+date: 2016-02-06
+linktitle: Analytics
+menu:
+  main:
+    parent: extras
+next: /extras/builders
+prev: /extras/aliases
+title: Analytics in Hugo
+weight: 15
+---
+
+Hugo ships with prebuilt internal templates for Google Analytics tracking, including both synchronous and asynchronous tracking codes.
+
+## Configuring Google Analytics
+
+Provide your tracking id in your configuration file, e.g. config.yaml.
+
+    googleAnalytics = "UA-123-45"
+
+## Example
+
+Include the internal template in your templates like so:
+
+    {{ template "_internal/google_analytics.html" . }}
+
+For async include the async template:
+
+    {{ template "_internal/google_analytics_async.html" . }}

diff --git a/docs/content/extras/builders.md b/docs/content/extras/builders.md
index 50508b329ed9fae14e1a4c9c16af414541ab2721..1e5fcabb782f3795949e43f73ce7ff281486b273 100644 (file)
--- a/docs/content/extras/builders.md
+++ b/docs/content/extras/builders.md
@@ -6,7 +6,7 @@ menu:
   main:
     parent: extras
 next: /extras/comments
-prev: /extras/aliases
+prev: /extras/analytics
 title: Hugo Builders
 weight: 20
 ---

diff --git a/docs/content/overview/configuration.md b/docs/content/overview/configuration.md
index 1bd742f3660dd0f58fa69aeb1df838cbeede548a..18f4b14bd0ed4f0a3b809786cfb77d9999305e53 100644 (file)
--- a/docs/content/overview/configuration.md
+++ b/docs/content/overview/configuration.md
@@ -101,6 +101,8 @@ Following is a list of Hugo-defined variables that you can configure and their c
     editor:                     ""
     footnoteAnchorPrefix:       ""
     footnoteReturnLinkContents: ""
+    # google analytics tracking id
+    googleAnalytics:            ""
     languageCode:               ""
     layoutdir:                  "layouts"
     # Enable Logging