Merge commit '9d68f695e782c6a83c77aff13317c7a22c694c98'

This commit is contained in:
Bjørn Erik Pedersen 2017-09-28 17:22:55 +02:00
commit b6a30283f0
47 changed files with 294 additions and 87 deletions

1
docs/.gitignore vendored
View file

@ -1,2 +1,3 @@
/.idea /.idea
/public /public
nohup.out

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo" title: "hugo"
slug: hugo slug: hugo
url: /commands/hugo/ url: /commands/hugo/
@ -56,6 +56,7 @@ hugo [flags]
--renderToMemory render to memory (only useful for benchmark testing) --renderToMemory render to memory (only useful for benchmark testing)
-s, --source string filesystem path to read files relative from -s, --source string filesystem path to read files relative from
--stepAnalysis display memory and timing of different steps of the program --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/) -t, --theme string theme to use (located in /themes/THEMENAME/)
--themesDir string filesystem path to themes directory --themesDir string filesystem path to themes directory
--uglyURLs if true, use /filename.html instead of /filename/ --uglyURLs if true, use /filename.html instead of /filename/
@ -78,4 +79,4 @@ hugo [flags]
* [hugo undraft](/commands/hugo_undraft/) - Undraft resets the content's draft status * [hugo undraft](/commands/hugo_undraft/) - Undraft resets the content's draft status
* [hugo version](/commands/hugo_version/) - Print the version number of Hugo * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo benchmark" title: "hugo benchmark"
slug: hugo_benchmark slug: hugo_benchmark
url: /commands/hugo_benchmark/ url: /commands/hugo_benchmark/
@ -50,6 +50,7 @@ hugo benchmark [flags]
--renderToMemory render to memory (only useful for benchmark testing) --renderToMemory render to memory (only useful for benchmark testing)
-s, --source string filesystem path to read files relative from -s, --source string filesystem path to read files relative from
--stepAnalysis display memory and timing of different steps of the program --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/) -t, --theme string theme to use (located in /themes/THEMENAME/)
--themesDir string filesystem path to themes directory --themesDir string filesystem path to themes directory
--uglyURLs if true, use /filename.html instead of /filename/ --uglyURLs if true, use /filename.html instead of /filename/
@ -70,4 +71,4 @@ hugo benchmark [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo check" title: "hugo check"
slug: hugo_check slug: hugo_check
url: /commands/hugo_check/ url: /commands/hugo_check/
@ -35,4 +35,4 @@ Contains some verification checks
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
* [hugo check ulimit](/commands/hugo_check_ulimit/) - Check system ulimit settings * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo check ulimit" title: "hugo check ulimit"
slug: hugo_check_ulimit slug: hugo_check_ulimit
url: /commands/hugo_check_ulimit/ url: /commands/hugo_check_ulimit/
@ -39,4 +39,4 @@ hugo check ulimit [flags]
### SEE ALSO ### SEE ALSO
* [hugo check](/commands/hugo_check/) - Contains some verification checks * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo config" title: "hugo config"
slug: hugo_config slug: hugo_config
url: /commands/hugo_config/ url: /commands/hugo_config/
@ -38,4 +38,4 @@ hugo config [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo convert" title: "hugo convert"
slug: hugo_convert slug: hugo_convert
url: /commands/hugo_convert/ url: /commands/hugo_convert/
@ -42,4 +42,4 @@ See convert's subcommands toJSON, toTOML and toYAML for more information.
* [hugo convert toTOML](/commands/hugo_convert_totoml/) - Convert front matter to TOML * [hugo convert toTOML](/commands/hugo_convert_totoml/) - Convert front matter to TOML
* [hugo convert toYAML](/commands/hugo_convert_toyaml/) - Convert front matter to YAML * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo convert toJSON" title: "hugo convert toJSON"
slug: hugo_convert_toJSON slug: hugo_convert_toJSON
url: /commands/hugo_convert_tojson/ url: /commands/hugo_convert_tojson/
@ -42,4 +42,4 @@ hugo convert toJSON [flags]
### SEE ALSO ### SEE ALSO
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo convert toTOML" title: "hugo convert toTOML"
slug: hugo_convert_toTOML slug: hugo_convert_toTOML
url: /commands/hugo_convert_totoml/ url: /commands/hugo_convert_totoml/
@ -42,4 +42,4 @@ hugo convert toTOML [flags]
### SEE ALSO ### SEE ALSO
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo convert toYAML" title: "hugo convert toYAML"
slug: hugo_convert_toYAML slug: hugo_convert_toYAML
url: /commands/hugo_convert_toyaml/ url: /commands/hugo_convert_toyaml/
@ -42,4 +42,4 @@ hugo convert toYAML [flags]
### SEE ALSO ### SEE ALSO
* [hugo convert](/commands/hugo_convert/) - Convert your content to different formats * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo env" title: "hugo env"
slug: hugo_env slug: hugo_env
url: /commands/hugo_env/ url: /commands/hugo_env/
@ -38,4 +38,4 @@ hugo env [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo gen" title: "hugo gen"
slug: hugo_gen slug: hugo_gen
url: /commands/hugo_gen/ url: /commands/hugo_gen/
@ -38,4 +38,4 @@ A collection of several useful generators.
* [hugo gen doc](/commands/hugo_gen_doc/) - Generate Markdown documentation for the Hugo CLI. * [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 * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo gen autocomplete" title: "hugo gen autocomplete"
slug: hugo_gen_autocomplete slug: hugo_gen_autocomplete
url: /commands/hugo_gen_autocomplete/ url: /commands/hugo_gen_autocomplete/
@ -56,4 +56,4 @@ hugo gen autocomplete [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo gen chromastyles" title: "hugo gen chromastyles"
slug: hugo_gen_chromastyles slug: hugo_gen_chromastyles
url: /commands/hugo_gen_chromastyles/ url: /commands/hugo_gen_chromastyles/
@ -43,4 +43,4 @@ hugo gen chromastyles [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo gen doc" title: "hugo gen doc"
slug: hugo_gen_doc slug: hugo_gen_doc
url: /commands/hugo_gen_doc/ url: /commands/hugo_gen_doc/
@ -45,4 +45,4 @@ hugo gen doc [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo gen man" title: "hugo gen man"
slug: hugo_gen_man slug: hugo_gen_man
url: /commands/hugo_gen_man/ url: /commands/hugo_gen_man/
@ -41,4 +41,4 @@ hugo gen man [flags]
### SEE ALSO ### SEE ALSO
* [hugo gen](/commands/hugo_gen/) - A collection of several useful generators. * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo import" title: "hugo import"
slug: hugo_import slug: hugo_import
url: /commands/hugo_import/ url: /commands/hugo_import/
@ -37,4 +37,4 @@ Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_p
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
* [hugo import jekyll](/commands/hugo_import_jekyll/) - hugo import from Jekyll * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo import jekyll" title: "hugo import jekyll"
slug: hugo_import_jekyll slug: hugo_import_jekyll
url: /commands/hugo_import_jekyll/ url: /commands/hugo_import_jekyll/
@ -41,4 +41,4 @@ hugo import jekyll [flags]
### SEE ALSO ### SEE ALSO
* [hugo import](/commands/hugo_import/) - Import your site from others. * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo list" title: "hugo list"
slug: hugo_list slug: hugo_list
url: /commands/hugo_list/ url: /commands/hugo_list/
@ -40,4 +40,4 @@ List requires a subcommand, e.g. `hugo list drafts`.
* [hugo list expired](/commands/hugo_list_expired/) - List all posts already expired * [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 * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo list drafts" title: "hugo list drafts"
slug: hugo_list_drafts slug: hugo_list_drafts
url: /commands/hugo_list_drafts/ url: /commands/hugo_list_drafts/
@ -39,4 +39,4 @@ hugo list drafts [flags]
### SEE ALSO ### SEE ALSO
* [hugo list](/commands/hugo_list/) - Listing out various types of content * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo list expired" title: "hugo list expired"
slug: hugo_list_expired slug: hugo_list_expired
url: /commands/hugo_list_expired/ url: /commands/hugo_list_expired/
@ -40,4 +40,4 @@ hugo list expired [flags]
### SEE ALSO ### SEE ALSO
* [hugo list](/commands/hugo_list/) - Listing out various types of content * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo list future" title: "hugo list future"
slug: hugo_list_future slug: hugo_list_future
url: /commands/hugo_list_future/ url: /commands/hugo_list_future/
@ -40,4 +40,4 @@ hugo list future [flags]
### SEE ALSO ### SEE ALSO
* [hugo list](/commands/hugo_list/) - Listing out various types of content * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo new" title: "hugo new"
slug: hugo_new slug: hugo_new
url: /commands/hugo_new/ url: /commands/hugo_new/
@ -48,4 +48,4 @@ hugo new [path] [flags]
* [hugo new site](/commands/hugo_new_site/) - Create a new site (skeleton) * [hugo new site](/commands/hugo_new_site/) - Create a new site (skeleton)
* [hugo new theme](/commands/hugo_new_theme/) - Create a new theme * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo new site" title: "hugo new site"
slug: hugo_new_site slug: hugo_new_site
url: /commands/hugo_new_site/ url: /commands/hugo_new_site/
@ -43,4 +43,4 @@ hugo new site [path] [flags]
### SEE ALSO ### SEE ALSO
* [hugo new](/commands/hugo_new/) - Create new content for your site * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo new theme" title: "hugo new theme"
slug: hugo_new_theme slug: hugo_new_theme
url: /commands/hugo_new_theme/ url: /commands/hugo_new_theme/
@ -42,4 +42,4 @@ hugo new theme [name] [flags]
### SEE ALSO ### SEE ALSO
* [hugo new](/commands/hugo_new/) - Create new content for your site * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo server" title: "hugo server"
slug: hugo_server slug: hugo_server
url: /commands/hugo_server/ url: /commands/hugo_server/
@ -58,7 +58,7 @@ hugo server [flags]
--memstats string log memory usage to this file --memstats string log memory usage to this file
--navigateToChanged navigate to changed content file on live browser reload --navigateToChanged navigate to changed content file on live browser reload
--noChmod don't sync permission mode of files --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 --noTimes don't sync modification time of files
--pluralizeListTitles pluralize titles in lists using inflect (default true) --pluralizeListTitles pluralize titles in lists using inflect (default true)
-p, --port int port on which the server will listen (default 1313) -p, --port int port on which the server will listen (default 1313)
@ -66,6 +66,7 @@ hugo server [flags]
--renderToDisk render to Destination path (default is render to memory & serve from there) --renderToDisk render to Destination path (default is render to memory & serve from there)
-s, --source string filesystem path to read files relative from -s, --source string filesystem path to read files relative from
--stepAnalysis display memory and timing of different steps of the program --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/) -t, --theme string theme to use (located in /themes/THEMENAME/)
--themesDir string filesystem path to themes directory --themesDir string filesystem path to themes directory
--uglyURLs if true, use /filename.html instead of /filename/ --uglyURLs if true, use /filename.html instead of /filename/
@ -87,4 +88,4 @@ hugo server [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo undraft" title: "hugo undraft"
slug: hugo_undraft slug: hugo_undraft
url: /commands/hugo_undraft/ url: /commands/hugo_undraft/
@ -40,4 +40,4 @@ hugo undraft path/to/content [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [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

View file

@ -1,5 +1,5 @@
--- ---
date: 2017-09-25T08:30:15+02:00 date: 2017-09-26T21:11:49+02:00
title: "hugo version" title: "hugo version"
slug: hugo_version slug: hugo_version
url: /commands/hugo_version/ url: /commands/hugo_version/
@ -38,4 +38,4 @@ hugo version [flags]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [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

View file

@ -44,11 +44,11 @@ The following example shows a content directory structure for a website that has
| └── event-3.md // <- example.com/events/event-3/ | └── event-3.md // <- example.com/events/event-3/
└── posts └── posts
| ├── _index.md // <- example.com/posts/ | ├── _index.md // <- example.com/posts/
| ├── event-1.md // <- example.com/posts/event-1/ | ├── post-1.md // <- example.com/posts/post-1/
| ├── event-2.md // <- example.com/posts/event-2/ | ├── post-2.md // <- example.com/posts/post-2/
| ├── event-3.md // <- example.com/posts/event-3/ | ├── post-3.md // <- example.com/posts/post-3/
| ├── event-4.md // <- example.com/posts/event-4/ | ├── post-4.md // <- example.com/posts/post-4/
| └── event-5.md // <- example.com/posts/event-5/ | └── post-5.md // <- example.com/posts/post-5/
``` ```
## Content Section Lists ## Content Section Lists

View file

@ -25,4 +25,4 @@ See [Installing Hugo][installpygments] for more information on Pygments or [Synt
[highlight]: /content-management/shortcodes/#highlight [highlight]: /content-management/shortcodes/#highlight
[installpygments]: /getting-started/installing/#installing-pygments-optional [installpygments]: /getting-started/installing/#installing-pygments-optional
[syntax]: /tools/syntax-highlighting/ [syntax]: /content-management/syntax-highlighting/

View file

@ -1,6 +1,6 @@
--- ---
title: Math title: Math
description: Hugo provides six mathematical operators in templates. description: Hugo provides nine mathematical operators in templates.
godocref: godocref:
date: 2017-02-01 date: 2017-02-01
publishdate: 2017-02-01 publishdate: 2017-02-01
@ -20,14 +20,14 @@ draft: false
aliases: [] aliases: []
--- ---
There are 6 basic mathematical operators that can be used in Hugo templates:
| Function | Description | Example | | Function | Description | Example |
| -------- | ------------------------ | ----------------------------- | |----------------|-------------------------------------------------------------------------------|----------------------------------|
| `add` | Adds two integers. | `{{add 1 2}}` &rarr; 3 | | `add` | Adds two integers. | `{{add 1 2}}` &rarr; 3 |
| `div` | Divides two integers. | `{{div 6 3}}` &rarr; 2 | | `div` | Divides two integers. | `{{div 6 3}}` &rarr; 2 |
| `mod` | Modulus of two integers. | `{{mod 15 3}}` &rarr; 0 | | `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 | | `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 | | `mul` | Multiplies two integers. | `{{mul 2 3}}` &rarr; 6 |
| `sub` | Subtracts two integers. | `{{sub 3 2}}` &rarr; 1 | | `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 |

View file

@ -0,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]
```

View file

@ -0,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"
```

View file

@ -0,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" }} → ""

View file

@ -0,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"

View file

@ -0,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" }} → ""

View file

@ -0,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"

View file

@ -0,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"
```

View file

@ -1,16 +1,25 @@
--- ---
date: 2017-09-25 date: 2017-09-25
title: "0.28" title: "Hugo 0.28: High-speed Syntax Highlighting!"
description: "0.28" description: "Chroma is the new default syntax highlighter in Hugo."
categories: ["Releases"] 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. 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.
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:
{{< 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. 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://http://ngrok.com) tunnel: One example would be a Hugo server running behind a [ngrok](https://ngrok.com) tunnel:
```bash ```bash
ngrok http 1313 ngrok http 1313

View file

@ -1,12 +1,14 @@
--- ---
date: 2017-09-26 date: 2017-09-26
title: "0.29" title: "Hugo 0.29: Template Metrics"
description: "0.29" description: "Makes it easy to find template bottle necks."
categories: ["Releases"] 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: 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:
```bash ```bash

View file

@ -129,3 +129,5 @@ You can then render your custom Disqus partial template as follows:
* `_internal/schema.html` * `_internal/schema.html`
* `_internal/twitter_cards.html` * `_internal/twitter_cards.html`
[disqus]: https://disqus.com
[disqussignup]: https://disqus.com/profile/signup/

View file

@ -31,7 +31,7 @@ You can use a single RSS template to generate all of your RSS feeds or create a
Hugo ships with its own [RSS 2.0 template](#the-embedded-rss-xml). The embedded template will be sufficient for most use cases. Hugo ships with its own [RSS 2.0 template](#the-embedded-rss-xml). The embedded template will be sufficient for most use cases.
{{% /note %}} {{% /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 ### Section RSS

View file

@ -31,6 +31,7 @@ The Hugo community uses a wide range of preferred tools and has developed plug-i
## Emacs ## 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]. * [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 ## Vim

View file

@ -23,7 +23,7 @@ This section highlights some projects around Hugo that are independently develop
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. 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 %}} {{% /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 ## Jekyll

View file

@ -3,15 +3,15 @@
command = "hugo" command = "hugo"
[context.production.environment] [context.production.environment]
HUGO_VERSION = "0.27.1" HUGO_VERSION = "0.29"
HUGO_ENV = "production" HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true" HUGO_ENABLEGITINFO = "true"
[context.deploy-preview.environment] [context.deploy-preview.environment]
HUGO_VERSION = "0.27.1" HUGO_VERSION = "0.29"
[context.branch-deploy.environment] [context.branch-deploy.environment]
HUGO_VERSION = "0.27.1" HUGO_VERSION = "0.29"
[context.next.environment] [context.next.environment]
HUGO_BASEURL = "https://next--gohugoio.netlify.com/" HUGO_BASEURL = "https://next--gohugoio.netlify.com/"

Binary file not shown.

After

Width:  |  Height:  |  Size: 114 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 120 KiB