7d63a23b0c
1d052b16 Update hosting-on-netlify.md 28b96bec Remove double brackets in Netlify hosting tutorial 373ed38b Update deployment instructions from hugo > 0.20 on Netlify 1bbb41ca Generate static assets on deploy in Nanobox tutorial 816d207f Add missing backtick in templates/views.md bf88e772 Add nanobox as a deployment option 9c37b4cc Change config's syntax order matching description d3cb05a7 Fix wrongly named default value of publishDir 4be85c54 Add link to showcase a theme setup via config file 46837195 Init and update of submodules in .gitlab-ci.yml 9e7c2827 Add CSS lang argument to code block 85aad56e Abstract the type in the lookup order 4e1e43e9 Fix broken Pygments url 65b4e79b Correct GitLab project pipelines URL 94af72b5 Fix .Data.Terms usage in taxonomy template example eb371e52 functions: Fix lang.NumFmt docs a745cd6c Fix layouts' folder name in template primer e181e637 Correct typo on GitHub pages guide (#151) 28698500 Remove HTML special chars from Windows install example 96b1f5b5 Remove not needed escape slashes in urls.md 2e05043f Add upgrade instructions using homebrew 2a14624d Fix alias in countrunes.md 5e26bb97 Update docker image for build/publish 01424887 List the internal templates a3ef5be9 Remove string concatenation from add (math) sample 43d12b44 Fix typo 89bafa49 Change to Asciidoc URI 4e14071e Removes an extra bracket (>) in single-page-templates.md 0938e423 Fix typo in http2 server push blog fac55121 Fix typo in deployment with rsync tutorial git-subtree-dir: docs git-subtree-split: 1d052b16a1290ada12f1e28c7c0c373f86741071
3.8 KiB
| title | linktitle | description | date | publishdate | lastmod | categories | menu | weight | sections_weight | draft | aliases | toc | wip | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Internal Templates | Internal Templates | Hugo ships with a group of boilerplate templates that cover the most common use cases for static websites. | 2017-03-06 | 2017-03-06 | 2017-03-06 |
|
|
168 | 168 | false | true | true |
{{% warning %}} While the following internal templates are called similar to partials, they do not observe the partial template lookup order. {{% /warning %}}
Google Analytics
Hugo ships with internal templates for Google Analytics tracking, including both synchronous and asynchronous tracking codes.
Configure Google Analytics
Provide your tracking id in your configuration file:
googleAnalytics = "UA-123-45"
googleAnalytics: "UA-123-45"
Use the Google Analytics Template
You can then include the Google Analytics internal template:
{{ template "_internal/google_analytics.html" . }}
{{ template "_internal/google_analytics_async.html" . }}
Disqus
Hugo also ships with an internal template for [Disqus comments][disqus], a popular commenting system for both static and dynamic websites. In order to effectively use Disqus, you will need to secure a Disqus "shortname" by [signing up for the free service][disqussignup].
Configure Disqus
To use Hugo's Disqus template, you first need to set a single value in your site's config.toml or config.yml:
disqusShortname = "yourdiscussshortname"
disqusShortname: "yourdiscussshortname"
You also have the option to set the following in the front matter for a given piece of content:
disqus_identifierdisqus_titledisqus_url
Use the Disqus Template
To add Disqus, include the following line in templates where you want your comments to appear:
{{ template "_internal/disqus.html" . }}
Conditional Loading of Disqus Comments
Users have noticed that enabling Disqus comments when running the Hugo web server on localhost (i.e. via hugo server) causes the creation of unwanted discussions on the associated Disqus account.
You can create the following layouts/partials/disqus.html:
{{< code file="layouts/partials/disqus.html" download="disqus.html" >}}
comments powered by Disqus {{< /code >}}The if statement skips the initialization of the Disqus comment injection when you are running on localhost.
You can then render your custom Disqus partial template as follows:
{{ partial "disqus.html" . }}
The Internal Templates
_internal/disqus.html_internal/google_news.html_internal/google_analytics.html_internal/google_analytics_async.html_internal/opengraph.html_internal/pagination.html_internal/schema.html_internal/twitter_cards.html