shithub: hugo

Download patch

ref: b6a30283f099ce9578d491ba8fbbf45f673dbf3b
parent: 57adc539fc98dcb6fba8070b9611b8bd545f6f7f
parent: 9d68f695e782c6a83c77aff13317c7a22c694c98
author: Bjørn Erik Pedersen <[email protected]>
date: Thu Sep 28 13:22:55 EDT 2017 

Merge commit '9d68f695e782c6a83c77aff13317c7a22c694c98'


--- a/docs/.gitignore
+++ b/docs/.gitignore
@@ -1,2 +1,3 @@
 /.idea
 /public
+nohup.out
--- a/docs/content/commands/hugo.md
+++ b/docs/content/commands/hugo.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo"
 slug: hugo
 url: /commands/hugo/
@@ -56,6 +56,7 @@
       --renderToMemory             render to memory (only useful for benchmark testing)
   -s, --source string              filesystem path to read files relative from
       --stepAnalysis               display memory and timing of different steps of the program
+      --templateMetrics            display metrics about template executions
   -t, --theme string               theme to use (located in /themes/THEMENAME/)
       --themesDir string           filesystem path to themes directory
       --uglyURLs                   if true, use /filename.html instead of /filename/
@@ -78,4 +79,4 @@
 * [hugo undraft](/commands/hugo_undraft/)	 - Undraft resets the content's draft status
 * [hugo version](/commands/hugo_version/)	 - Print the version number of Hugo
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_benchmark.md
+++ b/docs/content/commands/hugo_benchmark.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo benchmark"
 slug: hugo_benchmark
 url: /commands/hugo_benchmark/
@@ -50,6 +50,7 @@
       --renderToMemory             render to memory (only useful for benchmark testing)
   -s, --source string              filesystem path to read files relative from
       --stepAnalysis               display memory and timing of different steps of the program
+      --templateMetrics            display metrics about template executions
   -t, --theme string               theme to use (located in /themes/THEMENAME/)
       --themesDir string           filesystem path to themes directory
       --uglyURLs                   if true, use /filename.html instead of /filename/
@@ -70,4 +71,4 @@
 ### SEE ALSO
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_check.md
+++ b/docs/content/commands/hugo_check.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo check"
 slug: hugo_check
 url: /commands/hugo_check/
@@ -35,4 +35,4 @@
 * [hugo](/commands/hugo/)	 - hugo builds your site
 * [hugo check ulimit](/commands/hugo_check_ulimit/)	 - Check system ulimit settings
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_check_ulimit.md
+++ b/docs/content/commands/hugo_check_ulimit.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo check ulimit"
 slug: hugo_check_ulimit
 url: /commands/hugo_check_ulimit/
@@ -39,4 +39,4 @@
 ### SEE ALSO
 * [hugo check](/commands/hugo_check/)	 - Contains some verification checks
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_config.md
+++ b/docs/content/commands/hugo_config.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo config"
 slug: hugo_config
 url: /commands/hugo_config/
@@ -38,4 +38,4 @@
 ### SEE ALSO
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_convert.md
+++ b/docs/content/commands/hugo_convert.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo convert"
 slug: hugo_convert
 url: /commands/hugo_convert/
@@ -42,4 +42,4 @@
 * [hugo convert toTOML](/commands/hugo_convert_totoml/)	 - Convert front matter to TOML
 * [hugo convert toYAML](/commands/hugo_convert_toyaml/)	 - Convert front matter to YAML
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_convert_toJSON.md
+++ b/docs/content/commands/hugo_convert_toJSON.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo convert toJSON"
 slug: hugo_convert_toJSON
 url: /commands/hugo_convert_tojson/
@@ -42,4 +42,4 @@
 ### SEE ALSO
 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_convert_toTOML.md
+++ b/docs/content/commands/hugo_convert_toTOML.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo convert toTOML"
 slug: hugo_convert_toTOML
 url: /commands/hugo_convert_totoml/
@@ -42,4 +42,4 @@
 ### SEE ALSO
 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_convert_toYAML.md
+++ b/docs/content/commands/hugo_convert_toYAML.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo convert toYAML"
 slug: hugo_convert_toYAML
 url: /commands/hugo_convert_toyaml/
@@ -42,4 +42,4 @@
 ### SEE ALSO
 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_env.md
+++ b/docs/content/commands/hugo_env.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo env"
 slug: hugo_env
 url: /commands/hugo_env/
@@ -38,4 +38,4 @@
 ### SEE ALSO
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_gen.md
+++ b/docs/content/commands/hugo_gen.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo gen"
 slug: hugo_gen
 url: /commands/hugo_gen/
@@ -38,4 +38,4 @@
 * [hugo gen doc](/commands/hugo_gen_doc/)	 - Generate Markdown documentation for the Hugo CLI.
 * [hugo gen man](/commands/hugo_gen_man/)	 - Generate man pages for the Hugo CLI
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_gen_autocomplete.md
+++ b/docs/content/commands/hugo_gen_autocomplete.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo gen autocomplete"
 slug: hugo_gen_autocomplete
 url: /commands/hugo_gen_autocomplete/
@@ -56,4 +56,4 @@
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_gen_chromastyles.md
+++ b/docs/content/commands/hugo_gen_chromastyles.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo gen chromastyles"
 slug: hugo_gen_chromastyles
 url: /commands/hugo_gen_chromastyles/
@@ -43,4 +43,4 @@
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_gen_doc.md
+++ b/docs/content/commands/hugo_gen_doc.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo gen doc"
 slug: hugo_gen_doc
 url: /commands/hugo_gen_doc/
@@ -45,4 +45,4 @@
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_gen_man.md
+++ b/docs/content/commands/hugo_gen_man.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo gen man"
 slug: hugo_gen_man
 url: /commands/hugo_gen_man/
@@ -41,4 +41,4 @@
 ### SEE ALSO
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_import.md
+++ b/docs/content/commands/hugo_import.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo import"
 slug: hugo_import
 url: /commands/hugo_import/
@@ -37,4 +37,4 @@
 * [hugo](/commands/hugo/)	 - hugo builds your site
 * [hugo import jekyll](/commands/hugo_import_jekyll/)	 - hugo import from Jekyll
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_import_jekyll.md
+++ b/docs/content/commands/hugo_import_jekyll.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo import jekyll"
 slug: hugo_import_jekyll
 url: /commands/hugo_import_jekyll/
@@ -41,4 +41,4 @@
 ### SEE ALSO
 * [hugo import](/commands/hugo_import/)	 - Import your site from others.
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_list.md
+++ b/docs/content/commands/hugo_list.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo list"
 slug: hugo_list
 url: /commands/hugo_list/
@@ -40,4 +40,4 @@
 * [hugo list expired](/commands/hugo_list_expired/)	 - List all posts already expired
 * [hugo list future](/commands/hugo_list_future/)	 - List all posts dated in the future
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_list_drafts.md
+++ b/docs/content/commands/hugo_list_drafts.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo list drafts"
 slug: hugo_list_drafts
 url: /commands/hugo_list_drafts/
@@ -39,4 +39,4 @@
 ### SEE ALSO
 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_list_expired.md
+++ b/docs/content/commands/hugo_list_expired.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo list expired"
 slug: hugo_list_expired
 url: /commands/hugo_list_expired/
@@ -40,4 +40,4 @@
 ### SEE ALSO
 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_list_future.md
+++ b/docs/content/commands/hugo_list_future.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo list future"
 slug: hugo_list_future
 url: /commands/hugo_list_future/
@@ -40,4 +40,4 @@
 ### SEE ALSO
 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_new.md
+++ b/docs/content/commands/hugo_new.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo new"
 slug: hugo_new
 url: /commands/hugo_new/
@@ -48,4 +48,4 @@
 * [hugo new site](/commands/hugo_new_site/)	 - Create a new site (skeleton)
 * [hugo new theme](/commands/hugo_new_theme/)	 - Create a new theme
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_new_site.md
+++ b/docs/content/commands/hugo_new_site.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo new site"
 slug: hugo_new_site
 url: /commands/hugo_new_site/
@@ -43,4 +43,4 @@
 ### SEE ALSO
 * [hugo new](/commands/hugo_new/)	 - Create new content for your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_new_theme.md
+++ b/docs/content/commands/hugo_new_theme.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo new theme"
 slug: hugo_new_theme
 url: /commands/hugo_new_theme/
@@ -42,4 +42,4 @@
 ### SEE ALSO
 * [hugo new](/commands/hugo_new/)	 - Create new content for your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_server.md
+++ b/docs/content/commands/hugo_server.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo server"
 slug: hugo_server
 url: /commands/hugo_server/
@@ -58,7 +58,7 @@
       --memstats string            log memory usage to this file
       --navigateToChanged          navigate to changed content file on live browser reload
       --noChmod                    don't sync permission mode of files
-      --noHTTPCache                prevent HTTP caching (default true)
+      --noHTTPCache                prevent HTTP caching
       --noTimes                    don't sync modification time of files
       --pluralizeListTitles        pluralize titles in lists using inflect (default true)
   -p, --port int                   port on which the server will listen (default 1313)
@@ -66,6 +66,7 @@
       --renderToDisk               render to Destination path (default is render to memory & serve from there)
   -s, --source string              filesystem path to read files relative from
       --stepAnalysis               display memory and timing of different steps of the program
+      --templateMetrics            display metrics about template executions
   -t, --theme string               theme to use (located in /themes/THEMENAME/)
       --themesDir string           filesystem path to themes directory
       --uglyURLs                   if true, use /filename.html instead of /filename/
@@ -87,4 +88,4 @@
 ### SEE ALSO
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_undraft.md
+++ b/docs/content/commands/hugo_undraft.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo undraft"
 slug: hugo_undraft
 url: /commands/hugo_undraft/
@@ -40,4 +40,4 @@
 ### SEE ALSO
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/commands/hugo_version.md
+++ b/docs/content/commands/hugo_version.md
@@ -1,5 +1,5 @@
 ---
-date: 2017-09-25T08:30:15+02:00
+date: 2017-09-26T21:11:49+02:00
 title: "hugo version"
 slug: hugo_version
 url: /commands/hugo_version/
@@ -38,4 +38,4 @@
 ### SEE ALSO
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 25-Sep-2017
+###### Auto generated by spf13/cobra on 26-Sep-2017
--- a/docs/content/content-management/sections.md
+++ b/docs/content/content-management/sections.md
@@ -43,12 +43,12 @@
     |   ├── event-2.md    // <- example.com/events/event-2/
     |   └── event-3.md    // <- example.com/events/event-3/
     └── posts
-    |   ├── _index.md     // <- example.com/posts/
-    |   ├── event-1.md    // <- example.com/posts/event-1/
-    |   ├── event-2.md    // <- example.com/posts/event-2/
-    |   ├── event-3.md    // <- example.com/posts/event-3/
-    |   ├── event-4.md    // <- example.com/posts/event-4/
-    |   └── event-5.md    // <- example.com/posts/event-5/
+    |   ├── _index.md    // <- example.com/posts/
+    |   ├── post-1.md    // <- example.com/posts/post-1/
+    |   ├── post-2.md    // <- example.com/posts/post-2/
+    |   ├── post-3.md    // <- example.com/posts/post-3/
+    |   ├── post-4.md    // <- example.com/posts/post-4/
+    |   └── post-5.md    // <- example.com/posts/post-5/
 ```
 
 ## Content Section Lists
--- a/docs/content/functions/highlight.md
+++ b/docs/content/functions/highlight.md
@@ -25,4 +25,4 @@
 
 [highlight]: /content-management/shortcodes/#highlight
 [installpygments]: /getting-started/installing/#installing-pygments-optional
-[syntax]: /tools/syntax-highlighting/
+[syntax]: /content-management/syntax-highlighting/
--- a/docs/content/functions/math.md
+++ b/docs/content/functions/math.md
@@ -1,6 +1,6 @@
 ---
 title: Math
-description: Hugo provides six mathematical operators in templates.
+description: Hugo provides nine mathematical operators in templates.
 godocref:
 date: 2017-02-01
 publishdate: 2017-02-01
@@ -20,14 +20,14 @@
 aliases: []
 ---
 
-There are 6 basic mathematical operators that can be used in Hugo templates:
-
-| Function | Description              | Example                       |
-| -------- | ------------------------ | ----------------------------- |
-| `add`    | Adds two integers.       | `{{add 1 2}}` &rarr; 3        |
-| `div`    | Divides two integers.    | `{{div 6 3}}` &rarr; 2        |
-| `mod`    | Modulus of two integers. | `{{mod 15 3}}` &rarr; 0       |
-| `modBool`| Boolean of modulus of two integers. Evaluates to `true` if = 0. | `{{modBool 15 3}}` &rarr; true |
-| `mul`    | Multiplies two integers. | `{{mul 2 3}}` &rarr; 6        |
-| `sub`    | Subtracts two integers.  | `{{sub 3 2}}` &rarr; 1        |
-
+| Function       | Description                                                                   | Example                          |
+|----------------|-------------------------------------------------------------------------------|----------------------------------|
+| `add`          | Adds two integers.                                                            | `{{add 1 2}}` &rarr; 3           |
+| `div`          | Divides two integers.                                                         | `{{div 6 3}}` &rarr; 2           |
+| `mod`          | Modulus of two integers.                                                      | `{{mod 15 3}}` &rarr; 0          |
+| `modBool`      | Boolean of modulus of two integers. Evaluates to `true` if result equals 0.   | `{{modBool 15 3}}` &rarr; true   |
+| `mul`          | Multiplies two integers.                                                      | `{{mul 2 3}}` &rarr; 6           |
+| `sub`          | Subtracts two integers.                                                       | `{{sub 3 2}}` &rarr; 1           |
+| `math.Ceil`    | Returns the least integer value greater than or equal to the given number.    | `{{math.Ceil 2.1}}` &rarr; 3     |
+| `math.Floor`   | Returns the greatest integer value less than or equal to the given number.    | `{{math.Floor 1.9}}` &rarr; 1    |
+| `math.Round`   | Returns the nearest integer, rounding half away from zero.                    | `{{math.Round 1.5}}` &rarr; 2    |
--- /dev/null
+++ b/docs/content/functions/print.md
@@ -1,0 +1,26 @@
+---
+title: print
+linktitle: print
+description: Prints the default representation of the given argument using the standard `fmt.Print` function.
+godocref: https://golang.org/pkg/fmt/
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [strings]
+signature: ["print INPUT"]
+workson: []
+hugoversion:
+relatedfuncs: []
+deprecated: false
+---
+
+See [the go doc](https://golang.org/pkg/fmt/) for additional information.
+
+```
+{{ print "foo" }} → "foo"
+{{ print (slice 1 2 3) }} → [1 2 3]
+```
--- /dev/null
+++ b/docs/content/functions/println.md
@@ -1,0 +1,25 @@
+---
+title: println
+linktitle: println
+description: Prints the default representation of the given argument using the standard `fmt.Print` function and enforces a linebreak.
+godocref: https://golang.org/pkg/fmt/
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [strings]
+signature: ["println INPUT"]
+workson: []
+hugoversion:
+relatedfuncs: []
+deprecated: false
+---
+
+See [the go doc](https://golang.org/pkg/fmt/) for additional information. `\n` denotes the linebreak but isn't printed in the templates as seen below:
+
+```
+{{ println "foo" }} → "foo\n"
+```
--- /dev/null
+++ b/docs/content/functions/strings.TrimLeft.md
@@ -1,0 +1,28 @@
+---
+title: strings.TrimLeft
+description: Returns a slice of a given string with all leading characters contained in the cutset removed.
+godocref:
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [strings]
+signature: ["strings.TrimLeft CUTSET STRING"]
+workson: []
+hugoversion:
+relatedfuncs: [strings.TrimRight]
+deprecated: false
+aliases: []
+---
+
+Given the string `"abba"`, leading `"a"`'s can be removed a follows:
+
+    {{ strings.TrimLeft "abba" "a" }} → "bba"
+
+Numbers can be handled as well:
+
+    {{ strings.TrimLeft 1221 "12" }} → ""
+
--- /dev/null
+++ b/docs/content/functions/strings.TrimPrefix.md
@@ -1,0 +1,25 @@
+---
+title: strings.TrimPrefix
+description: Returns a given string s without the provided leading prefix string. If s doesn't start with prefix, s is returned unchanged.
+godocref:
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [strings]
+signature: ["strings.TrimPrefix PREFIX STRING"]
+workson: []
+hugoversion:
+relatedfuncs: [strings.TrimSuffix]
+deprecated: false
+aliases: []
+---
+
+Given the string `"aabbaa"`, the specified prefix is only removed if `"aabbaa"` starts with it:
+
+    {{ strings.TrimPrefix "a" "aabbaa" }} → "abbaa"
+    {{ strings.TrimPrefix "aa" "aabbaa" }} → "bbaa"
+    {{ strings.TrimPrefix "aaa" "aabbaa" }} → "aabbaa"
\ No newline at end of file
--- /dev/null
+++ b/docs/content/functions/strings.TrimRight.md
@@ -1,0 +1,28 @@
+---
+title: strings.TrimRight
+description: Returns a slice of a given string with all trailing characters contained in the cutset removed.
+godocref:
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [strings]
+signature: ["strings.TrimRight CUTSET STRING"]
+workson: []
+hugoversion:
+relatedfuncs: [strings.TrimRight]
+deprecated: false
+aliases: []
+---
+
+Given the string `"abba"`, trailing `"a"`'s can be removed a follows:
+
+    {{ strings.TrimRight "abba" "a" }} → "abb"
+
+Numbers can be handled as well:
+
+    {{ strings.TrimRight 1221 "12" }} → ""
+
--- /dev/null
+++ b/docs/content/functions/strings.TrimSuffix.md
@@ -1,0 +1,25 @@
+---
+title: strings.TrimSuffix
+description: Returns a given string s without the provided trailing suffix string. If s doesn't end with suffix, s is returned unchanged.
+godocref:
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [strings]
+signature: ["strings.TrimSuffix SUFFIX STRING"]
+workson: []
+hugoversion:
+relatedfuncs: [strings.TrimPrefix]
+deprecated: false
+aliases: []
+---
+
+Given the string `"aabbaa"`, the specified suffix is only removed if `"aabbaa"` ends with it:
+
+    {{ strings.TrimSuffix "a" "aabbaa" }} → "aabba"
+    {{ strings.TrimSuffix "aa" "aabbaa" }} → "aabb"
+    {{ strings.TrimSuffix "aaa" "aabbaa" }} → "aabbaa"
\ No newline at end of file
--- /dev/null
+++ b/docs/content/functions/urls.Parse.md
@@ -1,0 +1,32 @@
+---
+title: urls.Parse
+description: Parse parses a given url, which may be relative or absolute, into a URL structure.
+godocref: https://godoc.org/net/url#URL
+date: 2017-09-25
+publishdate: 2017-09-25
+lastmod: 2017-09-25
+categories: [functions]
+menu:
+  docs:
+    parent: "functions"
+keywords: [urls]
+signature: ["urls.Parse URL"]
+workson: []
+hugoversion:
+deprecated: false
+aliases: []
+---
+
+`urls.Parse` takes a url as input
+
+
+```
+{{ $url := urls.Parse "http://www.gohugo.io" }}		
+```
+
+and returns a [URL](https://godoc.org/net/url#URL) structure. The struct fields are accessed via the `.` notation:
+
+```
+{{ $url.Scheme }} → "http"
+{{ $url.Host }} → "www.gohugo.io"
+```
\ No newline at end of file
--- a/docs/content/news/0.28-relnotes-ready.md
+++ b/docs/content/news/0.28-relnotes-ready.md
@@ -1,16 +1,25 @@
 
 ---
 date: 2017-09-25
-title: "0.28"
-description: "0.28"
+title: "Hugo 0.28: High-speed Syntax Highlighting!"
+description: "Chroma is the new default syntax highlighter in Hugo."
 categories: ["Releases"]
+slug: "0.28-relnotes"
+images:
+- images/blog/hugo-28-poster.png
 ---
 
 	Hugo `0.28` brings **blistering fast and native syntax highlighting** from [Chroma](https://github.com/alecthomas/chroma) ([fb33d828](https://github.com/gohugoio/hugo/commit/fb33d8286d78a78a74deb44355b621852a1c4033) [@bep](https://github.com/bep) [#3888](https://github.com/gohugoio/hugo/issues/3888)). A big thank you to [Alec Thomas](https://github.com/alecthomas) for taking on this massive task of porting the popular python highlighter Pygments to Go.
 
-Worth mentioning is also the `liveReloadPort`  flag on `hugo server`, which makes it possible to do "live reloads" behind a HTTPS proxy, which makes for very cool remote customer demos. 
+Hugo has been caching the highlighter output to disk, so for repeated builds it has been fine, but this little snippet, showing a build of the [gohugo.io](https://gohugo.io/) site without cache and with both Pygments and Chroma, should illustrate the improvement:
 
-One example would be a Hugo server running behind a [ngrok](https://http://ngrok.com) tunnel:
+{{< asciicast Lc5iwTVny2kuUC8lqvNnL6oDU >}}
+
+See the [Updated Documentation](https://gohugo.io/content-management/syntax-highlighting/) for more information about how this works.
+
+Worth mentioning is also the `liveReloadPort`  flag on `hugo server`, which makes it possible to do "live reloads" behind a HTTPS proxy, which makes for very cool remote customer demos.
+
+One example would be a Hugo server running behind a [ngrok](https://ngrok.com) tunnel:
 
 ```bash
 ngrok http 1313
--- a/docs/content/news/0.29-relnotes-ready.md
+++ b/docs/content/news/0.29-relnotes-ready.md
@@ -1,11 +1,13 @@
 
 ---
 date: 2017-09-26
-title: "0.29"
-description: "0.29"
+title: "Hugo 0.29: Template Metrics"
+description: "Makes it easy to find template bottle necks."
 categories: ["Releases"]
+slug: "0.29-relnotes"
+images:
+- images/blog/hugo-29-poster.png
 ---
-
 	
 Hugo `0.29` brings Template Metrics by [@moorereason](https://github.com/moorereason). Hugo is very fast, but it is still possible to write ineffective templates. Now these should be easy to identify. Just run:
 
--- a/docs/content/templates/internal.md
+++ b/docs/content/templates/internal.md
@@ -129,3 +129,5 @@
 * `_internal/schema.html`
 * `_internal/twitter_cards.html`
 
+[disqus]: https://disqus.com
+[disqussignup]: https://disqus.com/profile/signup/
--- a/docs/content/templates/rss.md
+++ b/docs/content/templates/rss.md
@@ -31,7 +31,7 @@
 Hugo ships with its own [RSS 2.0 template](#the-embedded-rss-xml). The embedded template will be sufficient for most use cases.
 {{% /note %}}
 
-RSS pages are of the type `Page` and have all the [page variables](/layout/variables/) available to use in the templates.
+RSS pages are of the type `Page` and have all the [page variables](/variables/page/) available to use in the templates.
 
 ### Section RSS
 
--- a/docs/content/tools/editors.md
+++ b/docs/content/tools/editors.md
@@ -31,6 +31,7 @@
 ## Emacs
 
 * [hugo.el](https://github.com/yewton/hugo.el). Some helper functions for creating a Website with Hugo. Note that Hugo also supports [Org-mode][formats].
+* [ox-hugo.el](https://ox-hugo.netlify.com). Native Org-mode exporter that exports to Blackfriday Markdown with Hugo front-matter. `ox-hugo` supports two common Org blogging flows --- exporting multiple Org sub-trees in a single file to multiple Hugo posts, and exporting a single Org file to a single Hugo post. It also leverages the Org tag and property inheritance features. See [*Why ox-hugo?*](https://ox-hugo.netlify.com/doc/why-ox-hugo/) for more.
 
 ## Vim
 
@@ -41,4 +42,4 @@
 * [Hugofy](https://atom.io/packages/hugofy). A Hugo Static Website Generator package for Atom.
 * [language-hugo](https://atom.io/packages/language-hugo). Adds syntax highlighting to Hugo files.
 
-[formats]: /content-management/formats/
\ No newline at end of file
+[formats]: /content-management/formats/
--- a/docs/content/tools/migrations.md
+++ b/docs/content/tools/migrations.md
@@ -23,7 +23,7 @@
 Do you know or maintain a similar project around Hugo? Feel free to open a [pull request](https://github.com/gohugoio/hugo/pulls) on GitHub if you think it should be added.
 {{% /note %}}
 
-Take a look at this list of migration tools if you currently use other logging tools like Jekyll or WordPress but intend to switch to Hugo instead. They'll take care to export your content into Hugo-friendly formats.
+Take a look at this list of migration tools if you currently use other blogging tools like Jekyll or WordPress but intend to switch to Hugo instead. They'll take care to export your content into Hugo-friendly formats.
 
 ## Jekyll
 
--- a/docs/netlify.toml
+++ b/docs/netlify.toml
@@ -3,15 +3,15 @@
   command = "hugo"
 
 [context.production.environment]
-  HUGO_VERSION = "0.27.1"
+  HUGO_VERSION = "0.29"
   HUGO_ENV = "production"
   HUGO_ENABLEGITINFO = "true"
 
 [context.deploy-preview.environment]
-  HUGO_VERSION = "0.27.1"
+  HUGO_VERSION = "0.29"
 
 [context.branch-deploy.environment]
-  HUGO_VERSION = "0.27.1"
+  HUGO_VERSION = "0.29"
 
 [context.next.environment]
   HUGO_BASEURL = "https://next--gohugoio.netlify.com/"
binary files /dev/null b/docs/static/images/blog/hugo-28-poster.png differ
binary files /dev/null b/docs/static/images/blog/hugo-29-poster.png differ