Squashed 'docs/' changes from e161ea09d..0fd7b4169

0fd7b4169 Fix typo: pygmentsUseClasses -> pygmentsUseClassic
9a3e1c19a Clarify that lower weight gets higher precedence
820d8b581 Clarify the true behavior of hrefTargetBlank #blackfriday
eb3aa5e46 Fix typo
9aedb9269 Add examples for removing default taxonomies
772a26f84 Fix source link on maintainance
975c215ae Minor edits.
2bdb1a150 Fix invalid iink
991d2e139 Fix misspelling
60af8dfb0 Update eSolia link
d7426b76e Release 0.40.3
4977bd9cf Merge branch 'release-0.40.3'
9946f7108 releaser: Prepare repository for 0.41-DEV
beef16b01 releaser: Add release notes to /docs for release of 0.40.3
80c51c55a releaser: Bump versions for release of 0.40.3
21e2934c5 rename `taxonomies.html` to `taxonomy.html`
34a02c289 Add release notes from Hugo 0.7 to 0.15 for completeness
b593f512e Update related.md
7c2bf528b Fix the "edit this page" link
e8fbc163e Add warning about cond
ae15a8831 Add link to Markdown Guide
e077dfd65 Added documentation for a new migration tool: BlogMl2Hugo
957bfb6a8 Add Talkayrd, a new commenting system, & fix txtpen link
86acea7f8 Tomango showcase
3c2fc32f1 Fix snap classic command in installing.md
9a76f1737 Merge commit '83bef6955e014d40c0f00db9cebe09113154e999'
a4b71fb84 Fix typo

git-subtree-dir: docs
git-subtree-split: 0fd7b416997bf76cd99e3ae2dfae406cb8b6724a
This commit is contained in:
Bjørn Erik Pedersen 2018-05-25 15:04:07 +02:00
parent 83bef6955e
commit d2b1030060
36 changed files with 519 additions and 34 deletions

View file

@ -70,7 +70,7 @@ twitter = "GoHugoIO"
[params]
description = "The worlds fastest framework for building websites"
## Used for views in rendered HTML (i.e., rather than using the .Hugo variable)
release = "0.40.2"
release = "0.40.3"
## Setting this to true will add a "noindex" to *EVERY* page on the site
removefromexternalsearch = false
## Gh repo for site footer (include trailing slash)

View file

@ -33,7 +33,7 @@ features:
copy: Hugo allows you to output your content in multiple formats, including JSON or AMP, and makes it easy to create your own.
sections:
- heading: "100s of Themes"
cta: Check out the Hugo's themes.
cta: Check out the Hugo themes.
link: http://themes.gohugo.io/
color_classes: bg-accent-color white
image: /images/homepage-screenshot-hugo-themes.jpg

View file

@ -48,7 +48,8 @@ See [Partial Templates][partials] to learn how to add the Disqus partial to your
There are a few alternatives to commenting on static sites for those who do not want to use Disqus:
* [Static Man](https://staticman.net/)
* [txtpen](https://txtpen.com)
* [Talkyard](https://www.talkyard.io/blog-comments) (Open source, & serverless hosting)
* [txtpen](https://txtpen.github.io/hn/)
* [IntenseDebate](http://intensedebate.com/)
* [Graph Comment][]
* [Muut](http://muut.com/)

View file

@ -219,6 +219,7 @@ Markdown syntax is simple enough to learn in a single sitting. The following are
* [Daring Fireball: Markdown, John Gruber (Creator of Markdown)][fireball]
* [Markdown Cheatsheet, Adam Pritchard][mdcheatsheet]
* [Markdown Tutorial (Interactive), Garen Torikian][mdtutorial]
* [The Markdown Guide, Matt Cone][mdguide]
[`emojify` function]: /functions/emojify/
[ascii]: http://asciidoctor.org/
@ -237,6 +238,7 @@ Markdown syntax is simple enough to learn in a single sitting. The following are
[ietf]: https://tools.ietf.org/html/
[mathjaxdocs]: https://docs.mathjax.org/en/latest/
[mdcheatsheet]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
[mdguide]: https://www.markdownguide.org/
[mdtutorial]: http://www.markdowntutorial.com/
[Miek Gieben's website]: https://miek.nl/2016/March/05/mmark-syntax-document/
[mmark]: https://github.com/miekg/mmark

View file

@ -115,7 +115,7 @@ url
the multilingual feature.
weight
: used for [ordering your content in lists][ordering].
: used for [ordering your content in lists][ordering]. Lower weight gets higher precedence. So content with lower weight will come first.
\<taxonomies\>
: field name of the *plural* form of the index. See `tags` and `categories` in the above front matter examples. _Note that the plural form of user-defined taxonomies cannot be the same as any of the predefined front matter variables._

View file

@ -166,7 +166,7 @@ All of the above settings can also be set per image procecssing.
## Smart Cropping of Images
By default, Hugo will use the [Smartcrop](https://github.com/muesli/smartcrop), a library created by [muesli](https://github.com/muesli), when cropping images with `.Fill`. You can set the anchor point manually, but in most cases the smart option will make a good choice. And we will work with the libray author to improve this in the future.
By default, Hugo will use the [Smartcrop](https://github.com/muesli/smartcrop), a library created by [muesli](https://github.com/muesli), when cropping images with `.Fill`. You can set the anchor point manually, but in most cases the smart option will make a good choice. And we will work with the library author to improve this in the future.
An example using the sunset image from above:

View file

@ -116,7 +116,7 @@ From the example above:
- `documents/photo_specs.pdf` will get the `photo` icon.
- `documents/checklist.pdf`, `documents/guide.pdf` and `documents/payment.docx` will get `Title` as set by `title`.
- Every `PDF` in the bundle except `documents/photo_specs.pdf` will get the `pdf` icon.
- All `PDF` files will get a new `Name`. The `name` parameter contains a special placeholder [`:counter`](#counter), so the `Name` will be `pdf-file-1`, `pdf-file-2`, `pdf-file-3`.
- All `PDF` files will get a new `Name`. The `name` parameter contains a special placeholder [`:counter`](#the-counter-placeholder-in-name-and-title), so the `Name` will be `pdf-file-1`, `pdf-file-2`, `pdf-file-3`.
- Every docx in the bundle will receive the `word` icon.
{{% warning %}}

View file

@ -36,7 +36,7 @@ To list up to 5 related pages is as simple as including something similar to thi
{{% note %}}
Read [this blog article](https://regisphilibert.com/blog/2018/04/hugo-optmized-relashionships-with-related-content/) for a great explanation more advanced usage of this feature.
Read [this blog article](https://regisphilibert.com/blog/2018/04/hugo-optmized-relashionships-with-related-content/) for a great explanation of more advanced usage of this feature.
{{% /note %}}
The full set of methods available on the page lists can bee seen in this Go interface:

View file

@ -18,7 +18,7 @@ toc: true
From Hugo 0.28, the default syntax hightlighter in Hugo is [Chroma](https://github.com/alecthomas/chroma); it is built in Go and is really, really fast -- and for the most important parts compatible with Pygments.
If you want to continue to use Pygments (see below), set `pygmentsUseClasses=true` in your site config.
If you want to continue to use Pygments (see below), set `pygmentsUseClassic=true` in your site config.
The example below shows a simple code snippet from the Hugo source highlighted with the `highlight` shortcode. Note that the gohugo.io site is generated with `pygmentsUseClasses=true` (see [Generate Syntax Highlighter CSS](#generate-syntax-highlighter-css)).
@ -94,7 +94,7 @@ linenos
: For Chroma, any value in this setting will print line numbers. Pygments has some more fine grained control.
linenostart
: Start the line numbers from this value (default is 1).
: Start the line numbers from this value (default is 1).
hl_lines
@ -143,7 +143,7 @@ Highlighting is carried out via the [built-in shortcode](/content-management/sho
See [Highlight](/functions/highlight/).
## Highlight in Code Fences
It is also possible to add syntax highlighting with GitHub flavored code fences. To enable this, set the `pygmentsCodeFences` to `true` in Hugo's [configuration file](/getting-started/configuration/);
````

View file

@ -82,15 +82,23 @@ Moonrise Kingdom <- Value
...
```
## Hugo Taxonomy Defaults
## Hugo Taxonomy Defaults {#default-taxonomies}
Hugo natively supports taxonomies.
Without adding a single line to your site's configuration file, Hugo will automatically create taxonomies for `tags` and `categories`. If you do not want Hugo to create any taxonomies, set `disableKinds` in your site's configuration to the following:
Without adding a single line to your [site config][config] file, Hugo will automatically create taxonomies for `tags` and `categories`. That would be same as manually [configuring your taxonomies](#configuring-taxonomies) as below:
```
{{< code-toggle copy="false" >}}
[taxonomies]
tag = "tags"
category = "categories"
{{</ code-toggle >}}
If you do not want Hugo to create any taxonomies, set `disableKinds` in your [site config][config] to the following:
{{< code-toggle copy="false" >}}
disableKinds = ["taxonomy","taxonomyTerm"]
```
{{</ code-toggle >}}
### Default Destinations
@ -99,11 +107,15 @@ When taxonomies are used---and [taxonomy templates][] are provided---Hugo will a
* A single page at `example.com/categories/` that lists all the [terms within the taxonomy][]
* [Individual taxonomy list pages][taxonomy templates] (e.g., `/categories/development/`) for each of the terms that shows a listing of all pages marked as part of that taxonomy within any content file's [front matter][]
## Configure Taxonomies
## Configure Taxonomies {#configuring-taxonomies}
Taxonomies must be defined in your [website configuration][config] before they can be used throughout the site. You need to provide both the plural and singular labels for each taxonomy. For example, `singular key = "plural value"` for TOML and `singular key: "plural value"` for YAML.
Custom taxonomies other than the [defaults](#default-taxonomies) must be defined in your [site config][config] before they can be used throughout the site. You need to provide both the plural and singular labels for each taxonomy. For example, `singular key = "plural value"` for TOML and `singular key: "plural value"` for YAML.
### Example: Taxonomy Configuration
### Example: Adding a custom taxonomy named "series"
{{% note %}}
While adding custom taxonomies, you need to put in the default taxonomies too, _if you want to keep them_.
{{% /note %}}
{{< code-toggle copy="false" >}}
[taxonomies]
@ -112,11 +124,22 @@ Taxonomies must be defined in your [website configuration][config] before they c
series = "series"
{{</ code-toggle >}}
### Example: Removing default taxonomies
If you want to have just the default `tags` taxonomy, and remove the `categories` taxonomy for your site, you can do so by modifying the `taxonomies` value in your [site config][config].
{{< code-toggle copy="false" >}}
[taxonomies]
tag = "tags"
{{</ code-toggle >}}
If you want to disable all taxonomies altogether, see the use of `disableKinds` in [Hugo Taxonomy Defaults](#default-taxonomies).
### Preserve Taxonomy Values
By default, taxonomy names are normalized.
Therefore, if you want to have a taxonomy term with special characters such as `Gérard Depardieu` instead of `Gerard Depardieu`, set the value for `preserveTaxonomyNames` to `true` in your [site configuration][config]. Hugo will then preserve special characters in taxonomy values but will still title-ize the values for titles and normalize them in URLs.
Therefore, if you want to have a taxonomy term with special characters such as `Gérard Depardieu` instead of `Gerard Depardieu`, set the value for `preserveTaxonomyNames` to `true` in your [site config][config]. Hugo will then preserve special characters in taxonomy values but will still title-ize the values for titles and normalize them in URLs.
Note that if you use `preserveTaxonomyNames` and intend to manually construct URLs to the archive pages, you will need to pass the taxonomy values through the [`urlize` template function][].

View file

@ -38,7 +38,7 @@ If you're struggling at any point in this contribution guide, reach out to the H
The installation of Go should take only a few minutes. You have more than one option to get Go up and running on your machine.
If you are having trouble following the installation guides for go, check out [Go Bootcamp, which contains setups for every platform][gobootcamp] or reach out to the Hugo community in the [Hugo Discussion Forums][forums].
If you are having trouble following the installation guides for Go, check out [Go Bootcamp, which contains setups for every platform][gobootcamp] or reach out to the Hugo community in the [Hugo Discussion Forums][forums].
### Install Go From Source
@ -58,7 +58,7 @@ go version go1.8 darwin/amd64
Next, make sure that you set up your `GOPATH` [as described in the installation guide][setupgopath].
You can print the `GOPATH` with `echo $GOPATH`. You should see a non-empty string containing a valid path to your Go workspace; .e.g.:
You can print the `GOPATH` with `echo $GOPATH`. You should see a non-empty string containing a valid path to your Go workspace; for example:
```
/Users/<yourusername>/Code/go
@ -66,7 +66,7 @@ You can print the `GOPATH` with `echo $GOPATH`. You should see a non-empty strin
### Install Go with Homebrew
If you are a macOS user and have [Homebrew](https://brew.sh/) installed on your machine, installing Go is as simple as the following command:
If you are a MacOS user and have [Homebrew](https://brew.sh/) installed on your machine, installing Go is as simple as the following command:
{{< code file="install-go.sh" >}}
brew install go
@ -84,7 +84,7 @@ If you're going to contribute code, you'll need to have an account on GitHub. Go
## Install Git on Your System
You will need to have Git installed on your computer to contribute to Hugo development. Teaching git is outside the scope of the Hugo docs, but if you're looking for an excellent reference to learn the basics of Git, we recommend the [Git book][gitbook] if you are not sure where to begin. The used terminology will be explained with annotations.
You will need to have Git installed on your computer to contribute to Hugo development. Teaching Git is outside the scope of the Hugo docs, but if you're looking for an excellent reference to learn the basics of Git, we recommend the [Git book][gitbook] if you are not sure where to begin. We will include short explainations of the Git commands in this document.
Git is a [version control system](https://en.wikipedia.org/wiki/Version_control) to track the changes of source code. Hugo depends on smaller third-party packages that are used to extend the functionality. We use them because we don't want to reinvent the wheel.
@ -96,7 +96,7 @@ Finally, check again with `git version` if Git was installed successfully.
### Git Graphical Front Ends
There are several [GUI clients](https://git-scm.com/downloads/guis) that help you to operate Git. Not all are available for all operating systems and maybe differ in their usage. Thus, so we will use the command line since the commands are everywhere the same.
There are several [GUI clients](https://git-scm.com/downloads/guis) that help you to operate Git. Not all are available for all operating systems and maybe differ in their usage. Because of this we will document how to use the command line, since the commands are the same everywhere.
### Install Hub on Your System (Optional)
@ -123,7 +123,7 @@ hub version 2.2.2
## Set up your working copy
The working copy is set up locally on your computer. It's what you'll edit, compile, and end up pushing back to GitHub. The main steps are cloning the repository and creating your fork as a remote.
You set up the working copy of the repository locally on your computer. Your local copy of the files is what you'll edit, compile, and end up pushing back to GitHub. The main steps are cloning the repository and creating your fork as a remote.
### Clone the repository

View file

@ -24,3 +24,9 @@ Example:
```
Would emit "goose" if the `$geese` array has exactly 1 item, or "geese" otherwise.
{{% warning %}}
Whenever you use a `cond` function, *both* variable expressions are *always* evaluated. This means that a usage like `cond false (div 1 0) 27` will throw an error because `div 1 0` will be evaluated *even though the condition is false*.
In other words, the `cond` function does *not* provide [short-circuit evaluation](https://en.wikipedia.org/wiki/Short-circuit_evaluation) and does *not* work like a normal [ternary operator](https://en.wikipedia.org/wiki/%3F:) that will pass over the first expression if the condition returns `false`.
{{% /warning %}}

View file

@ -443,7 +443,7 @@ sudo apt-get install hugo
* Might not be the latest version, especially if you are using an older, stable version (e.g., Ubuntu 16.04 LTS). Until backports and PPA are available, you may consider installing the Hugo snap package to get the latest version of Hugo.
{{% note %}}
Hugo-as-a-snap can write only inside the users `$HOME` directory---and gvfs-mounted directories owned by the user---because of Snaps confinement and security model. More information is also available [in this related GitHub issue](https://github.com/gohugoio/hugo/issues/3143). Use ```sudo apt-get install hugo --classic``` to disable the default security model if you want hugo to be able to have write access in other paths besides the users `$HOME` directory.
Hugo-as-a-snap can write only inside the users `$HOME` directory---and gvfs-mounted directories owned by the user---because of Snaps confinement and security model. More information is also available [in this related GitHub issue](https://github.com/gohugoio/hugo/issues/3143). Use ```sudo snap install hugo --classic``` to disable the default security model if you want hugo to be able to have write access in other paths besides the users `$HOME` directory.
{{% /note %}}
### Arch Linux

View file

@ -0,0 +1,21 @@
---
date: 2014-03-01T17:21:33Z
description: "Hugo 0.10 brings syntax highlighting (powered by Pygments), automatic table of contents generation, support for Unicode, and a lot more!"
title: "Hugo 0.10"
categories: ["Releases"]
---
- [Syntax highlighting](http://hugo.spf13.com/extras/highlighting) powered by pygments (**slow**)
- Ability to [sort content](http://hugo.spf13.com/content/ordering) many more ways
- Automatic [table of contents](http://hugo.spf13.com/extras/toc) generation
- Support for unicode URLs, aliases and indexes
- Configurable per-section [permalink](http://hugo.spf13.com/extras/permalinks) pattern support
- Support for [paired shortcodes](http://hugo.spf13.com/extras/shortcodes)
- Shipping with some [shortcodes](http://hugo.spf13.com/extras/shortcodes) (highlight & figure)
- Adding [canonify](http://hugo.spf13.com/extras/urls) option to keep URLs relative
- A bunch of [additional template functions](http://hugo.spf13.com/layouts/templatefunctions)
- Watching very large sites now works on mac
- RSS generation improved. Limited to 50 items by default, can limit further in [template](http://hugo.spf13.com/layout/rss)
- Boolean params now supported in [frontmatter](http://hugo.spf13.com/content/front-matter)
- Launched website [showcase](http://hugo.spf13.com/showcase). Show off your own hugo site!
- A bunch of [bug fixes](https://github.com/spf13/hugo/commits/master)

View file

@ -0,0 +1,23 @@
---
date: 2014-05-29T22:53:22Z
description: "Now 34 times faster, Hugo 0.11 brings live reload, theme engine, menu system, XML sitemap, and more!"
title: "Hugo 0.11"
categories: ["Releases"]
---
- Considerably faster... about 3 - 4x faster on average
- [Live Reload](/getting-started/usage/#livereload). Hugo will automatically reload the browser when the build is complete
- Theme engine w/[Theme Repository](http://github.com/spf13/hugoThemes)
- [Menu system](/content-management/menus/) with support for active page
- [Builders](/extras/builders) to quickly create a new site, content or theme
- [XML sitemap](/templates/sitemap) generation
- [Integrated Disqus](/extras/comments) support
- Streamlined [template organization](/templates/overview)
- Brand new docs site
- Support for publishDate which allows for posts to be dated in the future
- More [sort](/functions/sort/#readout) options
- Logging support
- Much better error handling
- More informative verbose output
- Renamed Indexes > [Taxonomies](/taxonomies/overview)
- Renamed Chrome > [Partials](/templates/partials)

View file

@ -0,0 +1,29 @@
---
date: 2015-01-21T20:35:00Z
description: "Hugo 0.12 focused on polishing the theme engine and adding critical functionality to the templates."
title: "Hugo 0.12"
categories: ["Releases"]
---
A lot has happened since Hugo v0.11.0 was released. Most of the work has been
focused on polishing the theme engine and adding critical functionality to the
templates.
This release represents over 90 code commits from 28 different contributors.
- 10 [new themes](https://github.com/spf13/hugoThemes) created by the community
- fully themable [partials](/templates/partials/)
- [404 template](/templates/404/) support in themes
- [shortcode](/extras/shortcodes/) support in themes
- [views](/templates/views/) support in themes
- inner [shortcode](/extras/shortcodes/) content now treated as markdown
- support for header ids in markdown (# header {#myid})
- [where](/templates/lists/#where) template function to filter lists of content, taxonomies, etc
- [groupby](/templates/list) & [groupbydate](/templates/list) methods to group pages
- taxonomy [pages list](/taxonomies/methods/) now sortable, filterable, limitable & groupable
- general cleanup to taxonomies & documentation to make it more clear and consistent
- [showcase](/showcase/) returned and has been expanded
- pretty links now always have trailing slashes
- [baseurl](/overview/configuration/) can now include a subdirectory
- better feedback about draft & future post rendering
- a variety of improvements to [the website](/)

View file

@ -0,0 +1,95 @@
---
date: 2015-02-22T04:10:06Z
description: "Hugo 0.13 is the largest Hugo release to date. The release introduced some long sought after features (pagination, sequencing, data loading, tons of template improvements) as well as major internal improvements. In addition to the code changes, the Hugo community has grown significantly and now has over 3000 stars on GitHub, 134 contributors, 24 themes and 1000s of happy users."
title: "Hugo 0.13"
categories: ["Releases"]
---
The v0.13.0 release is the largest Hugo release to date. The release introduced
some long sought after features (pagination, sequencing, data loading, tons of
template improvements) as well as major internal improvements. In addition to
the code changes, the Hugo community has grown significantly and now has over
3000 stars on GitHub, 134 contributors, 24 themes and 1000s of happy users.
This release represents **448 contributions by 65 contributors**
A special shout out to [@bep](https://github.com/bep) and
[@anthonyfok](https://github.com/anthonyfok) for their new role as Hugo
maintainers and their tremendous contributions this release.
### New major features
- Support for [data files](http://gohugo.io/extras/datafiles/) in [YAML](http://yaml.org/),
[JSON](http://www.json.org/), or [TOML](https://github.com/toml-lang/toml)
located in the `data` directory ([#885](https://github.com/spf13/hugo/issues/885))
- Support for [dynamic content](http://gohugo.io/extras/dynamiccontent/) by loading JSON & CSV
from remote sources via GetJson and GetCsv in short codes or other layout
files ([#748](https://github.com/spf13/hugo/issues/748))
- [Pagination support](http://gohugo.io/extras/pagination/) for home page, sections and
taxonomies ([#750](https://github.com/spf13/hugo/issues/750))
- Universal sequencing support
- A new, generic Next/Prev functionality is added to all lists of pages
(sections, taxonomies, etc.)
- Add in-section [Next/Prev](http://gohugo.io/templates/variables/) content pointers
- `Scratch` -- [a "scratchpad"](http://gohugo.io/extras/scratch) for your node- and page-scoped
variables
- [Cross Reference](http://gohugo.io/extras/crossreferences/) support to easily link documents
together with the ref and relref shortcodes.
- [Ace](http://ace.yoss.si/) template engine support ([#541](https://github.com/spf13/hugo/pull/541))
- A new [shortcode](http://gohugo.io/extras/shortcodes/) token of `{{</* */>}}` (raw HTML)
alongside the existing `{{%/* */%}}` (Markdown)
- A top level `Hugo` variable (on Page & Node) is added with various build
information
- Several new ways to order and group content:
- `ByPublishDate`
- `GroupByPublishDate(format, order)`
- `GroupByParam(key, order)`
- `GroupByParamDate(key, format, order)`
- Hugo has undergone a major refactoring, with a new handler system and a
generic file system. This sounds and is technical, but will pave the way for
new features and make Hugo even speedier
### Notable enhancements to existing features
- The [shortcode](http://gohugo.io/extras/shortcodes/) handling is rewritten for speed and
better error messages.
- Several improvements to the [template functions](http://gohugo.io/templates/functions/):
- `where` is now even more powerful and accepts SQL-like syntax with the
operators `==`, `eq`; `!=`, `<>`, `ne`; `>=`, `ge`; `>`, `gt`; `<=`,
`le`; `<`, `lt`; `in`, `not in`
- `where` template function now also accepts dot chaining key argument
(e.g. `"Params.foo.bar"`)
- New template functions:
- `apply`
- `chomp`
- `delimit`
- `sort`
- `markdownify`
- `in` and `intersect`
- `trim`
- `replace`
- `dateFormat`
- Several [configurable improvements related to Markdown
rendering](http://gohugo.io/overview/configuration/#configure-blackfriday-rendering:a66b35d20295cb764719ac8bd35837ec):
- Configuration of footnote rendering
- Optional support for smart angled quotes, e.g. `"Hugo"` → «Hugo»
- Enable descriptive header IDs
- URLs in XML output is now correctly canonified ([#725](https://github.com/spf13/hugo/issues/725), [#728](https://github.com/spf13/hugo/issues/728), and part
of [#789](https://github.com/spf13/hugo/issues/789))
### Other improvements
- Internal change to use byte buffer pool significantly lowering memory usage
and providing measurable performance improvements overall
- Changes to docs:
- A new [Troubleshooting](http://gohugo.io/troubleshooting/overview/) section is added
- It's now searchable through Google Custom Search ([#753](https://github.com/spf13/hugo/issues/753))
- Some new great tutorials:
- [Automated deployments with
Wercker](http://gohugo.io/tutorials/automated-deployments/)
- [Creating a new theme](http://gohugo.io/tutorials/creating-a-new-theme/)
- [`hugo new`](http://gohugo.io/content/archetypes/) now copies the content in addition to the front matter
- Improved unit test coverage
- Fixed a lot of Windows-related path issues
- Improved error messages for template and rendering errors
- Enabled soft LiveReload of CSS and images ([#490](https://github.com/spf13/hugo/pull/490))
- Various fixes in RSS feed generation ([#789](https://github.com/spf13/hugo/issues/789))
- `HasMenuCurrent` and `IsMenuCurrent` is now supported on Nodes
- A bunch of [bug fixes](https://github.com/spf13/hugo/commits/master)

View file

@ -0,0 +1,54 @@
---
date: 2015-05-26T01:32:45Z
description: "The v0.14.0 Hugo release brings of the most demanded features to Hugo. The foundation of Hugo is stabilizing nicely and a lot of polish has been added. Weve expanded support for additional content types with support for AsciiDoc, Restructured Text, HTML and Markdown."
title: "Hugo 0.14"
categories: ["Releases"]
---
The v0.14.0 Hugo release brings of the most demanded features to Hugo. The foundation of Hugo is stabilizing nicely and a lot of polish has been added. Weve expanded support for additional content types with support for AsciiDoc, Restructured Text, HTML and Markdown. Some of these types depend on external libraries as there does not currently exist native support in Go. Weve tried to make the experience as seamless as possible. Look for more improvements here in upcoming releases.
A lot of work has been done to improve the user experience, with extra polish to the Windows experience. Hugo errors are more helpful overall and Hugo now can detect if its being run in Windows Explorer and provide additional instructions to run it via the command prompt.
The Hugo community continues to grow. Hugo has over 4000 stars on github, 165 contributors, 35 themes and 1000s of happy users. It is now the 5th most popular static site generator (by Stars) and has the 3rd largest contributor community.
This release represents over **240 contributions by 36 contributors** to the main Hugo codebase.
Big shout out to [@bep](https://github.com/bep) who led the development of Hugo this release, [@anthonyfok](https://github.com/anthonyfok), [@eparis](https://github.com/eparis), [@SchumacherFM](https://github.com/SchumacherFM), [@RickCogley](https://github.com/RickCogley) & [@mdhender](https://github.com/mdhender) for their significant contributions and [@tatsushid](https://github.com/tatsushid) for his continuous improvements to the templates. Also a big thanks to all the theme creators. 11 new themes have been added since last release and the [hugoThemes repo now has previews of all of them](https://github.com/spf13/hugoThemes/blob/master/README.md#theme-list).
Hugo also depends on a lot of other great projects. A big thanks to all of our dependencies inclding:
[cobra](https://github.com/spf13/cobra), [viper](https://github.com/spf13/viper), [blackfriday](https://github.com/russross/blackfriday), [pflag](https://github.com/spf13/pflag), [HugoThemes](https://github.com/spf13/hugothemes), [BurntSushi/Toml](github.com/BurntSushi/toml), [goYaml](https://github.com/go-yaml/yaml/tree/v2), and the Go standard library.
## New features
- Support for all file types in content directory.
- If dedicated file type handler isnt found it will be copied to the destination.
- Add `AsciiDoc` support using external helpers.
- Add experimental support for [`Mmark`](https://github.com/miekg/mmark) markdown processor
- Bash autocomplete support via `genautocomplete` command
- Add section menu support for a [Section Menu for "the Lazy Blogger"](http://gohugo.io/extras/menus.md#section-menu-for-the-lazy-blogger")
- Add support for `Ace` base templates
- Adding `RelativeURLs = true` to site config will now make all the relative URLs relative to the content root.
- New template functions:
- `getenv`
- The string functions `substr` and `slicestr`
*`seq`, a sequence generator very similar to its Gnu countepart
- `absURL` and `relURL`, both of which takes the `BaseURL` setting into account
## Improvements
- Highlighting with `Pygments` is now cached to disk -- expect a major speed boost if you use it!
- More Pygments highlighting options, including `line numbers`
- Show help information to Windows users who try to double click on `hugo.exe`.
- Add `bind` flag to `hugo server` to set the interface to which the server will bind
- Add support for `canonifyurls` in `srcset`
- Add shortcode support for HTML (content) files
- Allow the same `shortcode` to be used with or without inline content
- Configurable RSS output filename
## Bugfixes
- Fix panic with paginator and zero pages in result set.
- Fix crossrefs on Windows.
- Fix `eq` and `ne` template functions when used with a raw number combined with the result of `add`, `sub` etc.
- Fix paginator with uglyurls
- Fix [#998](https://github.com/spf13/hugo/issues/988), supporting UTF8 characters in Permalinks.
## Notices
- To get variable and function names in line with the rest of the Go community, a set of variable and function names has been deprecated: These will still work in 0.14, but will be removed in 0.15. What to do should be obvious by the build log; `getJson` to `getJSON`, `getCsv` to `getCSV`, `safeHtml` to `safeHTML`, `safeCss` to `safeCSS`, `safeUrl` to `safeURL`, `Url` to `URL`, `UrlPath` to `URLPath`, `BaseUrl` to `BaseURL`, `Recent` to `Pages`, `Indexes` to `Taxonomies`.

View file

@ -0,0 +1,97 @@
---
date: 2015-12-19T09:45:24Z
description: "The v0.15.0 Hugo release brings a lot of polish to Hugo. Exactly 6 months after the 0.14 release, Hugo has seen massive growth and changes. Most notably, this is Hugo's first release under the Apache 2.0 license."
title: "Hugo 0.15"
categories: ["Releases"]
---
The v0.15.0 Hugo release brings a lot of polish to Hugo. Exactly 6 months after the 0.14 release, Hugo has seen massive growth and changes. Most notably, this is Hugo's first release under the Apache 2.0 license. With this license change we hope to expand the great community around Hugo and make it easier for our many users to contribute. This release represents over **377 contributions by 87 contributors** to the main Hugo repo and hundreds of improvements to the libraries Hugo uses. Hugo also launched a [new theme showcase](http://themes.gohugo.io) and participated in [Hacktoberfest](https://hacktoberfest.digitalocean.com).
Hugo now has:
- 6700 (+2700) stars on GitHub
- 235 (+75) contributors
- 65 (+30) themes
**Template Improvements:** This release takes Hugo to a new level of speed and usability. Considerable work has been done adding features and performance to the template system which now has full support of Ace, Amber and Go Templates.
**Hugo Import:** Have a Jekyll site, but dreaming of porting it to Hugo? This release introduces a new `hugo import jekyll`command that makes this easier than ever.
**Performance Improvements:** Just when you thought Hugo couldn't get any faster, Hugo continues to improve in speed while adding features. Notably Hugo 0.15 introduces the ability to render and serve directly from memory resulting in 30%+ lower render times.
Huge thanks to all who participated in this release. A special thanks to [@bep](https://github.com/bep) who led the development of Hugo this release again, [@anthonyfok](https://github.com/anthonyfok), [@eparis](https://github.com/eparis), [@tatsushid](https://github.com/tatsushid) and [@DigitalCraftsman](https://github.com/digitalcraftsman/).
## New features
- new `hugo import jekyll` command. [#1469](https://github.com/spf13/hugo/pull/1469)
- The new `Param` convenience method on `Page` and `Node` can be used to get the most specific parameter value for a given key. [#1462](https://github.com/spf13/hugo/issues/1462)
- Several new information elements have been added to `Page` and `Node`:
- `RuneCount`: The number of [runes](http://blog.golang.org/strings) in the content, excluding any whitespace. This may be a good alternative to `.WordCount` for Japanese and other CJK languages where a word-split by spaces makes no sense. [#1266](https://github.com/spf13/hugo/issues/1266)
- `RawContent`: Raw Markdown as a string. One use case may be of embedding remarkjs.com slides.
- `IsHome`: tells the truth about whether you're on the home page or not.
## Improvements
- `hugo server` now builds ~30%+ faster by rendering to memory instead of disk. To get the old behavior, start the server with `--renderToDisk=true`.
- Hugo now supports dynamic reloading of the config file when watching.
- We now use a custom-built `LazyFileReader` for reading file contents, which means we don't read media files in `/content` into memory anymore -- and file reading is now performed in parallel on multicore PCs. [#1181](https://github.com/spf13/hugo/issues/1181)
- Hugo is now built with `Go 1.5` which, among many other improvements, have fixed the last known data race in Hugo. [#917](https://github.com/spf13/hugo/issues/917)
- Paginator now also supports page groups. [#1274](https://github.com/spf13/hugo/issues/1274)
- Markdown improvements:
- Hugo now supports GitHub-flavoured markdown code fences for highlighting for `md`-files (Blackfriday rendered markdown) and `mmark` files (MMark rendered markdown). [#362](https://github.com/spf13/hugo/issues/362) [#1258](https://github.com/spf13/hugo/issues/1258)
- Several new Blackfriday options are added:
- Option to disable Blackfriday's `Smartypants`.
- Option for Blackfriday to open links in a new window/tab. [#1220](https://github.com/spf13/hugo/issues/1220)
- Option to disable Blackfriday's LaTeX style dashes [#1231](https://github.com/spf13/hugo/issues/1231)
- Definition lists extension support.
- `Scratch` now has built-in `map` support.
- We now fall back to `link title` for the default page sort. [#1299](https://github.com/spf13/hugo/issues/1299)
- Some notable new configuration options:
- `IgnoreFiles` can be set with a list of Regular Expressions that matches files to be ignored during build. [#1189](https://github.com/spf13/hugo/issues/1189)
- `PreserveTaxonomyNames`, when set to `true`, will preserve what you type as the taxonomy name both in the folders created and the taxonomy `key`, but it will be normalized for the URL. [#1180](https://github.com/spf13/hugo/issues/1180)
- `hugo gen` can now generate man files, bash auto complete and markdown documentation
- Hugo will now make suggestions when a command is mistyped
- Shortcodes now have a boolean `.IsNamedParams` property. [#1597](https://github.com/spf13/hugo/pull/1597)
## New Template Features
- All template engines:
- The new `dict` function that could be used to pass maps into a template. [#1463](https://github.com/spf13/hugo/pull/1463)
- The new `pluralize` and `singularize` template funcs.
- The new `base64Decode` and `base64Encode` template funcs.
- The `sort` template func now accepts field/key chaining arguments and pointer values. [#1330](https://github.com/spf13/hugo/issues/1330)
- Several fixes for `slicestr` and `substr`, most importantly, they now have full `utf-8`-support. [#1190](https://github.com/spf13/hugo/issues/1190) [#1333](https://github.com/spf13/hugo/issues/1333) [#1347](https://github.com/spf13/hugo/issues/1347)
- The new `last` template function allows the user to select the last `N` items of a slice. [#1148](https://github.com/spf13/hugo/issues/1148)
- The new `after` func allows the user to select the items after the `Nth` item. [#1200](https://github.com/spf13/hugo/pull/1200)
- Add `time.Time` type support to the `where`, `ge`, `gt`, `le`, and `lt` template functions.
- It is now possible to use constructs like `where Values ".Param.key" nil` to filter pages that doesn't have a particular parameter. [#1232](https://github.com/spf13/hugo/issues/1232)
- `getJSON`/`getCSV`: Add retry on invalid content. [#1166](https://github.com/spf13/hugo/issues/1166)
- The new `readDir` func lists local files. [#1204](https://github.com/spf13/hugo/pull/1204)
- The new `safeJS` function allows the embedding of content into JavaScript contexts in Go templates.
- Get the main site RSS link from any page by accessing the `.Site.RSSLink` property. [#1566](https://github.com/spf13/hugo/pull/1566)
- Ace templates:
- Base templates now also works in themes. [#1215](https://github.com/spf13/hugo/issues/1215).
- And now also on Windows. [#1178](https://github.com/spf13/hugo/issues/1178)
- Full support for Amber templates including all template functions.
- A built-in template for Google Analytics. [#1505](https://github.com/spf13/hugo/pull/1505)
- Hugo is now shipped with new built-in shortcodes: [#1576](https://github.com/spf13/hugo/issues/1576)
- `youtube` for YouTube videos
- `vimeo` for Vimeo videos
- `gist` for GitHub gists
- `tweet` for Twitter Tweets
- `speakerdeck` for Speakerdeck slides
## Bugfixes
- Fix data races in page sorting and page reversal. These operations are now also cached. [#1293](https://github.com/spf13/hugo/issues/1293)
- `page.HasMenuCurrent()` and `node.HasMenuCurrent()` now work correctly in multi-level nested menus.
- Support `Fish and Chips` style section titles. Previously, this would end up as `Fish And Chips`. Now, the first character is made toupper, but the rest are preserved as-is. [#1176](https://github.com/spf13/hugo/issues/1176)
- Hugo now removes superfluous p-tags around shortcodes. [#1148](https://github.com/spf13/hugo/issues/1148)
## Notices
- `hugo server` will watch by default now.
- Some fields and methods were deprecated in `0.14`. These are now removed, so the error message isn't as friendly if you still use the old values. So please change:
- `getJson` to `getJSON`, `getCsv` to `getCSV`, `safeHtml` to
`safeHTML`, `safeCss` to `safeCSS`, `safeUrl` to `safeURL`, `Url` to `URL`,
`UrlPath` to `URLPath`, `BaseUrl` to `BaseURL`, `Recent` to `Pages`.
## Known Issues
Using the Hugo v0.15 32-bit Windows or ARM binary, running `hugo server` would crash or hang due to a [memory alignment issue](https://golang.org/pkg/sync/atomic/#pkg-note-BUG) in [Afero](https://github.com/spf13/afero). The bug was discovered shortly after the v0.15.0 release and has since been [fixed](https://github.com/spf13/afero/pull/23) by @tpng. If you encounter this bug, you may either compile Hugo v0.16-DEV from source, or use the following solution/workaround:
- **64-bit Windows users: Please use [hugo_0.15_windows_amd64.zip](https://github.com/spf13/hugo/releases/download/v0.15/hugo_0.15_windows_amd64.zip)** (amd64 == x86-64). It is only the 32-bit hugo_0.15_windows_386.zip that crashes/hangs (see #1621 and #1628).
- **32-bit Windows and ARM users: Please run `hugo server --renderToDisk` as a workaround** until Hugo v0.16 is released (see [“hugo server” returns runtime error on armhf](https://discuss.gohugo.io/t/hugo-server-returns-runtime-error-on-armhf/2293) and #1716).

View file

@ -0,0 +1,12 @@
---
date: 2018-05-09
title: "Hugo 0.40.3: One Bug Fix"
description: "Fixes a rare, but possible Content truncation issue."
categories: ["Releases"]
images:
- images/blog/hugo-bug-poster.png
---
Hugo `0.40.3` fixes a possible `.Content` truncation issue introduced in `0.40.1` [90d0d830](https://github.com/gohugoio/hugo/commit/90d0d83097a20a3f521ffc1f5a54a2fbfaf14ce2) [@bep](https://github.com/bep) [#4706](https://github.com/gohugoio/hugo/issues/4706). This should be very rare. It has been reported by only one user on a synthetic site. We have tested a number of big sites that does not show this problem with `0.40.2`, but this is serious enough to warrant a patch release.

View file

@ -0,0 +1,16 @@
---
date: 2013-07-05T04:22:00Z
description: "The first public release of Hugo."
title: "Hugo 0.7"
categories: ["Releases"]
---
As the first public release here's a bit about what Hugo can do so far:
- **0.7.0** July 4, 2013
- Hugo now includes a simple server
- First public release
- **0.6.0** July 2, 2013
- Hugo includes an [example documentation site](http://hugo.spf13.com) which it builds
- **0.5.0** June 25, 2013
- Hugo is quite usable and able to build [spf13.com](http://spf13.com)

View file

@ -0,0 +1,21 @@
---
date: 2013-08-03T15:26:04Z
description: "Hugo 0.8 added support for pretty URLs, support for TOML and YAML, better Windows compatibility, and more!"
title: "Hugo 0.8"
categories: ["Releases"]
---
**Please read the docs as a few options have changed in this release:**
- Added support for pretty URLs (filename/index.html vs filename.html)
- Hugo supports a destination directory
- Will efficiently sync content in static to destination directory
- Cleaned up options.. now with support for short and long options
- Added support for TOML
- Added support for YAML
- Added support for Previous & Next
- Added support for indexes for the indexes
- Better Windows compatibility
- Support for series
- Adding verbose output
- Loads of bugfixes

View file

@ -0,0 +1,43 @@
---
date: 2013-11-16T04:52:32Z
description: "Hugo 0.9 is the most significant update to Hugo ever! It contains contributions from dozens of contributors and represents hundreds of features, fixes and improvements."
title: "Hugo 0.9"
categories: ["Releases"]
---
This is the most significant update to Hugo ever!
It contains contributions from dozens of contributors and represents hundreds of features, fixes and improvements.
# Major New Features
- New command based interface similar to git (`hugo server -s ./`)
- Amber template support
- Full Windows support
- Better index support including ordering by content weight
- Add params to site config, available in `.Site.Params` from templates
- Support for html & xml content (with front matter support)
- Support for top level pages (in addition to homepage)
# Notable Fixes and Additions
- Friendlier json support
- Aliases (redirects)
- Support for summary content divider (`<!--more-->`)
- HTML & shortcodes supported in summary (when using divider)
- Complete overhaul of the documentation site
- Added "Minutes to Read" functionality
- Support for a custom 404 page
- Cleanup of how content organization is handled
- Loads of unit and performance tests
- Integration with Travis CI
- Static directory now watched and copied on any addition or modification
- Support for relative permalinks
- Fixed watching being triggered multiple times for the same event
- Watch now ignores temp files (as created by Vim)
- Configurable number of posts on homepage
- Front matter supports multiple types (int, string, date, float)
- Indexes can now use a default template
- Addition of truncated bool to content to determine if should show 'more' link
- Support for `linkTitles`
- Better handling of most errors with directions on how to resolve
- Support for more date / time formats
- Support for Go 1.2
- Loads more... see commit log for full list.

View file

@ -41,7 +41,7 @@
`hrefTargetBlank`
: default: **`false`** <br>
Blackfriday flag: **`HTML_HREF_TARGET_BLANK`** <br>
Purpose: `true` opens external links in a new window or tab.
Purpose: `true` opens <s>external links</s> **absolute** links in a new window or tab. While the `target="_blank"` attribute is typically used for external links, Blackfriday does that for _all_ absolute links ([ref](https://discourse.gohugo.io/t/internal-links-in-same-tab-external-links-in-new-tab/11048/8)). One needs to make note of this if they use absolute links throughout, for internal links too (for example, by setting `canonifyURLs` to `true` or via `absURL`).
`plainIDAnchors`
: default **`true`** <br>

View file

@ -0,0 +1,6 @@
We help ambitious businesses grow by getting more of the customers they want.
Our new site runs quickly, anywhere in the world, regardless of internet connectivity.
The site was built by [Tomango](https://www.tomango.co.uk)

Binary file not shown.

After

Width:  |  Height:  |  Size: 227 KiB

View file

@ -0,0 +1,29 @@
---
title: Tomango
date: 2018-05-04
description: "Showcase: \"Tomango site relaunch: Building our JAMstack site\""
siteURL: https://www.tomango.co.uk
siteSource: https://github.com/trys/tomango-2018
byline: "[Trys Mudford](http://www.trysmudford.com), Lead Developer, Tomango"
---
Hugo is our static site generator (SSG) of choice. It's **really quick**. After using it on a number of [client projects](/showcase/hartwell-insurance/), it became clear that our new site _had_ to be built with Hugo.
The big benefit of an SSG is how it moves all the heavy lifting to the build time.
For example in WordPress, all the category pages are created at runtime, generating a lot of database queries. In Hugo, the paginated category pages are created at build time - so all the computational complexity is done once, and doesn't impact the user at all.
Similarly, instead of running a live, or even a heavily cached Instagram feed that checked for new photos on page load, we used IFTTT to flip the feature to work performantly. I've [written about it](https://www.trysmudford.com/blog/making-the-static-dynamic-instagram-importer/) in detail on my blog but in essence: IFTTT sends a webhook to a Netlify Cloud Function every time a photo is uploaded. The function scrapes the photo and commits it to our GitHub repo which triggers a Hugo build on Netlify, deploying the site immediately!
Shortcodes allow copy editors to continue using WordPress-esque features, Markdown keeps our developers happy, and our users don't have any of the database overheads. It's win-win!
---
This is an extract from our [technical launch post](https://www.tomango.co.uk/thinks/tomango-progressive-web-app/).

View file

@ -183,7 +183,7 @@ This list template has been modified slightly from a template originally used in
### Taxonomy Template
{{< code file="layouts/_default/taxonomies.html" download="taxonomies.html" >}}
{{< code file="layouts/_default/taxonomy.html" download="taxonomy.html" >}}
{{ define "main" }}
<main>
<div>
@ -216,6 +216,8 @@ Hugo lists render the content based on metadata you provide in [front matter][].
### By Weight
Lower weight gets higher precedence. So content with lower weight will come first.
{{< code file="layouts/partials/by-weight.html" >}}
<ul>
{{ range .Data.Pages.ByWeight }}

View file

@ -70,3 +70,8 @@ Alternatively, you can use the new [Jekyll import command](/commands/hugo_import
## Contentful
- [contentful2hugo](https://github.com/ArnoNuyts/contentful2hugo) - A tool to create content-files for Hugo from content on [Contentful](https://www.contentful.com/).
## BlogML
- [BlogML2Hugo](https://github.com/jijiechen/BlogML2Hugo) - A tool that helps you convert BlogML xml file to Hugo markdown files. Users need to take care of links to attachments and images by themselves. This helps the blogs that export BlogML files (e.g. BlogEngine.NET) tramsform to hugo sites easily.

View file

@ -14,7 +14,7 @@
<a href="{{ .Permalink }}">{{ .Title }}</a>
</td>
<td class="pv2 ph3">
<a href="{{.Site.Params.ghrepo}}blob/master/content/{{.Path}}">
<a href="{{.Site.Params.ghrepo}}blob/master/content/{{.Lang }}/{{.Path}}">
{{ with .GitInfo }}{{ .Subject }}{{ else }}Source{{ end }}
</a>
</td>

View file

@ -3,7 +3,7 @@ publish = "public"
command = "hugo"
[context.production.environment]
HUGO_VERSION = "0.40.2"
HUGO_VERSION = "0.40.3"
HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true"
@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
command = "hugo --enableGitInfo"
[context.split1.environment]
HUGO_VERSION = "0.40.2"
HUGO_VERSION = "0.40.3"
HUGO_ENV = "production"
[context.deploy-preview]
command = "hugo -b $DEPLOY_PRIME_URL"
[context.deploy-preview.environment]
HUGO_VERSION = "0.40.2"
HUGO_VERSION = "0.40.3"
[context.branch-deploy]
command = "hugo -b $DEPLOY_PRIME_URL"
[context.branch-deploy.environment]
HUGO_VERSION = "0.40.2"
HUGO_VERSION = "0.40.3"
[context.next.environment]
HUGO_ENABLEGITINFO = "true"

View file

@ -12,6 +12,6 @@ copy = ""
[[banners]]
name = "eSolia"
link = "https://esolia.com/"
link = "https://esolia.com/post/why-did-esolia-choose-hugo/"
logo = "/images/sponsors/esolia-logo.svg"
copy = ""

View file

@ -1,3 +1,3 @@
<a href="{{.Site.Params.ghrepo}}edit/master/content/{{.File.Path}}" class="
<a href="{{.Site.Params.ghrepo}}edit/master/content/{{ .Lang }}/{{.File.Path}}" class="
f6 ph3 pv1 br2 dib tc ttu mv3 bg-primary-color white hover-bg-green link
">Improve this page</a>