phoenix/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-07-05 08:42:12 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update Hugo docs with the initialisms suggested by golint

Browse source 
In particular:

 * .Url → .URL (for node, menu and paginator)
 * .Site.BaseUrl → .Site.BaseURL
 * getJson → getJSON
 * getCsv → getCSV
 * safeHtml → safeHTML
 * safeCss → safeCSS
 * safeUrl → safeURL

Continued effort in fixing #959.
This commit is contained in:
Anthony Fok 2015-03-18 00:44:12 -06:00 committed by bep
parent 8b8fb417ae
commit b3bd71fec9
14 changed files with 87 additions and 87 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
docs/content/content/organization.md
View file

@ -67,7 +67,7 @@ This isn't in the front matter, but is the actual name of the file minus the
extension. This will be the name of the file in the destination. extension. This will be the name of the file in the destination.
### slug ### slug
Defined in the front matter, the slug can take the place of the filename for the Defined in the front matter, the `slug` can take the place of the filename for the
destination. destination.
### filepath ### filepath
@ -75,18 +75,18 @@ The actual path to the file on disk. Destination will create the destination
with the same path. Includes [section](/content/sections/). with the same path. Includes [section](/content/sections/).
### section ### section
section can be provided in the front matter overriding the section derived from `section` can be provided in the front matter overriding the section derived from
the source content location on disk. See [section](/content/sections/). the source content location on disk. See [section](/content/sections/).
### path ### path
path can be provided in the front matter. This will replace the actual `path` can be provided in the front matter. This will replace the actual
path to the file on disk. Destination will create the destination with the same path to the file on disk. Destination will create the destination with the same
path. Includes [section](/content/sections/). path. Includes [section](/content/sections/).
### url ### url
A complete URL can be provided. This will override all the above as it pertains A complete URL can be provided. This will override all the above as it pertains
to the end destination. This must be the path from the baseurl (starting with a "/"). to the end destination. This must be the path from the baseURL (starting with a "/").
When a url is provided, it will be used exactly. Using url will ignore the When a `url` is provided, it will be used exactly. Using `url` will ignore the
`--uglyUrls` setting. `--uglyUrls` setting.
@ -116,27 +116,27 @@ When a url is provided, it will be used exactly. Using url will ignore the
http://spf13.com/projects/hugo http://spf13.com/projects/hugo
baseUrl section slug baseURL section slug
⊢-----^--------⊣ ⊢--^---⊣ ⊢-^⊣ ⊢-----^--------⊣ ⊢--^---⊣ ⊢-^⊣
http://spf13.com/projects/hugo http://spf13.com/projects/hugo
baseUrl section slug baseURL section slug
⊢-----^--------⊣ ⊢--^--⊣ ⊢--^--⊣ ⊢-----^--------⊣ ⊢--^--⊣ ⊢--^--⊣
http://spf13.com/extras/indexes/example http://spf13.com/extras/indexes/example
baseUrl path slug baseURL path slug
⊢-----^--------⊣ ⊢------^-----⊣ ⊢--^--⊣ ⊢-----^--------⊣ ⊢------^-----⊣ ⊢--^--⊣
http://spf13.com/extras/indexes/example http://spf13.com/extras/indexes/example
baseUrl url baseURL url
⊢-----^--------⊣ ⊢-----^-----⊣ ⊢-----^--------⊣ ⊢-----^-----⊣
http://spf13.com/projects/hugo http://spf13.com/projects/hugo
baseUrl url baseURL url
⊢-----^--------⊣ ⊢--------^-----------⊣ ⊢-----^--------⊣ ⊢--------^-----------⊣
http://spf13.com/extras/indexes/example http://spf13.com/extras/indexes/example

26
docs/content/extras/dynamiccontent.md
View file

@ -19,8 +19,8 @@ any [JSON](http://www.json.org/) or
[CSV](http://en.wikipedia.org/wiki/Comma-separated_values) file [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) file
from nearly any resource. from nearly any resource.
"Dynamic Content" currently consists of two functions, `getJson` "Dynamic Content" currently consists of two functions, `getJSON`
and `getCsv`, which are available in **all template files**. and `getCSV`, which are available in **all template files**.
## Implementation details ## Implementation details
@ -28,33 +28,33 @@ and `getCsv`, which are available in **all template files**.
In any HTML template or Markdown document, call the functions like this: In any HTML template or Markdown document, call the functions like this:
{{ $dataJ := getJson "url" }} {{ $dataJ := getJSON "url" }}
{{ $dataC := getCsv "separator" "url" }} {{ $dataC := getCSV "separator" "url" }}
or, if you use a prefix or postfix for the URL, the functions or, if you use a prefix or postfix for the URL, the functions
accept [variadic arguments](http://en.wikipedia.org/wiki/Variadic_function): accept [variadic arguments](http://en.wikipedia.org/wiki/Variadic_function):
{{ $dataJ := getJson "url prefix" "arg1" "arg2" "arg n" }} {{ $dataJ := getJSON "url prefix" "arg1" "arg2" "arg n" }}
{{ $dataC := getCsv "separator" "url prefix" "arg1" "arg2" "arg n" }} {{ $dataC := getCSV "separator" "url prefix" "arg1" "arg2" "arg n" }}
The separator for `getCsv` must be put in the first position and can only The separator for `getCSV` must be put in the first position and can only
be one character long. be one character long.
All passed arguments will be joined to the final URL; for example: All passed arguments will be joined to the final URL; for example:
{{ $urlPre := "https://api.github.com" }} {{ $urlPre := "https://api.github.com" }}
{{ $gistJ := getJson $urlPre "/users/GITHUB_USERNAME/gists" }} {{ $gistJ := getJSON $urlPre "/users/GITHUB_USERNAME/gists" }}
will resolve internally to: will resolve internally to:
{{ $gistJ := getJson "https://api.github.com/users/GITHUB_USERNAME/gists" }} {{ $gistJ := getJSON "https://api.github.com/users/GITHUB_USERNAME/gists" }}
Finally, you can range over an array. This example will output the Finally, you can range over an array. This example will output the
first 5 gists for a GitHub user: first 5 gists for a GitHub user:
<ul> <ul>
{{ $urlPre := "https://api.github.com" }} {{ $urlPre := "https://api.github.com" }}
{{ $gistJ := getJson $urlPre "/users/GITHUB_USERNAME/gists" }} {{ $gistJ := getJSON $urlPre "/users/GITHUB_USERNAME/gists" }}
{{ range first 5 $gistJ }} {{ range first 5 $gistJ }}
{{ if .public }} {{ if .public }}
<li><a href="{{ .html_url }}" target="_blank">{{ .description }}</a></li> <li><a href="{{ .html_url }}" target="_blank">{{ .description }}</a></li>
@ -65,7 +65,7 @@ first 5 gists for a GitHub user:
### Example for CSV files ### Example for CSV files
For `getCsv`, the one-character long separator must be placed in the For `getCSV`, the one-character long separator must be placed in the
first position followed by the URL. first position followed by the URL.
<table> <table>
@ -79,7 +79,7 @@ first position followed by the URL.
<tbody> <tbody>
{{ $url := "http://a-big-corp.com/finance/employee-salaries.csv" }} {{ $url := "http://a-big-corp.com/finance/employee-salaries.csv" }}
{{ $sep := "," }} {{ $sep := "," }}
{{ range $i, $r := getCsv $sep $url }} {{ range $i, $r := getCSV $sep $url }}
<tr> <tr>
<td>{{ index $r 0 }}</td> <td>{{ index $r 0 }}</td>
<td>{{ index $r 1 }}</td> <td>{{ index $r 1 }}</td>
@ -113,7 +113,7 @@ other authentication methods are not implemented.
### Loading local files ### Loading local files
To load local files with the two functions `getJson` and `getCsv`, the To load local files with the two functions `getJSON` and `getCSV`, the
source files must reside within Hugo's working directory. The file source files must reside within Hugo's working directory. The file
extension does not matter but the content. extension does not matter but the content.

12
docs/content/extras/menus.md
View file

@ -27,7 +27,7 @@ access it via `.Site.Menus.main`.
A menu entry has the following properties: A menu entry has the following properties:
* **Url** string * **URL** string
* **Name** string * **Name** string
* **Menu** string * **Menu** string
* **Identifier** string * **Identifier** string
@ -112,15 +112,15 @@ And the equivalent example `config.yaml`:
Pre: "<i class='fa fa-heart'></i>" Pre: "<i class='fa fa-heart'></i>"
Weight: -110 Weight: -110
Identifier: "about" Identifier: "about"
Url: "/about/" URL: "/about/"
- Name: "getting started" - Name: "getting started"
Pre: "<i class='fa fa-road'></i>" Pre: "<i class='fa fa-road'></i>"
Weight: -100 Weight: -100
Url: "/getting-started/" URL: "/getting-started/"
--- ---
**NOTE:** The urls must be relative to the context root. If the `BaseUrl` is `http://example.com/mysite/`, then the urls in the menu must not include the context root `mysite`. **NOTE:** The URLs must be relative to the context root. If the `BaseURL` is `http://example.com/mysite/`, then the URLs in the menu must not include the context root `mysite`.
## Nesting ## Nesting
@ -164,12 +164,12 @@ The following is an example:
</a> </a>
<ul class="sub"> <ul class="sub">
{{ range .Children }} {{ range .Children }}
<li{{if $currentNode.IsMenuCurrent "main" . }} class="active"{{end}}><a href="{{.Url}}"> {{ .Name }} </a> </li> <li{{if $currentNode.IsMenuCurrent "main" . }} class="active"{{end}}><a href="{{.URL}}"> {{ .Name }} </a> </li>
{{ end }} {{ end }}
</ul> </ul>
{{else}} {{else}}
<li> <li>
<a class="" href="{{.Url}}"> <a class="" href="{{.URL}}">
{{ .Pre }} {{ .Pre }}
<span>{{ .Name }}</span> <span>{{ .Name }}</span>
</a> </a>

10
docs/content/extras/pagination.md
View file

@ -17,16 +17,16 @@ Hugo supports pagination for the home page, sections and taxonomies. It's built
Pagination can be configured in the site configuration (e.g. `config.toml`): Pagination can be configured in the site configuration (e.g. `config.toml`):
* `Paginate` (default `10`) * `Paginate` (default `10`)
* `PaginatePath` (default `page`) * `PaginatePath` (default `page`)
Setting `Paginate` to a positive value will split the list pages for the home page, sections and taxonomies into chunks of that size. But note that the generation of the pagination pages for sections, taxonomies and home page is *lazy* --- the pages will not be created if not referenced by a `.Paginator` (see below). Setting `Paginate` to a positive value will split the list pages for the home page, sections and taxonomies into chunks of that size. But note that the generation of the pagination pages for sections, taxonomies and home page is *lazy* --- the pages will not be created if not referenced by a `.Paginator` (see below).
`PaginatePath` is used to adapt the `Url` to the pages in the paginator (the default setting will produce urls on the form `/page/1/`. `PaginatePath` is used to adapt the `URL` to the pages in the paginator (the default setting will produce URLs on the form `/page/1/`.
## List the pages ## List the pages
**A `.Paginator` is provided to help building a pager menu. This is only relevant for the templates for the home page and the list pages (sections and taxonomies).** **A `.Paginator` is provided to help building a pager menu. This is only relevant for the templates for the home page and the list pages (sections and taxonomies).**
There are two ways to configure and use a `.Paginator`: There are two ways to configure and use a `.Paginator`:
@ -37,7 +37,7 @@ For a given **Node**, it's one of the options above. The `.Paginator` is static
## Build the navigation ## Build the navigation
The `.Paginator` contains enough information to build a paginator interface. The `.Paginator` contains enough information to build a paginator interface.
The easiest way to add this to your pages is to include the built-in template (with `Bootstrap`-compatible styles): The easiest way to add this to your pages is to include the built-in template (with `Bootstrap`-compatible styles):
@ -67,7 +67,7 @@ Without the where-filter, the above is simpler:
If you want to build custom navigation, you can do so using the `.Paginator` object: If you want to build custom navigation, you can do so using the `.Paginator` object:
* `PageNumber`: The current page's number in the pager sequence * `PageNumber`: The current page's number in the pager sequence
* `Url`: The relative Url to the current pager * `URL`: The relative URL to the current pager
* `Pages`: The pages in the current pager * `Pages`: The pages in the current pager
* `NumberOfElements`: The number of elements on this page * `NumberOfElements`: The number of elements on this page
* `HasPrev`: Whether there are page(s) before the current * `HasPrev`: Whether there are page(s) before the current

52
docs/content/overview/configuration.md
View file

@ -40,11 +40,11 @@ The following is an example of a toml config file with some of the default value
builddrafts = false builddrafts = false
baseurl = "http://yoursite.example.com/" baseurl = "http://yoursite.example.com/"
canonifyurls = true canonifyurls = true
[taxonomies] [taxonomies]
category = "categories" category = "categories"
tag = "tags" tag = "tags"
[params] [params]
description = "Tesla's Awesome Hugo Site" description = "Tesla's Awesome Hugo Site"
author = "Nikola Tesla" author = "Nikola Tesla"
@ -74,67 +74,67 @@ Following is a list of Hugo-defined variables that you can configure and their c
--- ---
archetypedir: "archetype" archetypedir: "archetype"
# hostname (and path) to the root eg. http://spf13.com/ # hostname (and path) to the root eg. http://spf13.com/
baseurl: "" baseURL: ""
# include content marked as draft # include content marked as draft
buildDrafts: false buildDrafts: false
# include content with datePublished in the future # include content with datePublished in the future
buildFuture: false buildFuture: false
canonifyUrls: false canonifyURLs: false
# config file (default is path/config.yaml|json|toml) # config file (default is path/config.yaml|json|toml)
config: "config.toml" config: "config.toml"
contentdir: "content" contentdir: "content"
dataDir: "data" dataDir: "data"
defaultExtension: "html" defaultExtension: "html"
defaultLayout: "post" defaultLayout: "post"
# filesystem path to write files to # filesystem path to write files to
destination: "" destination: ""
disableLiveReload: false disableLiveReload: false
# Do not build RSS files # Do not build RSS files
disableRSS: false disableRSS: false
# Do not build Sitemap file # Do not build Sitemap file
disableSitemap: false disableSitemap: false
# edit new content with this editor, if provided # edit new content with this editor, if provided
editor: "" editor: ""
footnoteAnchorPrefix: "" footnoteAnchorPrefix: ""
footnoteReturnLinkContents: "" footnoteReturnLinkContents: ""
languageCode: "" languageCode: ""
layoutdir: "layouts" layoutdir: "layouts"
# Enable Logging # Enable Logging
log: false log: false
# Log File path (if set, logging enabled automatically) # Log File path (if set, logging enabled automatically)
logFile: "" logFile: ""
# "yaml", "toml", "json" # "yaml", "toml", "json"
metaDataFormat: "toml" metaDataFormat: "toml"
newContentEditor: "" newContentEditor: ""
# Don't sync modification time of files # Don't sync modification time of files
noTimes: false noTimes: false
paginate: 10 paginate: 10
paginatePath: "page" paginatePath: "page"
permalinks: permalinks:
# Pluralize titles in lists using inflect # Pluralize titles in lists using inflect
pluralizeListTitles: true pluralizeListTitles: true
publishdir: "public" publishdir: "public"
# color-codes for highlighting derived from this style # color-codes for highlighting derived from this style
pygmentsStyle: "monokai" pygmentsStyle: "monokai"
# true: use pygments-css or false: color-codes directly # true: use pygments-css or false: color-codes directly
pygmentsUseClasses: false pygmentsUseClasses: false
sitemap: "" sitemap: ""
# filesystem path to read files relative from # filesystem path to read files relative from
source: "" source: ""
staticdir: "static" staticdir: "static"
# display memory and timing of different steps of the program # display memory and timing of different steps of the program
stepAnalysis: false stepAnalysis: false
# theme to use (located in /themes/THEMENAME/) # theme to use (located in /themes/THEMENAME/)
theme: "" theme: ""
title: "" title: ""
# if true, use /filename.html instead of /filename/ # if true, use /filename.html instead of /filename/
uglyUrls: false uglyURLs: false
# verbose output # verbose output
verbose: false verbose: false
# verbose logging # verbose logging
verboseLog: false verboseLog: false
# watch filesystem for changes and recreate as needed # watch filesystem for changes and recreate as needed
watch: false watch: false
--- ---

2
docs/content/taxonomies/displaying.md
View file

@ -52,7 +52,7 @@ content.
<ul> <ul>
{{ range .Site.Taxonomies.series.golang }} {{ range .Site.Taxonomies.series.golang }}
<li><a href="{{ .Url }}">{{ .Name }}</a></li> <li><a href="{{ .URL }}">{{ .Name }}</a></li>
{{ end }} {{ end }}
</ul> </ul>

4
docs/content/templates/content.md
View file

@ -67,7 +67,7 @@ It makes use of [partial templates](/templates/partials/)
{{ partial "header.html" . }} {{ partial "header.html" . }}
{{ partial "subheader.html" . }} {{ partial "subheader.html" . }}
{{ $baseurl := .Site.BaseUrl }} {{ $baseurl := .Site.BaseURL }}
<section id="main"> <section id="main">
<h1 id="title">{{ .Title }}</h1> <h1 id="title">{{ .Title }}</h1>
@ -116,7 +116,7 @@ It makes use of [partial templates](/templates/partials/)
{{ partial "header.html" . }} {{ partial "header.html" . }}
{{ partial "subheader.html" . }} {{ partial "subheader.html" . }}
{{ $baseurl := .Site.BaseUrl }} {{ $baseurl := .Site.BaseURL }}
<section id="main"> <section id="main">
<h1 id="title">{{ .Title }}</h1> <h1 id="title">{{ .Title }}</h1>

26
docs/content/templates/functions.md
View file

@ -262,7 +262,7 @@ Takes a string and sanitizes it for usage in URLs, converts spaces to "-".
e.g. `<a href="/tags/{{ . | urlize }}">{{ . }}</a>` e.g. `<a href="/tags/{{ . | urlize }}">{{ . }}</a>`
### safeHtml ### safeHTML
Declares the provided string as a "safe" HTML document fragment Declares the provided string as a "safe" HTML document fragment
so Go html/template will not filter it. It should not be used so Go html/template will not filter it. It should not be used
for HTML from a third-party, or HTML with unclosed tags or comments. for HTML from a third-party, or HTML with unclosed tags or comments.
@ -271,11 +271,11 @@ Example: Given a site-wide `config.toml` that contains this line:
copyright = "© 2015 Jane Doe. <a href=\"http://creativecommons.org/licenses/by/4.0/\">Some rights reserved</a>." copyright = "© 2015 Jane Doe. <a href=\"http://creativecommons.org/licenses/by/4.0/\">Some rights reserved</a>."
`{{ .Site.Copyright | safeHtml }}` would then output: `{{ .Site.Copyright | safeHTML }}` would then output:
> © 2015 Jane Doe. <a href="http://creativecommons.org/licenses/by/4.0/">Some rights reserved</a>. > © 2015 Jane Doe. <a href="http://creativecommons.org/licenses/by/4.0/">Some rights reserved</a>.
However, without the `safeHtml` function, html/template assumes However, without the `safeHTML` function, html/template assumes
`.Site.Copyright` to be unsafe, escaping all HTML tags, `.Site.Copyright` to be unsafe, escaping all HTML tags,
rendering the whole string as plain-text like this: rendering the whole string as plain-text like this:
@ -284,7 +284,7 @@ rendering the whole string as plain-text like this:
</blockquote> </blockquote>
<!-- <!--
### safeHtmlAttr ### safeHTMLAttr
Declares the provided string as a "safe" HTML attribute Declares the provided string as a "safe" HTML attribute
from a trusted source, for example, ` dir="ltr"`, from a trusted source, for example, ` dir="ltr"`,
so Go html/template will not filter it. so Go html/template will not filter it.
@ -295,11 +295,11 @@ Example: Given a site-wide `config.toml` that contains this menu entry:
name = "IRC: #golang at freenode" name = "IRC: #golang at freenode"
url = "irc://irc.freenode.net/#golang" url = "irc://irc.freenode.net/#golang"
* `<a href="{{ .Url }}">` ⇒ `<a href="#ZgotmplZ">` (Bad!) * `<a href="{{ .URL }}">` ⇒ `<a href="#ZgotmplZ">` (Bad!)
* `<a {{ printf "href=%q" .Url | safeHtmlAttr }}>` ⇒ `<a href="irc://irc.freenode.net/#golang">` (Good!) * `<a {{ printf "href=%q" .URL | safeHTMLAttr }}>` ⇒ `<a href="irc://irc.freenode.net/#golang">` (Good!)
--> -->
### safeCss ### safeCSS
Declares the provided string as a known "safe" CSS string Declares the provided string as a known "safe" CSS string
so Go html/templates will not filter it. so Go html/templates will not filter it.
"Safe" means CSS content that matches any of: "Safe" means CSS content that matches any of:
@ -311,13 +311,13 @@ so Go html/templates will not filter it.
Example: Given `style = "color: red;"` defined in the front matter of your `.md` file: Example: Given `style = "color: red;"` defined in the front matter of your `.md` file:
* `<p style="{{ .Params.style | safeCss }}">…</p>` ⇒ `<p style="color: red;">…</p>` (Good!) * `<p style="{{ .Params.style | safeCSS }}">…</p>` ⇒ `<p style="color: red;">…</p>` (Good!)
* `<p style="{{ .Params.style }}">…</p>` ⇒ `<p style="ZgotmplZ">…</p>` (Bad!) * `<p style="{{ .Params.style }}">…</p>` ⇒ `<p style="ZgotmplZ">…</p>` (Bad!)
Note: "ZgotmplZ" is a special value that indicates that unsafe content reached a Note: "ZgotmplZ" is a special value that indicates that unsafe content reached a
CSS or URL context. CSS or URL context.
### safeUrl ### safeURL
Declares the provided string as a "safe" URL or URL substring (see [RFC 3986][]). Declares the provided string as a "safe" URL or URL substring (see [RFC 3986][]).
A URL like `javascript:checkThatFormNotEditedBeforeLeavingPage()` from a trusted A URL like `javascript:checkThatFormNotEditedBeforeLeavingPage()` from a trusted
source should go in the page, but by default dynamic `javascript:` URLs are source should go in the page, but by default dynamic `javascript:` URLs are
@ -325,7 +325,7 @@ filtered out since they are a frequently exploited injection vector.
[RFC 3986]: http://tools.ietf.org/html/rfc3986 [RFC 3986]: http://tools.ietf.org/html/rfc3986
Without `safeUrl`, only the URI schemes `http:`, `https:` and `mailto:` Without `safeURL`, only the URI schemes `http:`, `https:` and `mailto:`
are considered safe by Go. If any other URI schemes, e.g.&nbsp;`irc:` and are considered safe by Go. If any other URI schemes, e.g.&nbsp;`irc:` and
`javascript:`, are detected, the whole URL would be replaced with `javascript:`, are detected, the whole URL would be replaced with
`#ZgotmplZ`. This is to "defang" any potential attack in the URL, `#ZgotmplZ`. This is to "defang" any potential attack in the URL,
@ -341,16 +341,16 @@ The following template:
<ul class="sidebar-menu"> <ul class="sidebar-menu">
{{ range .Site.Menus.main }} {{ range .Site.Menus.main }}
<li><a href="{{ .Url }}">{{ .Name }}</a></li> <li><a href="{{ .URL }}">{{ .Name }}</a></li>
{{ end }} {{ end }}
</ul> </ul>
would produce `<li><a href="#ZgotmplZ">IRC: #golang at freenode</a></li>` would produce `<li><a href="#ZgotmplZ">IRC: #golang at freenode</a></li>`
for the `irc://…` URL. for the `irc://…` URL.
To fix this, add ` | safeUrl` after `.Url` on the 3rd line, like this: To fix this, add ` | safeURL` after `.URL` on the 3rd line, like this:
<li><a href="{{ .Url | safeUrl }}">{{ .Name }}</a></li> <li><a href="{{ .URL | safeURL }}">{{ .Name }}</a></li>
With this change, we finally get `<li><a href="irc://irc.freenode.net/#golang">IRC: #golang at freenode</a></li>` With this change, we finally get `<li><a href="irc://irc.freenode.net/#golang">IRC: #golang at freenode</a></li>`
as intended. as intended.

8
docs/content/templates/go-templates.md
View file

@ -236,14 +236,14 @@ Could be rewritten as
By default, Go Templates remove HTML comments from output. This has the unfortunate side effect of removing Internet Explorer conditional comments. As a workaround, use something like this: By default, Go Templates remove HTML comments from output. This has the unfortunate side effect of removing Internet Explorer conditional comments. As a workaround, use something like this:
{{ "<!--[if lt IE 9]>" | safeHtml }} {{ "<!--[if lt IE 9]>" | safeHTML }}
<script src="html5shiv.js"></script> <script src="html5shiv.js"></script>
{{ "<![endif]-->" | safeHtml }} {{ "<![endif]-->" | safeHTML }}
Alternatively, use the backtick (`` ` ``) to quote the IE conditional comments, avoiding the tedious task of escaping every double quotes (`"`) inside, as demonstrated in the [examples](http://golang.org/pkg/text/template/#hdr-Examples) in the Go text/template documentation, e.g.: Alternatively, use the backtick (`` ` ``) to quote the IE conditional comments, avoiding the tedious task of escaping every double quotes (`"`) inside, as demonstrated in the [examples](http://golang.org/pkg/text/template/#hdr-Examples) in the Go text/template documentation, e.g.:
``` ```
{{ `<!--[if lt IE 7]><html class="no-js lt-ie9 lt-ie8 lt-ie7"><![endif]-->` | safeHtml }} {{ `<!--[if lt IE 7]><html class="no-js lt-ie9 lt-ie8 lt-ie7"><![endif]-->` | safeHTML }}
``` ```
## Context (a.k.a. the dot) ## Context (a.k.a. the dot)
@ -355,7 +355,7 @@ January 1st, instead of hunting through your templates.
``` ```
{{if .Site.Params.CopyrightHTML}}<footer> {{if .Site.Params.CopyrightHTML}}<footer>
<div class="text-center">{{.Site.Params.CopyrightHTML | safeHtml}}</div> <div class="text-center">{{.Site.Params.CopyrightHTML | safeHTML}}</div>
</footer>{{end}} </footer>{{end}}
``` ```

2
docs/content/templates/homepage.md
View file

@ -56,7 +56,7 @@ It makes use of [partial templates](/templates/partials/) and uses a similar app
{{ partial "meta.html" . }} {{ partial "meta.html" . }}
<base href="{{ .Site.BaseUrl }}"> <base href="{{ .Site.BaseURL }}">
<title>{{ .Site.Title }}</title> <title>{{ .Site.Title }}</title>
<link rel="canonical" href="{{ .Permalink }}"> <link rel="canonical" href="{{ .Permalink }}">
<link href="{{ .RSSlink }}" rel="alternate" type="application/rss+xml" title="{{ .Site.Title }}" /> <link href="{{ .RSSlink }}" rel="alternate" type="application/rss+xml" title="{{ .Site.Title }}" />

2
docs/content/templates/partials.md
View file

@ -60,7 +60,7 @@ This header template is used for [spf13.com](http://spf13.com/):
{{ partial "meta.html" . }} {{ partial "meta.html" . }}
<base href="{{ .Site.BaseUrl }}"> <base href="{{ .Site.BaseURL }}">
<title> {{ .Title }} : spf13.com </title> <title> {{ .Title }} : spf13.com </title>
<link rel="canonical" href="{{ .Permalink }}"> <link rel="canonical" href="{{ .Permalink }}">
{{ if .RSSlink }}<link href="{{ .RSSlink }}" rel="alternate" type="application/rss+xml" title="{{ .Title }}" />{{ end }} {{ if .RSSlink }}<link href="{{ .RSSlink }}" rel="alternate" type="application/rss+xml" title="{{ .Title }}" />{{ end }}

2
docs/content/templates/sitemap.md
View file

@ -39,7 +39,7 @@ Protocol](http://www.sitemaps.org/protocol.html).
{{ range .Data.Pages }} {{ range .Data.Pages }}
<url> <url>
<loc>{{ .Permalink }}</loc> <loc>{{ .Permalink }}</loc>
<lastmod>{{ safeHtml ( .Date.Format "2006-01-02T15:04:05-07:00" ) }}</lastmod>{{ with .Sitemap.ChangeFreq }} <lastmod>{{ safeHTML ( .Date.Format "2006-01-02T15:04:05-07:00" ) }}</lastmod>{{ with .Sitemap.ChangeFreq }}
<changefreq>{{ . }}</changefreq>{{ end }}{{ if ge .Sitemap.Priority 0.0 }} <changefreq>{{ . }}</changefreq>{{ end }}{{ if ge .Sitemap.Priority 0.0 }}
<priority>{{ .Sitemap.Priority }}</priority>{{ end }} <priority>{{ .Sitemap.Priority }}</priority>{{ end }}
</url> </url>

4
docs/content/templates/variables.md
View file

@ -72,7 +72,7 @@ includes taxonomies, lists and the homepage.
**.Title** The title for the content.<br> **.Title** The title for the content.<br>
**.Date** The date the content is published on.<br> **.Date** The date the content is published on.<br>
**.Permalink** The Permanent link for this node<br> **.Permalink** The Permanent link for this node<br>
**.Url** The relative URL for this node.<br> **.URL** The relative URL for this node.<br>
**.Ref(ref)** Returns the permalink for `ref`. See [cross-references]({{% ref "extras/crossreferences.md" %}}). Does not handle in-page fragments correctly.<br> **.Ref(ref)** Returns the permalink for `ref`. See [cross-references]({{% ref "extras/crossreferences.md" %}}). Does not handle in-page fragments correctly.<br>
**.RelRef(ref)** Returns the relative permalink for `ref`. See [cross-references]({{% ref "extras/crossreferences.md" %}}). Does not handle in-page fragments correctly.<br> **.RelRef(ref)** Returns the relative permalink for `ref`. See [cross-references]({{% ref "extras/crossreferences.md" %}}). Does not handle in-page fragments correctly.<br>
**.RSSLink** Link to the taxonomies' RSS link.<br> **.RSSLink** Link to the taxonomies' RSS link.<br>
@ -86,7 +86,7 @@ includes taxonomies, lists and the homepage.
Also available is `.Site` which has the following: Also available is `.Site` which has the following:
**.Site.BaseUrl** The base URL for the site as defined in the site configuration file.<br> **.Site.BaseURL** The base URL for the site as defined in the site configuration file.<br>
**.Site.Taxonomies** The [taxonomies](/taxonomies/usage/) for the entire site. Replaces the now-obsolete `.Site.Indexes` since v0.11.<br> **.Site.Taxonomies** The [taxonomies](/taxonomies/usage/) for the entire site. Replaces the now-obsolete `.Site.Indexes` since v0.11.<br>
**.Site.LastChange** The date of the last change of the most recent content.<br> **.Site.LastChange** The date of the last change of the most recent content.<br>
**.Site.Pages** Array of all content ordered by Date, newest first. Replaces the now-deprecated `.Site.Recent` starting v0.13.<br> **.Site.Pages** Array of all content ordered by Date, newest first. Replaces the now-deprecated `.Site.Recent` starting v0.13.<br>

4
docs/layouts/partials/menu.html
View file

@ -16,12 +16,12 @@
</a> </a>
<ul class="sub{{if $currentNode.HasMenuCurrent "main" . }} open{{end}}"> <ul class="sub{{if $currentNode.HasMenuCurrent "main" . }} open{{end}}">
{{ range .Children }} {{ range .Children }}
<li{{if $currentNode.IsMenuCurrent "main" . }} class="active"{{end}}><a href="{{.Url}}">{{ .Name }}</a> </li> <li{{if $currentNode.IsMenuCurrent "main" . }} class="active"{{end}}><a href="{{.URL}}">{{ .Name }}</a> </li>
{{ end }} {{ end }}
</ul> </ul>
{{else}} {{else}}
<li> <li>
<a class="" href="{{.Url}}"> <a class="" href="{{.URL}}">
{{ .Pre }} {{ .Pre }}
<!--<i class="icon_house_alt"></i>--> <!--<i class="icon_house_alt"></i>-->
<span>{{ .Name }}</span> <span>{{ .Name }}</span>