mirror of
https://github.com/tiennm99/hugoDocs.git
synced 2026-10-14 14:17:43 +00:00
Add first draft of internal templates page
This commit is contained in:
1 parent
118704aac5
commit
26225d8b09
3 files changed
+132
-102
No files matched your search
@@ -392,6 +392,7 @@ Apache License - 60
|
|||||||
* RSS Templates - 150
|
* RSS Templates - 150
|
||||||
* Sitemap Template - 160
|
* Sitemap Template - 160
|
||||||
* Robots.txt - 165
|
* Robots.txt - 165
|
||||||
|
* Internal Templates - 168
|
||||||
* Additional Templating Languages - 170
|
* Additional Templating Languages - 170
|
||||||
* Template Debugging - 180
|
* Template Debugging - 180
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,131 @@
|
|||||||
|
---
|
||||||
|
title: Internal Templates
|
||||||
|
linktitle: Internal Templates
|
||||||
|
description: Hugo ships with a series of internal templates to
|
||||||
|
date: 2017-03-06
|
||||||
|
publishdate: 2017-03-06
|
||||||
|
lastmod: 2017-03-06
|
||||||
|
categories: [templates]
|
||||||
|
tags: [internal, analytics,]
|
||||||
|
weight: 168
|
||||||
|
draft: false
|
||||||
|
aliases: []
|
||||||
|
toc: false
|
||||||
|
wip: true
|
||||||
|
---
|
||||||
|
<!-- reference: https://discuss.gohugo.io/t/lookup-order-for-partials/5705/6 -->
|
||||||
|
|
||||||
|
{{% 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.
|
||||||
|
|
||||||
|
### Configuring Google Analytics
|
||||||
|
|
||||||
|
Provide your tracking id in your configuration file:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
googleAnalytics = "UA-123-45"
|
||||||
|
```
|
||||||
|
|
||||||
|
```yml
|
||||||
|
googleAnalytics: "UA-123-45"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Adding the Google Analytics Template
|
||||||
|
|
||||||
|
You can then include the Google Analytics internal template:
|
||||||
|
|
||||||
|
```golang
|
||||||
|
{{ template "_internal/google_analytics.html" . }}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
```golang
|
||||||
|
{{ 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].
|
||||||
|
|
||||||
|
### Configuring Disqus
|
||||||
|
|
||||||
|
To use Hugo's Disqus template, you first need to set a single value in your site's `config.toml` or `config.yml`:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
disqusShortname = "yourdiscussshortname"
|
||||||
|
```
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
disqusShortname: "yourdiscussshortname"
|
||||||
|
```
|
||||||
|
|
||||||
|
You also have the option to set the following in the front matter for a given piece of content:
|
||||||
|
|
||||||
|
* `disqus_identifier`
|
||||||
|
* `disqus_title`
|
||||||
|
* `disqus_url`
|
||||||
|
|
||||||
|
### Adding the Disqus Template
|
||||||
|
|
||||||
|
To add Disqus, include the following line in templates where you want your comments to appear:
|
||||||
|
|
||||||
|
```golang
|
||||||
|
{{ 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" %}}
|
||||||
|
```html
|
||||||
|
<div id="disqus_thread"></div>
|
||||||
|
<script type="text/javascript">
|
||||||
|
|
||||||
|
(function() {
|
||||||
|
// Don't ever inject Disqus on localhost--it creates unwanted
|
||||||
|
// discussions from 'localhost:1313' on your Disqus account...
|
||||||
|
if (window.location.hostname == "localhost")
|
||||||
|
return;
|
||||||
|
|
||||||
|
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
|
||||||
|
var disqus_shortname = '{{ .Site.DisqusShortname }}';
|
||||||
|
dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
|
||||||
|
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
|
||||||
|
})();
|
||||||
|
</script>
|
||||||
|
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
|
||||||
|
<a href="http://disqus.com/" class="dsq-brlink">comments powered by <span class="logo-disqus">Disqus</span></a>
|
||||||
|
```
|
||||||
|
{{% /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:
|
||||||
|
|
||||||
|
```golang
|
||||||
|
{{ partial "disqus.html" . }}
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
_internal/_default/robots.txt
|
||||||
|
_internal/_default/rss.xml
|
||||||
|
_internal/_default/sitemap.xml
|
||||||
|
_internal/_default/sitemapindex.xml
|
||||||
|
|
||||||
|
_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
|
||||||
|
```
|
||||||
@@ -160,108 +160,6 @@ The following `footer.html` partial template is used for [spf13.com](http://spf1
|
|||||||
```
|
```
|
||||||
{{% /code %}}
|
{{% /code %}}
|
||||||
|
|
||||||
|
|
||||||
## Using Hugo's Internal Partial Templates
|
|
||||||
|
|
||||||
{{% 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 partial templates for Google Analytics tracking, including both synchronous and asynchronous tracking codes.
|
|
||||||
|
|
||||||
#### Configuring Google Analytics
|
|
||||||
|
|
||||||
Provide your tracking id in your configuration file:
|
|
||||||
|
|
||||||
```toml
|
|
||||||
googleAnalytics = "UA-123-45"
|
|
||||||
```
|
|
||||||
|
|
||||||
```yml
|
|
||||||
googleAnalytics: "UA-123-45"
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Adding the Google Analytics Template
|
|
||||||
|
|
||||||
You can then include the Google Analytics internal partial in your templates:
|
|
||||||
|
|
||||||
```golang
|
|
||||||
{{ template "_internal/google_analytics.html" . }}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```golang
|
|
||||||
{{ template "_internal/google_analytics_async.html" . }}
|
|
||||||
```
|
|
||||||
|
|
||||||
### Disqus
|
|
||||||
|
|
||||||
Hugo also ships with a built-in partial 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].
|
|
||||||
|
|
||||||
#### Configuring Disqus
|
|
||||||
|
|
||||||
To use Hugo's Disqus template, you first need to set a single value in your site's `config.toml` or `config.yml`:
|
|
||||||
|
|
||||||
```toml
|
|
||||||
disqusShortname = "yourdiscussshortname"
|
|
||||||
```
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
disqusShortname: "yourdiscussshortname"
|
|
||||||
```
|
|
||||||
|
|
||||||
You also have the option to set the following in the front matter for a given piece of content:
|
|
||||||
|
|
||||||
* `disqus_identifier`
|
|
||||||
* `disqus_title`
|
|
||||||
* `disqus_url`
|
|
||||||
|
|
||||||
#### Adding the Disqus Template
|
|
||||||
|
|
||||||
To add Disqus, include the following line in templates where you want your comments to appear:
|
|
||||||
|
|
||||||
```golang
|
|
||||||
{{ 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" %}}
|
|
||||||
```html
|
|
||||||
<div id="disqus_thread"></div>
|
|
||||||
<script type="text/javascript">
|
|
||||||
|
|
||||||
(function() {
|
|
||||||
// Don't ever inject Disqus on localhost--it creates unwanted
|
|
||||||
// discussions from 'localhost:1313' on your Disqus account...
|
|
||||||
if (window.location.hostname == "localhost")
|
|
||||||
return;
|
|
||||||
|
|
||||||
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
|
|
||||||
var disqus_shortname = '{{ .Site.DisqusShortname }}';
|
|
||||||
dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';
|
|
||||||
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
|
|
||||||
})();
|
|
||||||
</script>
|
|
||||||
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
|
|
||||||
<a href="http://disqus.com/" class="dsq-brlink">comments powered by <span class="logo-disqus">Disqus</span></a>
|
|
||||||
```
|
|
||||||
{{% /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:
|
|
||||||
|
|
||||||
```golang
|
|
||||||
{{ partial "disqus.html" . }}
|
|
||||||
```
|
|
||||||
|
|
||||||
[context]: /templates/go-templates/ "The most easily overlooked concept to understand about Go templating is how the dot always refers to the current context."
|
[context]: /templates/go-templates/ "The most easily overlooked concept to understand about Go templating is how the dot always refers to the current context."
|
||||||
[customize]: /themes/customizing/
|
[customize]: /themes/customizing/
|
||||||
[disqus]: https://disqus.com
|
[disqus]: https://disqus.com
|
||||||
|
|||||||
Reference in new issue
Block a user