github/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2024-11-21 20:46:30 -05:00
Code Issues Projects Releases Packages Wiki Activity

Merge commit '9d68f695e782c6a83c77aff13317c7a22c694c98'

Browse source
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
Show stats Download patch file Download diff file Expand all files Collapse all files

1
docs/.gitignore vendored
View file

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

5
docs/content/commands/hugo.md
View file

@ -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 @@ hugo [flags]
--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 [flags]
* [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

5
docs/content/commands/hugo_benchmark.md
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"
slug: hugo_benchmark
url: /commands/hugo_benchmark/
@ -50,6 +50,7 @@ hugo benchmark [flags]
--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 @@ hugo benchmark [flags]
### 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

4
docs/content/commands/hugo_check.md
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"
slug: hugo_check
url: /commands/hugo_check/
@ -35,4 +35,4 @@ Contains some verification checks
* [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

4
docs/content/commands/hugo_check_ulimit.md
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"
slug: hugo_check_ulimit
url: /commands/hugo_check_ulimit/
@ -39,4 +39,4 @@ hugo check ulimit [flags]
### 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

4
docs/content/commands/hugo_config.md
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"
slug: hugo_config
url: /commands/hugo_config/
@ -38,4 +38,4 @@ hugo config [flags]
### 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

4
docs/content/commands/hugo_convert.md
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"
slug: 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 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

4
docs/content/commands/hugo_convert_toJSON.md
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"
slug: hugo_convert_toJSON
url: /commands/hugo_convert_tojson/
@ -42,4 +42,4 @@ hugo convert toJSON [flags]
### 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

4
docs/content/commands/hugo_convert_toTOML.md
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"
slug: hugo_convert_toTOML
url: /commands/hugo_convert_totoml/
@ -42,4 +42,4 @@ hugo convert toTOML [flags]
### 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

4
docs/content/commands/hugo_convert_toYAML.md
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"
slug: hugo_convert_toYAML
url: /commands/hugo_convert_toyaml/
@ -42,4 +42,4 @@ hugo convert toYAML [flags]
### 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

4
docs/content/commands/hugo_env.md
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"
slug: hugo_env
url: /commands/hugo_env/
@ -38,4 +38,4 @@ hugo env [flags]
### 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

4
docs/content/commands/hugo_gen.md
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"
slug: 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 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

4
docs/content/commands/hugo_gen_autocomplete.md
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"
slug: hugo_gen_autocomplete
url: /commands/hugo_gen_autocomplete/
@ -56,4 +56,4 @@ hugo gen autocomplete [flags]
### 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

4
docs/content/commands/hugo_gen_chromastyles.md
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"
slug: hugo_gen_chromastyles
url: /commands/hugo_gen_chromastyles/
@ -43,4 +43,4 @@ hugo gen chromastyles [flags]
### 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

4
docs/content/commands/hugo_gen_doc.md
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"
slug: hugo_gen_doc
url: /commands/hugo_gen_doc/
@ -45,4 +45,4 @@ hugo gen doc [flags]
### 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

4
docs/content/commands/hugo_gen_man.md
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"
slug: hugo_gen_man
url: /commands/hugo_gen_man/
@ -41,4 +41,4 @@ hugo gen man [flags]
### 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

4
docs/content/commands/hugo_import.md
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"
slug: 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 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

4
docs/content/commands/hugo_import_jekyll.md
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"
slug: hugo_import_jekyll
url: /commands/hugo_import_jekyll/
@ -41,4 +41,4 @@ hugo import jekyll [flags]
### 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

4
docs/content/commands/hugo_list.md
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"
slug: 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 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

4
docs/content/commands/hugo_list_drafts.md
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"
slug: hugo_list_drafts
url: /commands/hugo_list_drafts/
@ -39,4 +39,4 @@ hugo list drafts [flags]
### 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

4
docs/content/commands/hugo_list_expired.md
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"
slug: hugo_list_expired
url: /commands/hugo_list_expired/
@ -40,4 +40,4 @@ hugo list expired [flags]
### 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

4
docs/content/commands/hugo_list_future.md
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"
slug: hugo_list_future
url: /commands/hugo_list_future/
@ -40,4 +40,4 @@ hugo list future [flags]
### 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

4
docs/content/commands/hugo_new.md
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"
slug: 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 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

4
docs/content/commands/hugo_new_site.md
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"
slug: hugo_new_site
url: /commands/hugo_new_site/
@ -43,4 +43,4 @@ hugo new site [path] [flags]
### 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

4
docs/content/commands/hugo_new_theme.md
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"
slug: hugo_new_theme
url: /commands/hugo_new_theme/
@ -42,4 +42,4 @@ hugo new theme [name] [flags]
### 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

7
docs/content/commands/hugo_server.md
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"
slug: hugo_server
url: /commands/hugo_server/
@ -58,7 +58,7 @@ hugo server [flags]
--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 @@ hugo server [flags]
--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 @@ hugo server [flags]
### 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

4
docs/content/commands/hugo_undraft.md
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"
slug: hugo_undraft
url: /commands/hugo_undraft/
@ -40,4 +40,4 @@ hugo undraft path/to/content [flags]
### 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

4
docs/content/commands/hugo_version.md
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"
slug: hugo_version
url: /commands/hugo_version/
@ -38,4 +38,4 @@ hugo version [flags]
### 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

12
docs/content/content-management/sections.md
View file

@ -43,12 +43,12 @@ The following example shows a content directory structure for a website that has
| ├── 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

2
docs/content/functions/highlight.md
View file

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

24
docs/content/functions/math.md
View file

@ -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 @@ draft: false
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 |

26
docs/content/functions/print.md Normal file
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]
```

25
docs/content/functions/println.md Normal file
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"
```

28
docs/content/functions/strings.TrimLeft.md Normal file
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" }} → ""

25
docs/content/functions/strings.TrimPrefix.md Normal file
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"

28
docs/content/functions/strings.TrimRight.md Normal file
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" }} → ""

25
docs/content/functions/strings.TrimSuffix.md Normal file
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"

32
docs/content/functions/urls.Parse.md Normal file
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"
```

17
docs/content/news/0.28-relnotes-ready.md
View file

@ -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

8
docs/content/news/0.29-relnotes-ready.md
View file

@ -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:

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

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

2
docs/content/templates/rss.md
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.
{{% /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

3
docs/content/tools/editors.md
View file

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

2
docs/content/tools/migrations.md
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.
{{% /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

6
docs/netlify.toml
View file

@ -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/"

BIN
docs/static/images/blog/hugo-28-poster.png vendored Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 114 KiB

BIN
docs/static/images/blog/hugo-29-poster.png vendored Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 120 KiB