shithub: hugo

--- a/config.toml

+++ b/config.toml

@@ -71,7 +71,7 @@

 [params]

   description = "The world’s fastest framework for building websites"

   ## Used for views in rendered HTML (i.e., rather than using the .Hugo variable)

-  release = "0.30.2"

+  release = "0.31.1"

   ## Setting this to true will add a "noindex" to *EVERY* page on the site

   removefromexternalsearch = false

   ## Gh repo for site footer (include trailing slash)

--- /dev/null

+++ b/content/about/new-in-032.md

@@ -1,0 +1,178 @@

+---

+title: Hugo 0.32 HOWTO

+description: About page bundles, image processing and more.

+date: 2017-12-28

+keywords: [ssg,static,performance,security]

+menu:

+  docs:

+    parent: "about"

+    weight: 10

+weight: 10

+sections_weight: 10

+draft: false

+aliases: []

+toc: true

+---

+{{% note %}}

+This documentation belongs in other places in this documentation site, but is put here first ... to get something up and running fast.

+{{% /note %}}

+Also see this demo project from [bep](https://github.com/bep/), the clever Norwegian behind these new features:

+* http://hugotest.bep.is/

+* https://github.com/bep/hugotest (source)

+## Page Resources

+### Organize Your Content

+{{< figure src="/images/hugo-content-bundles.png" title="Pages with image resources" >}}

+The content folder above shows a mix of content pages (`md` (i.e. markdown) files) and image resources.

+{{% note %}}

+You can use any file type as a content resource as long as it is a MIME type recognized by Hugo (`json` files will, as one example, work fine). If you want to get exotic, you can define your [own media type](/templates/output-formats/#media-types).

+{{% /note %}}

+The 3 page bundles marked in red explained from top to bottom:

+1. The home page with one image resource (`1-logo.png`)

+2. The blog section with two images resources and two pages resources (`content1.md`, `content2.md`). Note that the `_index.md` represents the URL for this section.

+3. An article (`hugo-is-cool`) with a folder with some images and one content resource (`cats-info.md`). Note that the `index.md` represents the URL for this article.

+The content files below `blog/posts` are just regular standalone pages.

+{{% note %}}

+Note that changes to any resource inside the `content` folder will trigger a reload when running in watch (aka server or live reload mode), it will even work with `--navigateToChanged`.

+{{% /note %}}

+#### Sort Order

+* Pages are sorted according to standard Hugo page sorting rules.

+* Images and other resources are sorted in lexicographical order.

+### Handle Page Resources in Templates

+#### List all Resources

+```html

+{{ range .Resources }}

+<li><a href="{{ .RelPermalink }}">{{ .ResourceType | title }}</a></li>

+{{ end }}

+```

+For an absolute URL, use `.Permalink`.

+**Note:** The permalink will be relative to the content page, respecting permalink settings. Also, included page resources will not have a value for `RelPermalink`.

+#### List All Resources by Type

+```html

+{{ with .Resources.ByType "image" }}

+{{ end }}

+```

+Type here is `page` for pages, else the main type in the MIME type, so `image`, `json` etc.

+#### Get a Specific Resource

+```html

+{{ $logo := .Resources.GetByPrefix "logo" }}

+{{ with $logo }}

+{{ end }}

+```

+#### Include Page Resource Content

+```html

+{{ with .Resources.ByType "page" }}

+{{ range . }}

+<h3>{{ .Title }}</h3>

+{{ .Content }}

+{{ end }}

+{{ end }}

+```

+## Image Processing

+The `image` resource implements the methods `Resize`, `Fit` and `Fill`:

+Resize

+: Resize to the given dimension, `{{ $logo.Resize "200x" }}` will resize to 200 pixels wide and preserve the aspect ratio. Use `{{ $logo.Resize "200x100" }}` to control both height and width.

+Fit

+: Scale down the image to fit the given dimensions, e.g. `{{ $logo.Fit "200x100" }}` will fit the image inside a box that is 200 pixels wide and 100 pixels high.

+Fill

+: Resize and crop the image given dimensions, e.g. `{{ $logo.Fill "200x100" }}` will resize and crop to width 200 and height 100

+{{% note %}}

+Image operations in Hugo currently **do not preserve EXIF data** as this is not supported by Go's [image package](https://github.com/golang/go/search?q=exif&type=Issues&utf8=%E2%9C%93). This will be improved on in the future.

+{{% /note %}}

+### Image Processing Options

+In addition to the dimensions (e.g. `200x100`) where either height or width can be omitted, Hugo supports a set of additional image options:

+Anchor

+: Only relevant for `Fill`. This is useful for thumbnail generation where the main motive is located in, say, the left corner. Valid are `Center`, `TopLeft`, `Top`, `TopRight`, `Left`, `Right`, `BottomLeft`, `Bottom`, `BottomRight`. Example: `{{ $logo.Fill "200x100 BottomLeft" }}`

+JPEG Quality

+: Only relevant for JPEG images, values 1 to 100 inclusive, higher is better. Default is 75. `{{ $logo.Resize "200x q50" }}`

+Rotate

+: Rotates an image by the given angle counter-clockwise. The rotation will be performed first to get the dimensions correct. `{{ $logo.Resize "200x r90" }}`. The main use of this is to be able to manually correct for [EXIF orientation](https://github.com/golang/go/issues/4341) of JPEG images.

+Resample Filter

+: Filter used in resizing. Default is `Box`, a simple and fast resampling filter appropriate for downscaling. See https://github.com/disintegration/imaging for more. If you want to trade quality for faster processing, this may be a option to test.

+### Performance

+Processed images are stored below `<project-dir>/resources` (can be set with `resourceDir` config setting). This folder is deliberately placed in the project, as it is recommended to check these into source control as part of the project. These images are not "Hugo fast" to generate, but once generated they can be reused.

+If you change your image settings (e.g. size), remove or rename images etc., you will end up with unused images taking up space and cluttering your project.

+To clean up, run:

+```bash

+hugo --gc

+```

+{{% note %}}

+**GC** is short for **Garbage Collection**.

+{{% /note %}}

+## Configuration

+### Default Image Processing Config

+You can configure an `imaging` section in `config.toml` with default image processing options:

+```toml

+[imaging]

+# Default resample filter used for resizing. Default is Box,

+# a simple and fast averaging filter appropriate for downscaling.

+# See https://github.com/disintegration/imaging

+resampleFilter = "box"

+# Defatult JPEG quality setting. Default is 75.

+quality = 68

+```

--- a/content/about/roadmap.md

+++ /dev/null

@@ -1,51 +1,0 @@

----

-title: Roadmap

-linktitle: Roadmap

-description: Take a look at what's in the pipeline for future versions of the Hugo project.

-date: 2017-02-01

-publishdate: 2017-02-01

-lastmod: 2017-02-01

-categories: [about hugo]

-keywords: [about,contribute,roadmap]

-menu:

-  docs:

-    parent: "about"

-    weight: 50

-weight: 50

-sections_weight: 50

-draft: false

-aliases: [/meta/roadmap]

-toc: false

----

-To track Hugo's progress, see our [GitHub Milestones][milestones].

-In no particular order, here are some other features currently being worked on:

-* Even easier deployment to S3, SSH, GitHub, rsync. Give the [hosting and deployment][] section a shot.

-* Import from other website systems. There are already [existing migration tools][migrate], but they don’t cover all major platforms.

-* An interactive web-based editor (See the [related forum thread][])

-* Additional [themes][], which are always ongoing and [contributions are welcome][themescontrib]!

-* Dynamic image resizing via shortcodes ({{< gh 1014 >}})

-* Native support for additional content formats (AsciiDoc {{< gh 1435>}}, reST {{< gh 1436 >}})

-* And, last but not least, [***your*** best ideas!][]

-## Contributions Welcome

-Feel free to [contribute to Hugo's development][devcontribute], [improve Hugo's documentation][doccontribute], or [open a new issue][newissue] if you have an idea for a new feature.

-[#98]: https://github.com/gohugoio/hugo/issues/98

-[#1014]: https://github.com/gohugoio/hugo/issues/1014

-[#1435]: https://github.com/gohugoio/hugo/issues/1435

-[#1436]: https://github.com/gohugoio/hugo/issues/1436

-[devcontribute]: /contribute/development/

-[doccontribute]: /contribute/documentation/

-[hosting and deployment]: /hosting-and-deployment/

-[migrate]: /tools/migrations/

-[milestones]: https://github.com/gohugoio/hugo/milestones/

-[newissue]: https://github.com/gohugoio/hugo/issues/

-[related forum thread]: https://discourse.gohugo.io/t/web-based-editor/155

-[themes]: /themes/

-[themescontrib]: /contribute/themes/

-[tutorials]: /tutorials

-[***your*** best ideas!]: /contribute/

--- a/content/commands/hugo.md

+++ b/content/commands/hugo.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo"

 slug: hugo

 url: /commands/hugo/

@@ -42,6 +42,7 @@

       --disableSitemap             do not build Sitemap file

       --enableGitInfo              add Git revision, date and author info to the pages

       --forceSyncStatic            copy all files when static is changed.

+      --gc                         enable to run some cleanup tasks (remove unused cache files) after the build

   -h, --help                       help for hugo

       --i18n-warnings              print missing translations

       --ignoreCache                ignores the cache directory

@@ -80,4 +81,4 @@

 * [hugo undraft](/commands/hugo_undraft/)	 - Undraft resets the content's draft status

 * [hugo version](/commands/hugo_version/)	 - Print the version number of Hugo

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_benchmark.md

+++ b/content/commands/hugo_benchmark.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo benchmark"

 slug: hugo_benchmark

 url: /commands/hugo_benchmark/

@@ -38,6 +38,7 @@

       --disableSitemap             do not build Sitemap file

       --enableGitInfo              add Git revision, date and author info to the pages

       --forceSyncStatic            copy all files when static is changed.

+      --gc                         enable to run some cleanup tasks (remove unused cache files) after the build

   -h, --help                       help for benchmark

       --i18n-warnings              print missing translations

       --ignoreCache                ignores the cache directory

@@ -72,4 +73,4 @@

 ### SEE ALSO

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_check.md

+++ b/content/commands/hugo_check.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo check"

 slug: hugo_check

 url: /commands/hugo_check/

@@ -35,4 +35,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

 * [hugo check ulimit](/commands/hugo_check_ulimit/)	 - Check system ulimit settings

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_check_ulimit.md

+++ b/content/commands/hugo_check_ulimit.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo check ulimit"

 slug: hugo_check_ulimit

 url: /commands/hugo_check_ulimit/

@@ -39,4 +39,4 @@

 ### SEE ALSO

 * [hugo check](/commands/hugo_check/)	 - Contains some verification checks

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_config.md

+++ b/content/commands/hugo_config.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo config"

 slug: hugo_config

 url: /commands/hugo_config/

@@ -38,4 +38,4 @@

 ### SEE ALSO

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_convert.md

+++ b/content/commands/hugo_convert.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo convert"

 slug: hugo_convert

 url: /commands/hugo_convert/

@@ -42,4 +42,4 @@

 * [hugo convert toTOML](/commands/hugo_convert_totoml/)	 - Convert front matter to TOML

 * [hugo convert toYAML](/commands/hugo_convert_toyaml/)	 - Convert front matter to YAML

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_convert_toJSON.md

+++ b/content/commands/hugo_convert_toJSON.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo convert toJSON"

 slug: hugo_convert_toJSON

 url: /commands/hugo_convert_tojson/

@@ -42,4 +42,4 @@

 ### SEE ALSO

 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_convert_toTOML.md

+++ b/content/commands/hugo_convert_toTOML.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo convert toTOML"

 slug: hugo_convert_toTOML

 url: /commands/hugo_convert_totoml/

@@ -42,4 +42,4 @@

 ### SEE ALSO

 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_convert_toYAML.md

+++ b/content/commands/hugo_convert_toYAML.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo convert toYAML"

 slug: hugo_convert_toYAML

 url: /commands/hugo_convert_toyaml/

@@ -42,4 +42,4 @@

 ### SEE ALSO

 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_env.md

+++ b/content/commands/hugo_env.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo env"

 slug: hugo_env

 url: /commands/hugo_env/

@@ -38,4 +38,4 @@

 ### SEE ALSO

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_gen.md

+++ b/content/commands/hugo_gen.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo gen"

 slug: hugo_gen

 url: /commands/hugo_gen/

@@ -38,4 +38,4 @@

 * [hugo gen doc](/commands/hugo_gen_doc/)	 - Generate Markdown documentation for the Hugo CLI.

 * [hugo gen man](/commands/hugo_gen_man/)	 - Generate man pages for the Hugo CLI

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_gen_autocomplete.md

+++ b/content/commands/hugo_gen_autocomplete.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo gen autocomplete"

 slug: hugo_gen_autocomplete

 url: /commands/hugo_gen_autocomplete/

@@ -56,4 +56,4 @@

 ### SEE ALSO

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_gen_chromastyles.md

+++ b/content/commands/hugo_gen_chromastyles.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo gen chromastyles"

 slug: hugo_gen_chromastyles

 url: /commands/hugo_gen_chromastyles/

@@ -43,4 +43,4 @@

 ### SEE ALSO

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_gen_doc.md

+++ b/content/commands/hugo_gen_doc.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo gen doc"

 slug: hugo_gen_doc

 url: /commands/hugo_gen_doc/

@@ -45,4 +45,4 @@

 ### SEE ALSO

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_gen_man.md

+++ b/content/commands/hugo_gen_man.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo gen man"

 slug: hugo_gen_man

 url: /commands/hugo_gen_man/

@@ -41,4 +41,4 @@

 ### SEE ALSO

 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_import.md

+++ b/content/commands/hugo_import.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo import"

 slug: hugo_import

 url: /commands/hugo_import/

@@ -37,4 +37,4 @@

 * [hugo](/commands/hugo/)	 - hugo builds your site

 * [hugo import jekyll](/commands/hugo_import_jekyll/)	 - hugo import from Jekyll

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_import_jekyll.md

+++ b/content/commands/hugo_import_jekyll.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo import jekyll"

 slug: hugo_import_jekyll

 url: /commands/hugo_import_jekyll/

@@ -41,4 +41,4 @@

 ### SEE ALSO

 * [hugo import](/commands/hugo_import/)	 - Import your site from others.

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_list.md

+++ b/content/commands/hugo_list.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo list"

 slug: hugo_list

 url: /commands/hugo_list/

@@ -40,4 +40,4 @@

 * [hugo list expired](/commands/hugo_list_expired/)	 - List all posts already expired

 * [hugo list future](/commands/hugo_list_future/)	 - List all posts dated in the future

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_list_drafts.md

+++ b/content/commands/hugo_list_drafts.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo list drafts"

 slug: hugo_list_drafts

 url: /commands/hugo_list_drafts/

@@ -39,4 +39,4 @@

 ### SEE ALSO

 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_list_expired.md

+++ b/content/commands/hugo_list_expired.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo list expired"

 slug: hugo_list_expired

 url: /commands/hugo_list_expired/

@@ -40,4 +40,4 @@

 ### SEE ALSO

 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_list_future.md

+++ b/content/commands/hugo_list_future.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo list future"

 slug: hugo_list_future

 url: /commands/hugo_list_future/

@@ -40,4 +40,4 @@

 ### SEE ALSO

 * [hugo list](/commands/hugo_list/)	 - Listing out various types of content

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_new.md

+++ b/content/commands/hugo_new.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo new"

 slug: hugo_new

 url: /commands/hugo_new/

@@ -48,4 +48,4 @@

 * [hugo new site](/commands/hugo_new_site/)	 - Create a new site (skeleton)

 * [hugo new theme](/commands/hugo_new_theme/)	 - Create a new theme

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_new_site.md

+++ b/content/commands/hugo_new_site.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo new site"

 slug: hugo_new_site

 url: /commands/hugo_new_site/

@@ -43,4 +43,4 @@

 ### SEE ALSO

 * [hugo new](/commands/hugo_new/)	 - Create new content for your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_new_theme.md

+++ b/content/commands/hugo_new_theme.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo new theme"

 slug: hugo_new_theme

 url: /commands/hugo_new_theme/

@@ -42,4 +42,4 @@

 ### SEE ALSO

 * [hugo new](/commands/hugo_new/)	 - Create new content for your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_server.md

+++ b/content/commands/hugo_server.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo server"

 slug: hugo_server

 url: /commands/hugo_server/

@@ -50,6 +50,7 @@

       --disableSitemap             do not build Sitemap file

       --enableGitInfo              add Git revision, date and author info to the pages

       --forceSyncStatic            copy all files when static is changed.

+      --gc                         enable to run some cleanup tasks (remove unused cache files) after the build

   -h, --help                       help for server

       --i18n-warnings              print missing translations

       --ignoreCache                ignores the cache directory

@@ -90,4 +91,4 @@

 ### SEE ALSO

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_undraft.md

+++ b/content/commands/hugo_undraft.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo undraft"

 slug: hugo_undraft

 url: /commands/hugo_undraft/

@@ -40,4 +40,4 @@

 ### SEE ALSO

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/commands/hugo_version.md

+++ b/content/commands/hugo_version.md

@@ -1,5 +1,5 @@

---

-date: 2017-11-18T10:28:35+01:00

+date: 2017-12-28T18:49:29+01:00

 title: "hugo version"

 slug: hugo_version

 url: /commands/hugo_version/

@@ -38,4 +38,4 @@

 ### SEE ALSO

 * [hugo](/commands/hugo/)	 - hugo builds your site

-###### Auto generated by spf13/cobra on 18-Nov-2017

+###### Auto generated by spf13/cobra on 28-Dec-2017

--- a/content/content-management/multilingual.md

+++ b/content/content-management/multilingual.md

@@ -63,7 +63,7 @@

 From **Hugo 0.31** we support multiple languages in a multihost configuration. See [this issue](https://github.com/gohugoio/hugo/issues/4027) for details.

-This means that you can now confugre a `baseURL` per `language`:

+This means that you can now configure a `baseURL` per `language`:

 > If a `baseURL` is set on the `language` level, then all languages must have one and they must all be different.

@@ -191,6 +191,19 @@

 The above can be put in a `partial` (i.e., inside `layouts/partials/`) and included in any template, be it for a [single content page][contenttemplate] or the [homepage][]. It will not print anything if there are no translations for a given page, or if there are translations---in the case of the homepage, section listing, etc.---a site with only render one language.

 The above also uses the [`i18n` function][i18func] described in the next section.

+## List All Available Languages

+`.AllTranslations` on a `Page` can be used to list all translations, including itself. Called on the home page it can be used to build a language navigator:

+{{< code file="layouts/partials/allLanguages.html" >}}

+<ul>

+{{ range $.Site.Home.AllTranslations }}

+<li><a href="{{ .}}">{{ .Language.LanguageName }}</a></li>

+{{ end }}

+</ul>

+{{< /code >}}

 ## Translation of Strings

--- a/content/content-management/organization.md

+++ b/content/content-management/organization.md

@@ -17,13 +17,6 @@

 toc: true

---

-{{% note %}}

-This section is not updated with the new nested sections support in Hugo 0.24, see https://github.com/gohugoio/hugoDocs/issues/36

-{{% /note %}}

-{{% todo %}}

-See above

-{{% /todo %}}

 {{< youtube 0GZxidrlaRM >}}

 ## Organization of Content Source

@@ -30,8 +23,10 @@

 In Hugo, your content should be organized in a manner that reflects the rendered website.

-While Hugo supports content nested at any level, the top levels (i.e. `content/<DIRECTORIES>`) are special in Hugo and are considered the content [sections][]. Without any additional configuration, the following will just work:

+While Hugo supports content nested at any level, the top levels (i.e. `content/<DIRECTORIES>`) are special in Hugo and are considered the content type used to determine layouts etc. To read more about sections, including how to nest them, see [sections][].

+Without any additional configuration, the following will just work:

```

 └── content

@@ -49,12 +44,17 @@

 ## Path Breakdown in Hugo

 The following demonstrates the relationships between your content organization and the output URL structure for your Hugo website when it renders. These examples assume you are [using pretty URLs][pretty], which is the default behavior for Hugo. The examples also assume a key-value of `baseurl = "https://example.com"` in your [site's configuration file][config].

 ### Index Pages: `_index.md`

-`_index.md` has a special role in Hugo. It allows you to add front matter and content to your [list templates][lists] as of v0.18. These templates include those for [section templates][], [taxonomy templates][], [taxonomy terms templates][], and your [homepage template][]. In your templates, you can grab information from `_index.md` using the [`.Site.GetPage` function][getpage].

+`_index.md` has a special role in Hugo. It allows you to add front matter and content to your [list templates][lists]. These templates include those for [section templates][], [taxonomy templates][], [taxonomy terms templates][], and your [homepage template][].

+{{% note %}}

+**Tip:** You can get a reference to the content and metadata in `_index.md` using the [`.Site.GetPage` function](/functions/getpage/).

+{{% /note %}}

 You can keep one `_index.md` for your homepage and one in each of your content sections, taxonomies, and taxonomy terms. The following shows typical placement of an `_index.md` that would contain content and front matter for a `posts` section list page on a Hugo website:

@@ -81,6 +81,9 @@

 https://example.com/posts/index.html

```

+The [sections][] can be nested as deeply as you need. The important part to understand is, that to make the section tree fully navigational, at least the lower-most section needs a content file. (i.e. `_index.md`).

 ### Single Pages in Sections

 Single content files in each of your sections are going to be rendered as [single page templates][singles]. Here is an example of a single `post` within `posts`:

@@ -107,27 +110,6 @@

 https://example.com/posts/my-first-hugo-post/index.html

```

-### Section with Nested Directories

-To continue the example, the following demonstrates destination paths for a file located at `content/events/chicago/lollapalooza.md` in the same site:

-```

-                    section

-                    ⊢--^--⊣

-                               url

-                    ⊢-------------^------------⊣

-      baseURL             path        slug

-⊢--------^--------⊣ ⊢------^-----⊣⊢----^------⊣

-                  permalink

-⊢----------------------^-----------------------⊣

-https://example.com/events/chicago/lollapalooza/

-```

-{{% note %}}

-As of v0.20, Hugo does not recognize nested sections. While you can nest as many content *directories* as you'd like, any child directory of a section will still be considered the same section as that of its parents. Therefore, in the above example, `{{.Section}}` for `lollapalooza.md` is `events` and *not* `chicago`. See the [related issue on GitHub](https://github.com/gohugoio/hugo/issues/465).

-{{% /note %}}

 ## Paths Explained

binary files a/content/content-management/sections.md b/content/content-management/sections.md differ

--- a/content/content-management/static-files.md

+++ b/content/content-management/static-files.md

@@ -42,4 +42,7 @@

 * The English site will get its static files as a union of "static1", "static2" and "static_en". On file duplicates, the right-most version will win.

 * The Norwegian site will get its static files as a union of "staticDir_override" and "static_no".

+**Note:** The `2` `static2` (can be a number between 0 and 10) is added to tell Hugo that you want to **add** this directory to the global set of static directories. Using `staticDir` on the language level would replace the global value.

 **Note:** The example above is a [multihost setup](/content-management/multilingual/#configure-multilingual-multihost). In a regular setup, all the static directories will be available to all sites.

--- a/content/content-management/taxonomies.md

+++ b/content/content-management/taxonomies.md

@@ -132,7 +132,7 @@

 {{% note %}}

 You can add content and front matter to your taxonomy list and taxonomy terms pages. See [Content Organization](/content-management/organization/) for more information on how to add an `_index.md` for this purpose.

-Note also that taxonomy [permalinks](/content-management/urls/) are *not* configurable.

+Much like regular pages, taxonomy list [permalinks](/content-management/urls/) are configurable, but taxonomy term page permalinks are not.

 {{% /note %}}

 ## Add Taxonomies to Content

--- a/content/content-management/urls.md

+++ b/content/content-management/urls.md

@@ -45,6 +45,8 @@

 Only the content under `post/` will have the new URL structure. For example, the file `content/post/sample-entry.md` with `date: 2017-02-27T19:20:00-05:00` in its front matter will render to `public/2017/02/sample-entry/index.html` at build time and therefore be reachable at `https://example.com/2017/02/sample-entry/`.

+You can also configure permalinks of taxonomies with the same syntax, by using the plural form of the taxonomy instead of the section. You will probably only want to use the configuration values `:slug` or `:title`.

 ### Permalink Configuration Values

 The following is a list of values that can be used in a `permalink` definition in your site `config` file. All references to time are dependent on the content's date.

--- a/content/functions/ref.md

+++ b/content/functions/ref.md

@@ -11,7 +11,7 @@

   docs:

     parent: "functions"

 keywords: [cross references, anchors]

-signature: ["ref CONTENT"]

+signature: ["ref . CONTENT"]

 workson: []

 hugoversion:

 relatedfuncs: [relref]

@@ -19,11 +19,15 @@

 aliases: []

---

-`ref` and `relRef` look up a content page by relative path (`relref`) or logical name (`ref`) to return the permalink:

+`ref` and `relref` look up a content page by logical name (`ref`) or relative path (`relref`) to return the permalink:

```

-{{ ref "about.md" }}

+{{ ref . "about.md" }}

```

+{{% note "Usage Note" %}}

+`ref` looks up Hugo "Regular Pages" only. It can't be used for the homepage, section pages, etc.

+{{% /note %}}

 These functions are used in two of Hugo's built-in shortcodes. You can see basic usage examples of both `ref` and `relref` in the [shortcode documentation](/content-management/shortcodes/#ref-and-relref).

--- a/content/functions/relref.md

+++ b/content/functions/relref.md

@@ -11,19 +11,23 @@

   docs:

     parent: "functions"

 keywords: [cross references, anchors]

-signature: ["relref CONTENT"]

+signature: ["relref . CONTENT"]

 workson: []

 hugoversion:

-relatedfuncs: [relref]

+relatedfuncs: [ref]

 deprecated: false

 aliases: []

---

-`ref` and `relRef` look up a content page by relative path (`relref`) or logical name (`ref`) to return the permalink:

+`ref` and `relref` look up a content page by logical name (`ref`) or relative path (`relref`) to return the permalink:

```

-{{ relref "about.md" }}

+{{ relref . "about.md" }}

```

+{{% note "Usage Note" %}}

+`relref` looks up Hugo "Regular Pages" only. It can't be used for the homepage, section pages, etc.

+{{% /note %}}

 These functions are used in two of Hugo's built-in shortcodes. You can see basic usage examples of both `ref` and `relref` in the [shortcode documentation](/content-management/shortcodes/#ref-and-relref).

--- a/content/getting-started/configuration.md

+++ b/content/getting-started/configuration.md

@@ -288,8 +288,7 @@

 SectionPagesMenu =

 # default sitemap configuration map

 sitemap =

-# filesystem path to read files relative from

-source =                      ""

+# filesystem path to read static files relative from

 staticDir =                   "static"

 # display memory and timing of different steps of the program

 stepAnalysis =                false

--- a/content/getting-started/installing.md

+++ b/content/getting-started/installing.md

@@ -424,10 +424,6 @@

 snap install hugo

```

-{{% note %}}

-Hugo-as-a-snap can write only inside the user’s `$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).

-{{% /note %}}

 ### Debian and Ubuntu

 Debian and Ubuntu provide a `hugo` version via `apt-get`:

@@ -444,6 +440,10 @@

 #### Cons

 * 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 user’s `$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 user’s `$HOME` directory.

+{{% /note %}}

 ### Arch Linux

--- a/content/hosting-and-deployment/hosting-on-gitlab.md

+++ b/content/hosting-and-deployment/hosting-on-gitlab.md

@@ -4,7 +4,7 @@

 description: GitLab makes it incredibly easy to build, deploy, and host your Hugo website via their free GitLab Pages service, which provides native support for Hugo.

 date: 2016-06-23

 publishdate: 2016-06-23

-lastmod: 2016-06-23

+lastmod: 2017-11-16

 categories: [hosting and deployment]

 keywords: [hosting,deployment,git,gitlab]

 authors: [Riku-Pekka Silvola]

@@ -40,9 +40,8 @@

 {{< code file="gitlab-ci.yml" >}}

 image: monachus/hugo

-before_script:

-  - git submodule init

-  - git submodule update --force

+variables:

+  GIT_SUBMODULE_STRATEGY: recursive

 pages:

   script:

--- a/content/hosting-and-deployment/hosting-on-keycdn.md

+++ b/content/hosting-and-deployment/hosting-on-keycdn.md

@@ -4,6 +4,10 @@

 description: "Accelerate your Hugo site globally with a KeyCDN integration. This tutorial shows you how to setup your static site as a GitLab page behind a KeyCDN pull zone."

 categories: [hosting and deployment]

 keywords: [keycdn,hosting,deployment,cdn]

+menu:

+  docs:

+    parent: "hosting-and-deployment"

+    weight: 40

 slug: ""

 aliases: []

 toc: false

--- /dev/null

+++ b/content/news/0.31-relnotes-ready.md

@@ -1,0 +1,80 @@

+---

+date: 2017-11-20

+title: "Hugo 0.31: Language Multihost Edition!"

+description: "Hugo 0.31: Multihost, smart union static dirs, and more ..."

+slug: "0.31-relnotes"

+categories: ["Releases"]

+images:

+- images/blog/hugo-31-poster.png

+---

+	Hugo `0.31` is the **Language Multihost Edition!**

+> <img src="https://esolia.com/img/eSolia-Logo-Flat-2015.svg" alt="eSolia" width="100px" align="top" style="width:100px" />The Multihost feature  is sponsored by [eSolia](https://esolia.com/), [@rickcogley](https://github.com/rickcogley)'s company.

+[Multihost](https://gohugo.io/content-management/multilingual/#configure-multilingual-multihost) means that you can have a **`baseURL` per language**, for example, `https://no.example.com` and `https://en.example.com`. This is seamlessly integrated, and the built-in web server with live reload and `navigateToChanged` etc. just works. A related enhancement in this release is the support for **as many static dirs as you need**, with intelligent language overrides, forming a big union file system. Add to that several other language related fixes and enhancements, it is safe to say that this is the version you want for multilingual Hugo sites!

+This release represents **44 contributions by 7 contributors** to the main Hugo code base.

+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@kaushalmodi](https://github.com/kaushalmodi), [@natefinch](https://github.com/natefinch), and [@betaveros](https://github.com/betaveros) for their ongoing contributions.

+And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.

+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),

+which has received **13 contributions by 9 contributors**. A special thanks to [@oncletom](https://github.com/oncletom), [@kaushalmodi](https://github.com/kaushalmodi), [@XhmikosR](https://github.com/XhmikosR), and [@digitalcraftsman](https://github.com/digitalcraftsman) for their work on the documentation site.

+Hugo now has:

+* 21105+ [stars](https://github.com/gohugoio/hugo/stargazers)

+* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)

+* 184+ [themes](http://themes.gohugo.io/)

+## Notes

+* For mapping of translated content, Hugo now considers the full path of the content file, which makes it possible with translation of duplicate content filenames such as `index.md`. A specific translation key can be specified with the new `translationKey` front matter variable. See [#2699](https://github.com/gohugoio/hugo/issues/2699).

+## Enhancements

+### Language related

+* Support unknown language codes [23ba779f](https://github.com/gohugoio/hugo/commit/23ba779fab90ce45cddd68b4f49a2515ce6d4878) [@bep](https://github.com/bep) [#3564](https://github.com/gohugoio/hugo/issues/3564)

+* Fix `.IsTranslated`  with identical filenames [b3daa1f4](https://github.com/gohugoio/hugo/commit/b3daa1f4bf1b84bcc5da028257ba609be74e3ecc) [@bep](https://github.com/bep) [#2699](https://github.com/gohugoio/hugo/issues/2699)

+* Fall back to unstranslated base template [0a81a6b4](https://github.com/gohugoio/hugo/commit/0a81a6b4bae3de53aa9c179b855c671a2d30eec7) [@bep](https://github.com/bep) [#3893](https://github.com/gohugoio/hugo/issues/3893)

+* Add support for multiple static dirs [60dfb9a6](https://github.com/gohugoio/hugo/commit/60dfb9a6e076200ab3ca3fd30e34bb3c14e0a893) [@bep](https://github.com/bep) [#36](https://github.com/gohugoio/hugo/issues/36)[#4027](https://github.com/gohugoio/hugo/issues/4027)

+* Add multilingual multihost support [2e046576](https://github.com/gohugoio/hugo/commit/2e0465764b5dacc511b977b1c9aa07324ad0ee9c) [@bep](https://github.com/bep) [#4027](https://github.com/gohugoio/hugo/issues/4027)

+### Templates

+* Refactor `Mod` with `cast` [76dc811c](https://github.com/gohugoio/hugo/commit/76dc811c6539b2ed8b4d3b22693e5088b9f6ecfe) [@artem-sidorenko](https://github.com/artem-sidorenko)

+* Add support for height argument to figure shortcode [488631fe](https://github.com/gohugoio/hugo/commit/488631fe0abc3667355345c7eb98ba7a2204deb5) [@kaushalmodi](https://github.com/kaushalmodi) [#4014](https://github.com/gohugoio/hugo/issues/4014)

+### Core

+* Use ms precision for static change logging [bb048d81](https://github.com/gohugoio/hugo/commit/bb048d811d3977adb10656335cd339cd8c945a25) [@bep](https://github.com/bep)

+* Update Chroma to get the latest SASS lexer [b32ffed6](https://github.com/gohugoio/hugo/commit/b32ffed6abc67646cad89e163846f3ffef29cec8) [@bep](https://github.com/bep) [#4069](https://github.com/gohugoio/hugo/issues/4069)

+* Bump to Go 1.9.2 [9299a16c](https://github.com/gohugoio/hugo/commit/9299a16c9952a284d3ac3f31d2662f1812f77768) [@bep](https://github.com/bep) [#4064](https://github.com/gohugoio/hugo/issues/4064)

+* Update Travis and snapcraft to Go 1.9.2 [77cbd001](https://github.com/gohugoio/hugo/commit/77cbd001ff6b2e0aaa48566ef2af49ca68e19af9) [@bep](https://github.com/bep) [#4064](https://github.com/gohugoio/hugo/issues/4064)

+* Handle Taxonomy permalinks [d9a78b61](https://github.com/gohugoio/hugo/commit/d9a78b61adefe8e1803529f4774185874af85148) [@betaveros](https://github.com/betaveros) [#1208](https://github.com/gohugoio/hugo/issues/1208)

+### Other

+* Support Fast Render mode with sub-path in baseURL [31641033](https://github.com/gohugoio/hugo/commit/3164103310fbca1211cfa9ce4a5eb7437854b6ad) [@bep](https://github.com/bep) [#3981](https://github.com/gohugoio/hugo/issues/3981)

+* Simplify Site benchmarks [c3c10f2c](https://github.com/gohugoio/hugo/commit/c3c10f2c7ce4ee11186f51161943efc8b37a28c9) [@bep](https://github.com/bep)

+* Replace `make` with `mage` to build Hugo [#3969](https://github.com/gohugoio/hugo/issues/3969)

+* Convert to `dep` as  dependency/vendor manager for Hugo [#3988](https://github.com/gohugoio/hugo/issues/3988)

+* Pre-allocate some slices [a9be687b](https://github.com/gohugoio/hugo/commit/a9be687b81df01c7343f78f0d3760042f467baa4) [@bep](https://github.com/bep)

+## Fixes

+### Templates

+* Make sure only one instance of a cached partial is rendered [#4086](https://github.com/gohugoio/hugo/issues/4086)

+### Other

+* Fix broken shortcodes for `Ace` and `Amber` [503ca6de](https://github.com/gohugoio/hugo/commit/503ca6de6ceb0b4af533f9efeff917d6f3871278) [@bep](https://github.com/bep) [#4051](https://github.com/gohugoio/hugo/issues/4051)

+* Fix error handling in `mage` build [c9c19d79](https://github.com/gohugoio/hugo/commit/c9c19d794537cf76ff281788c3d6cf5f2beac54d) [@natefinch](https://github.com/natefinch)

+* Fix `hugo -w` [fa53b13c](https://github.com/gohugoio/hugo/commit/fa53b13ca0ffb1db6ed20f5353661d3f8a5fd455) [@bep](https://github.com/bep) [#3980](https://github.com/gohugoio/hugo/issues/3980)

--- /dev/null

+++ b/content/news/0.31.1-relnotes-ready.md

@@ -1,0 +1,20 @@

+---

+date: 2017-11-27

+title: "Hugo 0.31.1: One Bugfix!"

+description: "Fixes broken `--appendPort=false`."

+slug: "0.31.1"

+categories: ["Releases"]

+images:

+- images/blog/hugo-bug-poster.png

+---

+This is a bug-fix release with one important bug fix:

+* Fix broken `--appendPort=false` [8afd7d9c](https://github.com/gohugoio/hugo/commit/8afd7d9ceb0d168300e3399c6e87a355a88c9a28) [@bep](https://github.com/bep) [#4111](https://github.com/gohugoio/hugo/issues/4111)

--- a/content/readfiles/bfconfig.md

+++ b/content/readfiles/bfconfig.md

@@ -52,7 +52,7 @@

 `extensions`

 : default: **`[]`** <br>

     Purpose: Enable one or more Blackfriday's Markdown extensions (**`EXTENSION_*`**). <br>

-    Example: Include `hardLineBreak` in the list to enable Blackfriday's `EXTENSION_HARD_LINK_BREAK`. <br>

+    Example: Include `hardLineBreak` in the list to enable Blackfriday's `EXTENSION_HARD_LINE_BREAK`. <br>

     *See [Blackfriday extensions](#blackfriday-extensions) section for information on all extensions.*

 `extensionsmask`

--- /dev/null

+++ b/content/readfiles/sectionvars.md

@@ -1,0 +1,20 @@

+.CurrentSection

+: the page's current section. The value can be the page itself if it is a section or the homepage.

+.InSection $anotherPage

+: whether the given page is in the current section. Note that this will always return false for pages that are not either regular, home or section pages.

+.IsAncestor $anotherPage

+: whether the current page is an ancestor of the given page. Note that this method is not relevant for taxonomy lists and taxonomy terms pages.

+.IsDescendant $anotherPage

+: whether the current page is a descendant of the given page. Note that this method is not relevant for taxonomy lists and taxonomy terms pages.

+.Parent

+: a section's parent section or a page's section.

+.Section

+: the [section](/content-management/sections/) this content belongs to. **Note:** For nested sections, this is the first path element in the directory, for example, `/blog/funny/mypost/ => blog`.

+.Sections

+: the [sections](/content-management/sections/) below this content.

--- a/content/templates/introduction.md

+++ b/content/templates/introduction.md

@@ -101,7 +101,7 @@

 => true (i.e., since 1 is less than 2)

```

-Note that both examples make us of Go template's [math functions][].

+Note that both examples make use of Go template's [math functions][].

 {{% note "Additional Boolean Operators" %}}

 There are more boolean operators than those listed in the Hugo docs in the [Golang template documentation](http://golang.org/pkg/text/template/#hdr-Functions).

--- a/content/templates/output-formats.md

+++ b/content/templates/output-formats.md

@@ -37,8 +37,6 @@

 To add or modify a media type, define it in a `mediaTypes` section in your [site configuration][config], either for all sites or for a given language.

-Example in `config.toml`:

```

 [mediaTypes]

   [mediaTypes."text/enriched"]

@@ -49,6 +47,21 @@

 The above example adds one new media type, `text/enriched`, and changes the suffix for the built-in `text/html` media type.

+**Note:** these media types are configured for **your output formats**. If you want to redefine one of Hugo's default output formats (e.g. `HTML`), you also need to redefine the output format. So, if you want to change the suffix of the `HTML` output format from `html` (default) to `htm`:

+```toml

+[mediaTypes]

+[mediaTypes."text/html"]

+suffix = "htm"

+# Redefine HTML to update its media type.

+[outputFormats]

+[outputFormats.HTML]

+mediaType = "text/html"

+```

+**Note** that for the above to work, you also need to add an`outputs` definition in your site config.

 ## Output Formats

 Given a media type and some additional configuration, you get an `Output Format`:

@@ -61,7 +74,7 @@

 * The `MediaType` must match the `Type` of an already defined media type.

 * You can define new output formats or redefine built-in output formats; e.g., if you want to put `AMP` pages in a different path.

-To add or modify an output format, define it in an `outputFormats` section in your site's [configuration file](/templates/configuration/), either for all sites or for a given language.

+To add or modify an output format, define it in an `outputFormats` section in your site's [configuration file](/getting-started/configuration/), either for all sites or for a given language.

```

 [outputFormats.MyEnrichedFormat]

--- a/content/templates/taxonomy-templates.md

+++ b/content/templates/taxonomy-templates.md

@@ -78,6 +78,9 @@

 .ByCount

 : Returns an OrderedTaxonomy (slice) ordered by number of entries.

+.Reverse

+: Returns an OrderedTaxonomy (slice) in reverse order. Must be used with an OrderedTaxonomy.

 ### OrderedTaxonomy

 Since Maps are unordered, an OrderedTaxonomy is a special structure that has a defined order.

@@ -155,6 +158,17 @@

 <ul>

   {{ $data := .Data }}

   {{ range $key, $value := .Data.Terms.ByCount }}

+  <li><a href="{{ $.Site.LanguagePrefix }}/{{ $data.Plural }}/{{ $value.Name | urlize }}"> {{ $value.Name }} </a> {{ $value.Count }} </li>

+  {{ end }}

+</ul>

+```

+### Order by Least Popular Example

+```

+<ul>

+  {{ $data := .Data }}

+  {{ range $key, $value := .Data.Terms.ByCount.Reverse }}

   <li><a href="{{ $.Site.LanguagePrefix }}/{{ $data.Plural }}/{{ $value.Name | urlize }}"> {{ $value.Name }} </a> {{ $value.Count }} </li>

   {{ end }}

 </ul>

--- a/content/variables/files.md

+++ b/content/variables/files.md

@@ -24,25 +24,25 @@

 The `.File` object contains the following fields:

-`.File.Path`

+.File.Path

 : the original relative path of the page (e.g., `content/posts/foo.en.md`)

-`.File.LogicalName`

+.File.LogicalName

 : the name of the content file that represents a page (e.g., `foo.en.md`)

-`.File.TranslationBaseName`

+.File.TranslationBaseName

 : the filename without extension or optional language identifier (e.g., `foo`)

-`.File.BaseFileName`

+.File.BaseFileName

 : the filename without extension (e.g., `foo.en`)

-`.File.Ext`

+.File.Ext

 : the file extension of the content file (e.g., `md`); this can also be called using `.File.Extension` as well. Note that it is *only* the extension without `.`.

-`.File.Lang`

+.File.Lang

 : the language associated with the given file if Hugo's [Multilingual features][multilingual] are enabled (e.g., `en`)

-`.File.Dir`

+.File.Dir

 : given the path `content/posts/dir1/dir2/`, the relative directory path of the content file will be returned (e.g., `posts/dir1/dir2/`)

 [Multilingual]: /content-management/multilingual/

\ No newline at end of file

--- a/content/variables/git.md

+++ b/content/variables/git.md

@@ -33,22 +33,22 @@

 The `GitInfo` object contains the following fields:

-`.AbbreviatedHash`

+.AbbreviatedHash

 : the abbreviated commit hash (e.g., `866cbcc`)

-`.AuthorName`

+.AuthorName

 : the author's name, respecting `.mailmap`

-`.AuthorEmail`

+.AuthorEmail

 : the author's email address, respecting `.mailmap`

-`.AuthorDate`

+.AuthorDate

 : the author date

-`.Hash`

+.Hash

 : the commit hash (e.g., `866cbccdab588b9908887ffd3b4f2667e94090c3`)

-`.Subject`

+.Subject

 : commit message subject (e.g., `tpl: Add custom index function`)

 ## `.Lastmod`

--- a/content/variables/hugo.md

+++ b/content/variables/hugo.md

@@ -21,16 +21,16 @@

 It contains the following fields:

-`.Hugo.Generator`

+.Hugo.Generator

 : `<meta>` tag for the version of Hugo that generated the site. `.Hugo.Generator` outputs a *complete* HTML tag; e.g. `<meta name="generator" content="Hugo 0.18" />`

-`.Hugo.Version`

+.Hugo.Version

 : the current version of the Hugo binary you are using e.g. `0.13-DEV`<br>

-`.Hugo.CommitHash`

+.Hugo.CommitHash

 : the git commit hash of the current Hugo binary e.g. `0e8bed9ccffba0df554728b46c5bbf6d78ae5247`

-`.Hugo.BuildDate`

+.Hugo.BuildDate

 : the compile date of the current Hugo binary formatted with RFC 3339 e.g. `2002-10-02T10:00:00-05:00`<br>

 {{% note "Use the Hugo Generator Tag" %}}

--- a/content/variables/menus.md

+++ b/content/variables/menus.md

@@ -20,31 +20,31 @@

 The [menu template][] has the following properties:

-`.URL`

+.URL

 : string

-`.Name`

+.Name

 : string

-`.Menu`

+.Menu

 : string

-`.Identifier`

+.Identifier

 : string

-`.Pre`

+.Pre

 : template.HTML

-`.Post`

+.Post

 : template.HTML

-`.Weight`

+.Weight

 : int

-`.Parent`

+.Parent

 : string

-`.Children`

+.Children

 : Menu

 [menu template]: /templates/menu-templates/

\ No newline at end of file

--- a/content/variables/page.md

+++ b/content/variables/page.md

@@ -26,68 +26,65 @@

 ## Page Variables

-`.AlternativeOutputFormats`

+.AlternativeOutputFormats

 : contains all alternative formats for a given page; this variable is especially useful `link rel` list in your site's `<head>`. (See [Output Formats](/templates/output-formats/).)

-`.Content`

+.Content

 : the content itself, defined below the front matter.

-`.CurrentSection`

-: the page's current section. The value can be the page itself if it is a section or the homepage.

-`.Data`

+.Data

 : the data specific to this type of page.

-`.Date`

+.Date

 : the date associated with the page; `.Date` pulls from the `date` field in a content's front matter. See also `.ExpiryDate`, `.PublishDate`, and `.Lastmod`.

-`.Description`

+.Description

 : the description for the page.

-`.Dir`

+.Dir

 : the path of the folder containing this content file. The path is relative to the `content` folder.

-`.Draft`

+.Draft

 : a boolean, `true` if the content is marked as a draft in the front matter.

-`.ExpiryDate`

+.ExpiryDate

 : the date on which the content is scheduled to expire; `.ExpiryDate` pulls from the `expirydate` field in a content's front matter. See also `.PublishDate`, `.Date`, and `.Lastmod`.

-`.File`

+.File

 : filesystem-related data for this content file. See also [File Variables][].

-`.FuzzyWordCount`

+.FuzzyWordCount

 : the approximate number of words in the content.

-`.Hugo`

+.Hugo

 : see [Hugo Variables](/variables/hugo/).

-`.IsHome`

+.IsHome

 : `true` in the context of the [homepage](/templates/homepage/).

-`.IsNode`

+.IsNode

 : always `false` for regular content pages.

-`.IsPage`

+.IsPage

 : always `true` for regular content pages.

-`.IsTranslated`

+.IsTranslated

 : `true` if there are translations to display.

-`.Keywords`

+.Keywords

 : the meta keywords for the content.

-`.Kind`

+.Kind

 : the page's *kind*. Possible return values are `page`, `home`, `section`, `taxonomy`, or `taxonomyTerm`. Note that there are also `RSS`, `sitemap`, `robotsTXT`, and `404` kinds, but these are only available during the rendering of each of these respective page's kind and therefore *not* available in any of the `Pages` collections.

-`.Lang`

+.Lang

 : language taken from the language extension notation.

-`.Language`

+.Language

 : a language object that points to the language's definition in the site

 `config`.

-`.Lastmod`

+.Lastmod

 : the date the content was last modified. `.Lastmod` pulls from the `lastmod` field in a content's front matter.

  - If `lastmod` is not set, and `.GitInfo` feature is disabled, the front matter `date` field will be used.

@@ -95,97 +92,97 @@

 See also `.ExpiryDate`, `.Date`, `.PublishDate`, and [`.GitInfo`][gitinfo].

-`.LinkTitle`

+.LinkTitle

 : access when creating links to the content. If set, Hugo will use the `linktitle` from the front matter before `title`.

-`.Next`

+.Next

 : pointer to the following content (based on the `publishdate` field in front matter).

-`.NextInSection`

+.NextInSection

 : pointer to the following content within the same section (based on `publishdate` field in front matter).

-`.OutputFormats`

+.OutputFormats

 : contains all formats, including the current format, for a given page. Can be combined the with [`.Get` function](/functions/get/) to grab a specific format. (See [Output Formats](/templates/output-formats/).)

-`.Pages`

+.Pages

 : a collection of associated pages. This value will be `nil` for regular content pages. `.Pages` is an alias for `.Data.Pages`.

-`.Permalink`

+.Permalink

 : the Permanent link for this page; see [Permalinks](/content-management/urls/)

-`.Plain`

+.Plain

 : the Page content stripped of HTML tags and presented as a string.

-`.PlainWords`

+.PlainWords

 : the Page content stripped of HTML as a `[]string` using Go's [`strings.Fields`](https://golang.org/pkg/strings/#Fields) to split `.Plain` into a slice.

-`.Prev`

+.Prev

 : Pointer to the previous content (based on `publishdate` in front matter).

-`.PrevInSection`

+.PrevInSection

 : Pointer to the previous content within the same section (based on `publishdate` in front matter). For example, `{{if .PrevInSection}}{{.PrevInSection.Permalink}}{{end}}`.

-`.PublishDate`

+.PublishDate

 : the date on which the content was or will be published; `.Publishdate` pulls from the `publishdate` field in a content's front matter. See also `.ExpiryDate`, `.Date`, and `.Lastmod`.

-`.RSSLink`

+.RSSLink

 : link to the taxonomies' RSS link.

-`.RawContent`

+.RawContent

 : raw markdown content without the front matter. Useful with [remarkjs.com](

 http://remarkjs.com)

-`.ReadingTime`

+.ReadingTime

 : the estimated time, in minutes, it takes to read the content.

-`.Ref`

+.Ref

 : returns the permalink for a given reference (e.g., `.Ref "sample.md"`).  `.Ref` does *not* handle in-page fragments correctly. See [Cross References](/content-management/cross-references/).

-`.RelPermalink`

+.RelPermalink

 : the relative permanent link for this page.

-`.RelRef`

+.RelRef

 : returns the relative permalink for a given reference (e.g., `RelRef

 "sample.md"`). `.RelRef` does *not* handle in-page fragments correctly. See [Cross References](/content-management/cross-references/).

-`.Section`

-: the [section](/content-management/sections/) this content belongs to.

-`.Sections`

-: the [sections](/content-management/sections/) below this content.

-`.Site`

+.Site

 : see [Site Variables](/variables/site/).

-`.Summary`

+.Summary

 : a generated summary of the content for easily showing a snippet in a summary view. The breakpoint can be set manually by inserting <code>&lt;!&#x2d;&#x2d;more&#x2d;&#x2d;&gt;</code> at the appropriate place in the content page. See [Content Summaries](/content-management/summaries/) for more details.

-`.TableOfContents`

+.TableOfContents

 : the rendered [table of contents](/content-management/toc/) for the page.

-`.Title`

+.Title

 : the title for this page.

-`.Translations`

+.Translations

 : a list of translated versions of the current page. See [Multilingual Mode](/content-management/multilingual/) for more information.

-`.Truncated`

+.Truncated

 : a boolean, `true` if the `.Summary` is truncated. Useful for showing a "Read more..." link only when necessary.  See [Summaries](/content-management/summaries/) for more information.

-`.Type`

+.Type

 : the [content type](/content-management/types/) of the content (e.g., `post`).

-`.URL`

+.URL

 : the URL for the page relative to the web root. Note that a `url` set directly in front matter overrides the default relative URL for the rendered page.

-`.UniqueID`

+.UniqueID

 : the MD5-checksum of the content file's path.

-`.Weight`

+.Weight

 : assigned weight (in the front matter) to this content, used in sorting.

-`.WordCount`

+.WordCount

 : the number of words in the content.

+## Section Variables and Methods

+Also see [Sections](/content-management/sections/).

+{{< readfile file="/content/readfiles/sectionvars.md" markdown="true" >}}

 ## Page-level Params

--- a/content/variables/shortcodes.md

+++ b/content/variables/shortcodes.md

@@ -20,13 +20,13 @@

 [Shortcodes][shortcodes] have access to parameters delimited in the shortcode declaration via [`.Get`][getfunction], page- and site-level variables, and also the following shortcode-specific fields:

-`.Parent`

+.Parent

 : provides access to the parent shortcode context in nested shortcodes. This can be very useful for inheritance of common shortcode parameters from the root.

-`.IsNamedParams`

+.IsNamedParams

 : boolean that returns `true` when the shortcode in question uses [named rather than positional parameters][shortcodes]

-`.Inner`

+.Inner

 : represents the content between the opening and closing shortcode tags when a [closing shortcode][markdownshortcode] is used

 [getfunction]: /functions/get/

--- a/content/variables/site.md

+++ b/content/variables/site.md

@@ -22,82 +22,82 @@

 ## Site Variables List

-`.Site.AllPages`

+.Site.AllPages

 : array of all pages, regardless of their translation.

-`.Site.Author`

+.Site.Author

 : a map of the authors as defined in the site configuration.

-`.Site.BaseURL`

+.Site.BaseURL

 : the base URL for the site as defined in the site configuration.

-`.Site.BuildDrafts`

+.Site.BuildDrafts

 : a boolean (default: `false`) to indicate whether to build drafts as defined in the site configuration.

-`.Site.Copyright`

+.Site.Copyright

 : a string representing the copyright of your website as defined in the site configuration.

-`.Site.Data`

+.Site.Data

 : custom data, see [Data Templates](/templates/data-templates/).

-`.Site.DisqusShortname`

+.Site.DisqusShortname

 : a string representing the shortname of the Disqus shortcode as defined in the site configuration.

-`.Site.Files`

+.Site.Files

 : all source files for the Hugo website.

-`.Site.GoogleAnalytics`

+.Site.GoogleAnalytics

 : a string representing your tracking code for Google Analytics as defined in the site configuration.

-`.Site.IsMultiLingual`

+.Site.IsMultiLingual

 : whether there are more than one language in this site. See [Multilingual](/content-management/multilingual/) for more information.

-`.Site.Language.Lang`

+.Site.Language.Lang

 : the language code of the current locale (e.g., `en`).

-`.Site.Language.LanguageName`

+.Site.Language.LanguageName

 : the full language name (e.g. `English`).

-`.Site.Language.Weight`

+.Site.Language.Weight

 : the weight that defines the order in the `.Site.Languages` list.

-`.Site.Language`

+.Site.Language

 : indicates the language currently being used to render the website. This object's attributes are set in site configurations' language definition.

-`.Site.LanguageCode`

+.Site.LanguageCode

 : a string representing the language as defined in the site configuration. This is mostly used to populate the RSS feeds with the right language code.

-`.Site.LanguagePrefix`

+.Site.LanguagePrefix

 : this can be used to prefix URLs to point to the correct language. It will even work when only one defined language. See also the functions [absLangURL](/functions/abslangurl/) and [relLangURL](/functions/rellangurl).

-`.Site.Languages`

+.Site.Languages

 : an ordered list (ordered by defined weight) of languages.

-`.Site.LastChange`

+.Site.LastChange

 : a string representing the date/time of the most recent change to your site. This string is based on the [`date` variable in the front matter](/content-management/front-matter) of your content pages.

-`.Site.Menus`

+.Site.Menus

 : all of the menus in the site.

-`.Site.Pages`

+.Site.Pages

 : array of all content ordered by Date with the newest first. This array contains only the pages in the current language.

-`.Site.Permalinks`

+.Site.Permalinks

 : a string to override the default [permalink](/content-management/urls/) format as defined in the site configuration.

-`.Site.RegularPages`

+.Site.RegularPages

 : a shortcut to the *regular* page collection. `.Site.RegularPages` is equivalent to `where .Site.Pages "Kind" "page"`.

-`.Site.RSSLink`

+.Site.RSSLink

 : the URL for the site RSS.

-`.Site.Sections`

+.Site.Sections

 : top-level directories of the site.

-`.Site.Taxonomies`

+.Site.Taxonomies

 : the [taxonomies](/taxonomies/usage/) for the entire site.  Replaces the now-obsolete `.Site.Indexes` since v0.11. Also see section [Taxonomies elsewhere](#taxonomies-elsewhere).

-`.Site.Title`

+.Site.Title

 : a string representing the title of the site.

 ## The `.Site.Params` Variable

--- a/content/variables/sitemap.md

+++ b/content/variables/sitemap.md

@@ -20,13 +20,13 @@

 A sitemap is a `Page` and therefore has all the [page variables][pagevars] available to use sitemap templates. They also have the following sitemap-specific variables available to them:

-`.Sitemap.ChangeFreq`

+.Sitemap.ChangeFreq

 : the page change frequency

-`.Sitemap.Priority`

+.Sitemap.Priority

 : the priority of the page

-`.Sitemap.Filename`

+.Sitemap.Filename

 : the sitemap filename

 [pagevars]: /variables/page/

\ No newline at end of file

--- a/content/variables/taxonomy.md

+++ b/content/variables/taxonomy.md

@@ -24,22 +24,22 @@

 For example, the following fields would be available in `layouts/_defaults/terms.html`, depending on how you organize your [taxonomy templates][taxonomytemplates]:

-`.Data.Singular`

+.Data.Singular

 : The singular name of the taxonomy (e.g., `tags => `tag`)

-`.Data.Plural`

+.Data.Plural

 : The plural name of the taxonomy (e.g., `tags => tags`)

-`.Data.Pages`

+.Data.Pages

 : The list of pages in the taxonomy

-`.Data.Terms`

+.Data.Terms

 : The taxonomy itself

-`.Data.Terms.Alphabetical`

+.Data.Terms.Alphabetical

 : The taxonomy terms alphabetized

-`.Data.Terms.ByCount`

+.Data.Terms.ByCount

 : The Terms ordered by popularity

 Note that `.Data.Terms.Alphabetical` and `.Data.Terms.ByCount` can also be reversed:

--- a/netlify.toml

+++ b/netlify.toml

@@ -3,15 +3,15 @@

   command = "hugo"

 [context.production.environment]

-  HUGO_VERSION = "0.30.2"

+  HUGO_VERSION = "0.31.1"

   HUGO_ENV = "production"

   HUGO_ENABLEGITINFO = "true"

 [context.deploy-preview.environment]

-  HUGO_VERSION = "0.30.2"

+  HUGO_VERSION = "0.31.1"

 [context.branch-deploy.environment]

-  HUGO_VERSION = "0.30.2"

+  HUGO_VERSION = "0.31.1"

 [context.next.environment]

   HUGO_BASEURL = "https://next--gohugoio.netlify.com/"

binary files /dev/null b/static/images/blog/hugo-32-poster.png differ

--- /dev/null

+++ b/static/images/gopher-side_color.svg

@@ -1,0 +1,31 @@

+<?xml version="1.0" encoding="utf-8"?>

+<!-- Generator: Adobe Illustrator 18.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->

+<svg version="1.1" id="レイヤー_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px"

+	 y="0px" viewBox="0 0 397.8 535.6" enable-background="new 0 0 397.8 535.6" xml:space="preserve">

+<g>

+	<path fill="#E0DEDC" d="M68.5,64c0,0-45.3-8-56.4,40.2c-11.7,50.6,27,46.7,27,46.7L68.5,64z"/>

+	<g>

+		<path fill="#040000" stroke="#040000" stroke-width="1.3483" stroke-miterlimit="10" d="M23.9,86.2c-8.5-0.3-15.5,25.8-13.1,35.2

+			c0.9,3.5,10,6.3,14-3.7C27.7,110.4,34.5,86.5,23.9,86.2z"/>

+		<path fill="#FFFFFF" d="M17.6,94c-1.9-0.6-4,4.5-4.7,6.3c-1.8,5.3,2.1,5.1,4.4,2C18.5,100.7,19.5,94.7,17.6,94z"/>

+	</g>

+	<path fill="#B8937F" d="M46.3,487.8c5.2,7.3,41.6,6.4,46.1-1.3c4.2-7.1-21.4-14.9-30.7-16.1C47.6,468.6,42.6,482.5,46.3,487.8z"/>

+	<path fill="#B8937F" d="M351,446c5.2,7.3,29.4,3.7,34-4c4.2-7.1-9.3-12.2-18.6-13.4C352.3,426.8,347.3,440.7,351,446z"/>

+	<path fill="#8CC5E7" d="M189.6,13.4c0,0-182.1-8.9-161,217.6c6.3,68-43.8,182.8,29.2,239.8c0,0,102.1,61.7,238.9,41.5

+		c20-3,45.5-10,63.2-57.1c22.3-59.5,6.6-121.5-13.2-165.5c-22.3-49.7-21.2-105.8-19.6-115.3C354.3,14.2,189.6,13.4,189.6,13.4z"/>

+	<path fill="#8CC5E7" d="M282.3,38.8c19.2-5,32.6-10.5,43.4-5c30.5,15.7-4.9,45.4-12.4,51C302.3,93.2,268.4,42.4,282.3,38.8z"/>

+	<path fill="#3C89BF" d="M306,40.5c-18.8,4.2-19.6,13.7-14.8,16.4c2.8,1.6,0.8-8.1,13.6-3.8c5.2,1.7-2.5,14.3,12.1,0.2

+		C324.7,45.6,310.1,39.6,306,40.5z"/>

+	<path fill="#E0DEDC" d="M137.9,29.2c-22.9,1.7-76.1,28.5-50,94.2c9.1,23,104.6,10.3,105.8-54C194.1,42.6,158.1,27.7,137.9,29.2z"/>

+	<path fill="#040000" stroke="#040000" stroke-width="1.3483" stroke-miterlimit="10" d="M109.9,51.8C88.5,53.7,83.3,84,91.3,91.1

+		c4.5,4,20.1,8.6,28.5-19C122.5,63.3,117.8,51,109.9,51.8z"/>

+	<path fill="#FFFFFF" d="M101.7,57.4c-3.1-0.9-8.8,7-7.1,10.3c0.6,1.2,3.2,2.9,5.3,1.3C102.2,67.2,107.8,59.1,101.7,57.4z"/>

+	<path fill="#B8937F" d="M74.6,130.1C34.9,122.3,30,165,43.9,172.3c10.1,5.4,38.8-3.5,43.6-13.4C92.2,148.9,95,134.1,74.6,130.1z"/>

+	<path fill="#040000" d="M48,126.4c-12.5,4.3-11.8,25.4-5.1,26c7.6,0.7,21-14.7,24.2-20.9C69.5,126.9,53,124.7,48,126.4z"/>

+	<path fill="#E0DEDC" d="M52.5,169.9c-3.2,1.4-2.9,18.8,3.3,21.5c19.6,8.3,20.9-20.4,17.1-24.9C70,162.9,54.7,168.9,52.5,169.9z"/>

+	<path fill="#B8937F" d="M272,269.2c-11.2,0.5-19.7,23.3-16.9,34.3c1.5,5.9,12.9,5,11.3,9.6c-2.7,7.6,17.4,12.9,21.2,4.7

+		C306.9,277,282.3,268.8,272,269.2z"/>

+	<path fill="#B8937F" d="M251.8,497.4c-39.7-4.3-51.7,14.7-44.4,21.8c7.7,7.5,38.1,5.3,54.7,3.9

+		C268.7,522.6,261.8,498.5,251.8,497.4z"/>

+</g>

+</svg>

binary files /dev/null b/static/images/hugo-content-bundles.png differ

--- /dev/null

+++ b/themes/gohugoioTheme/data/sponsors.toml

@@ -1,0 +1,17 @@

+[[banners]]

+name = "Forestry.io"

+link = "https://forestry.io/"

+logo = "/images/sponsors/forestry-logotype.svg"

+copy = ""

+[[banners]]

+name = ""

+link = ""

+logo = ""

+copy = ""

+[[banners]]

+name = ""

+link = ""

+logo = ""

+copy = ""

\ No newline at end of file

--- a/themes/gohugoioTheme/layouts/index.html

+++ b/themes/gohugoioTheme/layouts/index.html

@@ -14,6 +14,9 @@

   <section class="w-100 ph4 ph5-ns pv4 pv6-ns mid-gray bg-white bb bt b--light-gray">

     {{- partial "home-page-sections/installation" . -}}

   </section>

+  {{ partial "home-page-sections/sponsors.html" (dict "cx" . ) }}

   <section class="w-100 ph4 ph5-ns pv4 pv6-ns mid-gray bg-accent-color-dark">

     {{- partial "home-page-sections/tweets" . -}}

   </section>

binary files /dev/null b/themes/gohugoioTheme/layouts/partials/home-page-sections/sponsors.html differ

--- a/themes/gohugoioTheme/layouts/partials/nav-mobile.html

+++ b/themes/gohugoioTheme/layouts/partials/nav-mobile.html

@@ -5,8 +5,8 @@

     {{ partial "nav-links-docs-mobile.html" . }}

 </div>

-<div class="flex dn-l">

-  <button class="js-toggle flex-auto ml2 dib dn-l f6 tc db mt4-ns ph3 pv2 link white bg-primary-color-dark hover-bg-primary-color ba b--white-40 w-auto" data-target=".globalmenu">Menu</button>

+<div class="flex dn-l justify-between">

+  <button class="js-toggle flex-auto dib dn-l f6 tc db mt4-ns ph3 pv2 link mr2 white bg-primary-color-dark hover-bg-primary-color ba b--white-40 w-auto" data-target=".globalmenu">Menu</button>

-  <button class="js-toggle flex-auto ml2 dib dn-l f6 tc db mt4-ns ph3 pv2 link white bg-primary-color-dark hover-bg-primary-color ba b--white-40 w-auto" data-target=".docsmenu">Docs Menu</button>

+  <button class="js-toggle flex-auto dib dn-l f6 tc db mt4-ns ph3 pv2 link white bg-primary-color-dark hover-bg-primary-color ba b--white-40 w-auto" data-target=".docsmenu">Docs Menu</button>

 </div>

--- a/themes/gohugoioTheme/layouts/partials/site-footer.html

+++ b/themes/gohugoioTheme/layouts/partials/site-footer.html

@@ -1,40 +1,48 @@

-<footer class="fixed relative-l bg-primary-color-dark bottom-0 w-100 pa3 pa4-l" role="contentinfo">

-  <!-- TODO: Make sure we don't lose all the footer content on mobile -->

-  <!-- TODO: Add icons https://github.com/rdwatters/hugo-docs-concept/issues/3#issuecomment-287194777

--->

-    <div class="dn db-l flex-ns flex-wrap w-80 center mw9 justify-between">

-      <div class="w-third pv3 dn db-l">

-         <div class="mb3 gray tc nested-links">

+<footer class="bg-primary-color-dark ph4-ns pt4 relative w-100" role="contentinfo">

+    <div class="center flex-ns flex-wrap justify-between mw9 w-90">

+      <div class="pb3 pt4 w-100 w-50-ns">

+         <div class="b f3  light-gray mb3 nested-links tc">

            By the <a href="https://github.com/gohugoio/hugo/contributors" class="link">Hugo Authors</a><br />

-         </div>

-          <div class="w4 center">

-            {{ partialCached "svg/hugo-logo-wide.svg" (dict "size" "100") }}

           </div>

-          <p class="f6 gray tc w-70 center">The Hugo logos are copyright © Steve Francia 2013–{{ now.Year }}.</p>

-          <p class="f6 gray tc w-70 center">The Hugo Gopher is based on an original work by Renée French.</p>

+          <div class="center w4">

+            {{ partialCached "svg/hugo-logo-wide.svg" . }}

+          </div>

+          <ul class="center f6 list ma0 mv3 pa0 tc">

+            {{- with .Site.Params.github_repo -}}<li class="dib mr3"><a href="{{ . }}" class="dim link light-gray pv2">File an Issue</a></li>{{- end -}}

+            {{- with .Site.Params.forum -}}<li class="dib mr3"><a href="{{ . }}" class="dim link light-gray pv2">Get Help</a></li>{{- end -}}

+            {{- with .Site.Params.gitter -}}<li class="dib"><a href="{{ . }}" class="dim link light-gray pv2">Discuss Source Code</a></li>{{- end -}}

+          </ul>

+          <ul class="center f6 list ma0 mv4 pa0 tc">

+            <li class="dib mr3"><a href="https://twitter.com/gohugoio" class="dim link light-gray pv2">@GoHugoIO</a></li>

+            <li class="dib mr3"><a href="https://twitter.com/spf13" class="dim link light-gray pv2">@spf13</a></li>

+            <li class="dib"><a href="https://twitter.com/bepsays" class="dim link light-gray pv2">@bepsays</a></li>

+          </ul>

           {{ with  getenv "REPOSITORY_URL" -}}

-          <p class="f6 tc w-70 center"><a href="https://www.netlify.com"><img src="https://www.netlify.com/img/global/badges/netlify-dark.svg"/></a></p>

+          <p class="center f6 tc w-70"><a href="https://www.netlify.com"><img src="https://www.netlify.com/img/global/badges/netlify-dark.svg"/></a></p>

           {{- end }}

-      </div>

-      <div class="w-third pv3 dn db-l">

-        <ul class="list ma0 pa0 w-50 center">

-          {{- with .Site.Params.github_repo -}}<li><a href="{{ . }}" class="link white dim pv2 db">File an Issue</a></li>{{- end -}}

-          {{- with .Site.Params.forum -}}<li><a href="{{ . }}" class="link white dim pv2 db">Get Help</a></li>{{- end -}}

-          {{- with .Site.Params.gitter -}}<li><a href="{{ . }}" class="link white dim pv2 db">Discuss the Source Code</a></li>{{- end -}}

-        </ul>

       </div>

-      <div class="w-third pv3 dn db-l">

-        <ul class="list ma0 pa0">

-          <li><a href="https://twitter.com/gohugoio" class="link white dim pv2 db">@GoHugoIO</a></li>

-          <li><a href="https://twitter.com/spf13" class="link white dim pv2 db">@spf13</a></li>

-          <li><a href="https://twitter.com/bepsays" class="link white dim pv2 db">@bepsays</a></li>

-        </ul>

+      <div class="w-100 w-50-l">

+        {{ partial "home-page-sections/sponsors.html" (dict "cx" . "classes_section" "pb3 w-100" "classes_copy" "f7 w-90-ns") }}

       </div>

     </div>

+    <div class="f7 gray mb5 mb0-ns ph3 w-100">

+      <p class="dib mr4">The Hugo logos are copyright © Steve Francia 2013–{{ now.Year }}.</p>

+      <p class="dib">The Hugo Gopher is based on an original work by Renée French.</p>

+    </div>

-    {{ partial "nav-mobile.html" . }}

+    <img src="/images/gopher-side_color.svg" class="absolute-l bottom-0 dn db-l h4 right-0 z-999"/>

+    <div class="bg-primary-color-dark bottom-0 dn-ns fixed pb3 ph3 w-100">

+      {{ partial "nav-mobile.html" . }}

+    </div>

 </footer>

--- a/themes/gohugoioTheme/layouts/partials/svg/gopher-side_color.svg

+++ /dev/null

@@ -1,31 +1,0 @@

-<?xml version="1.0" encoding="utf-8"?>

-<!-- Generator: Adobe Illustrator 18.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->

-<svg version="1.1" id="レイヤー_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px"

-	 y="0px" viewBox="0 0 397.8 535.6" enable-background="new 0 0 397.8 535.6" xml:space="preserve">

-<g>

-	<path fill="#E0DEDC" d="M68.5,64c0,0-45.3-8-56.4,40.2c-11.7,50.6,27,46.7,27,46.7L68.5,64z"/>

-	<g>

-		<path fill="#040000" stroke="#040000" stroke-width="1.3483" stroke-miterlimit="10" d="M23.9,86.2c-8.5-0.3-15.5,25.8-13.1,35.2

-			c0.9,3.5,10,6.3,14-3.7C27.7,110.4,34.5,86.5,23.9,86.2z"/>

-		<path fill="#FFFFFF" d="M17.6,94c-1.9-0.6-4,4.5-4.7,6.3c-1.8,5.3,2.1,5.1,4.4,2C18.5,100.7,19.5,94.7,17.6,94z"/>

-	</g>

-	<path fill="#B8937F" d="M46.3,487.8c5.2,7.3,41.6,6.4,46.1-1.3c4.2-7.1-21.4-14.9-30.7-16.1C47.6,468.6,42.6,482.5,46.3,487.8z"/>

-	<path fill="#B8937F" d="M351,446c5.2,7.3,29.4,3.7,34-4c4.2-7.1-9.3-12.2-18.6-13.4C352.3,426.8,347.3,440.7,351,446z"/>

-	<path fill="#8CC5E7" d="M189.6,13.4c0,0-182.1-8.9-161,217.6c6.3,68-43.8,182.8,29.2,239.8c0,0,102.1,61.7,238.9,41.5

-		c20-3,45.5-10,63.2-57.1c22.3-59.5,6.6-121.5-13.2-165.5c-22.3-49.7-21.2-105.8-19.6-115.3C354.3,14.2,189.6,13.4,189.6,13.4z"/>

-	<path fill="#8CC5E7" d="M282.3,38.8c19.2-5,32.6-10.5,43.4-5c30.5,15.7-4.9,45.4-12.4,51C302.3,93.2,268.4,42.4,282.3,38.8z"/>

-	<path fill="#3C89BF" d="M306,40.5c-18.8,4.2-19.6,13.7-14.8,16.4c2.8,1.6,0.8-8.1,13.6-3.8c5.2,1.7-2.5,14.3,12.1,0.2

-		C324.7,45.6,310.1,39.6,306,40.5z"/>

-	<path fill="#E0DEDC" d="M137.9,29.2c-22.9,1.7-76.1,28.5-50,94.2c9.1,23,104.6,10.3,105.8-54C194.1,42.6,158.1,27.7,137.9,29.2z"/>

-	<path fill="#040000" stroke="#040000" stroke-width="1.3483" stroke-miterlimit="10" d="M109.9,51.8C88.5,53.7,83.3,84,91.3,91.1

-		c4.5,4,20.1,8.6,28.5-19C122.5,63.3,117.8,51,109.9,51.8z"/>

-	<path fill="#FFFFFF" d="M101.7,57.4c-3.1-0.9-8.8,7-7.1,10.3c0.6,1.2,3.2,2.9,5.3,1.3C102.2,67.2,107.8,59.1,101.7,57.4z"/>

-	<path fill="#B8937F" d="M74.6,130.1C34.9,122.3,30,165,43.9,172.3c10.1,5.4,38.8-3.5,43.6-13.4C92.2,148.9,95,134.1,74.6,130.1z"/>

-	<path fill="#040000" d="M48,126.4c-12.5,4.3-11.8,25.4-5.1,26c7.6,0.7,21-14.7,24.2-20.9C69.5,126.9,53,124.7,48,126.4z"/>

-	<path fill="#E0DEDC" d="M52.5,169.9c-3.2,1.4-2.9,18.8,3.3,21.5c19.6,8.3,20.9-20.4,17.1-24.9C70,162.9,54.7,168.9,52.5,169.9z"/>

-	<path fill="#B8937F" d="M272,269.2c-11.2,0.5-19.7,23.3-16.9,34.3c1.5,5.9,12.9,5,11.3,9.6c-2.7,7.6,17.4,12.9,21.2,4.7

-		C306.9,277,282.3,268.8,272,269.2z"/>

-	<path fill="#B8937F" d="M251.8,497.4c-39.7-4.3-51.7,14.7-44.4,21.8c7.7,7.5,38.1,5.3,54.7,3.9

-		C268.7,522.6,261.8,498.5,251.8,497.4z"/>

-</g>

-</svg>

--- a/themes/gohugoioTheme/src/css/_chroma.css

+++ b/themes/gohugoioTheme/src/css/_chroma.css

@@ -1,43 +1,67 @@

 /* Background */ .chroma { background-color: #f0f0f0 }

-/* Error */ .chroma .ss4 {  }

+/* Error */ .chroma .err {  }

+/* LineTableTD */ .chroma .lntd { ; vertical-align: top; padding: 0; margin: 0; border: 0; }

+/* LineTable */ .chroma .lntable { ; border-spacing: 0; padding: 0; margin: 0; border: 0; width: 100%; overflow: auto; display: block; }

 /* LineHighlight */ .chroma .hl { background-color: #ffffcc; display: block; width: 100% }

+/* LineNumbersTable */ .chroma .lnt { ; margin-right: 0.4em; padding: 0 0.4em 0 0.4em; display: block; }

 /* LineNumbers */ .chroma .ln { ; margin-right: 0.4em; padding: 0 0.4em 0 0.4em; }

-/* Keyword */ .chroma .s3e8 { color: #007020; font-weight: bold }

-/* KeywordPseudo */ .chroma .s3ec { color: #007020 }

-/* KeywordType */ .chroma .s3ee { color: #902000 }

-/* NameAttribute */ .chroma .s7d1 { color: #4070a0 }

-/* NameBuiltin */ .chroma .s7d2 { color: #007020 }

-/* NameClass */ .chroma .s7d4 { color: #0e84b5; font-weight: bold }

-/* NameConstant */ .chroma .s7d5 { color: #60add5 }

-/* NameDecorator */ .chroma .s7d6 { color: #555555; font-weight: bold }

-/* NameEntity */ .chroma .s7d7 { color: #d55537; font-weight: bold }

-/* NameException */ .chroma .s7d8 { color: #007020 }

-/* NameFunction */ .chroma .s7d9 { color: #06287e }

-/* NameLabel */ .chroma .s7dc { color: #002070; font-weight: bold }

-/* NameNamespace */ .chroma .s7dd { color: #0e84b5; font-weight: bold }

-/* NameTag */ .chroma .s7e2 { color: #062873; font-weight: bold }

-/* NameVariable */ .chroma .s7e3 { color: #bb60d5 }

-/* LiteralString */ .chroma .sc1c { color: #4070a0 }

-/* LiteralStringDoc */ .chroma .sc23 { color: #4070a0; font-style: italic }

-/* LiteralStringEscape */ .chroma .sc25 { color: #4070a0; font-weight: bold }

-/* LiteralStringInterpol */ .chroma .sc27 { color: #70a0d0; font-style: italic }

-/* LiteralStringOther */ .chroma .sc29 { color: #c65d09 }

-/* LiteralStringRegex */ .chroma .sc2a { color: #235388 }

-/* LiteralStringSymbol */ .chroma .sc2c { color: #517918 }

-/* LiteralNumber */ .chroma .sc80 { color: #40a070 }

-/* Operator */ .chroma .sfa0 { color: #666666 }

-/* OperatorWord */ .chroma .sfa1 { color: #007020; font-weight: bold }

-/* Comment */ .chroma .s1770 { color: #60a0b0; font-style: italic }

-/* CommentSpecial */ .chroma .s1774 { color: #60a0b0; background-color: #fff0f0 }

-/* CommentPreproc */ .chroma .s17d4 { color: #007020 }

-/* GenericDeleted */ .chroma .s1b59 { color: #a00000 }

-/* GenericEmph */ .chroma .s1b5a { font-style: italic }

-/* GenericError */ .chroma .s1b5b { color: #ff0000 }

-/* GenericHeading */ .chroma .s1b5c { color: #000080; font-weight: bold }

-/* GenericInserted */ .chroma .s1b5d { color: #00a000 }

-/* GenericOutput */ .chroma .s1b5e { color: #888888 }

-/* GenericPrompt */ .chroma .s1b5f { color: #c65d09; font-weight: bold }

-/* GenericStrong */ .chroma .s1b60 { font-weight: bold }

-/* GenericSubheading */ .chroma .s1b61 { color: #800080; font-weight: bold }

-/* GenericTraceback */ .chroma .s1b62 { color: #0044dd }

-/* TextWhitespace */ .chroma .s1f41 { color: #bbbbbb }

+/* Keyword */ .chroma .k { color: #007020; font-weight: bold }

+/* KeywordConstant */ .chroma .kc { color: #007020; font-weight: bold }

+/* KeywordDeclaration */ .chroma .kd { color: #007020; font-weight: bold }

+/* KeywordNamespace */ .chroma .kn { color: #007020; font-weight: bold }

+/* KeywordPseudo */ .chroma .kp { color: #007020 }

+/* KeywordReserved */ .chroma .kr { color: #007020; font-weight: bold }

+/* KeywordType */ .chroma .kt { color: #902000 }

+/* NameAttribute */ .chroma .na { color: #4070a0 }

+/* NameBuiltin */ .chroma .nb { color: #007020 }

+/* NameClass */ .chroma .nc { color: #0e84b5; font-weight: bold }

+/* NameConstant */ .chroma .no { color: #60add5 }

+/* NameDecorator */ .chroma .nd { color: #555555; font-weight: bold }

+/* NameEntity */ .chroma .ni { color: #d55537; font-weight: bold }

+/* NameException */ .chroma .ne { color: #007020 }

+/* NameFunction */ .chroma .nf { color: #06287e }

+/* NameLabel */ .chroma .nl { color: #002070; font-weight: bold }

+/* NameNamespace */ .chroma .nn { color: #0e84b5; font-weight: bold }

+/* NameTag */ .chroma .nt { color: #062873; font-weight: bold }

+/* NameVariable */ .chroma .nv { color: #bb60d5 }

+/* LiteralString */ .chroma .s { color: #4070a0 }

+/* LiteralStringAffix */ .chroma .sa { color: #4070a0 }

+/* LiteralStringBacktick */ .chroma .sb { color: #4070a0 }

+/* LiteralStringChar */ .chroma .sc { color: #4070a0 }

+/* LiteralStringDelimiter */ .chroma .dl { color: #4070a0 }

+/* LiteralStringDoc */ .chroma .sd { color: #4070a0; font-style: italic }

+/* LiteralStringDouble */ .chroma .s2 { color: #4070a0 }

+/* LiteralStringEscape */ .chroma .se { color: #4070a0; font-weight: bold }

+/* LiteralStringHeredoc */ .chroma .sh { color: #4070a0 }

+/* LiteralStringInterpol */ .chroma .si { color: #70a0d0; font-style: italic }

+/* LiteralStringOther */ .chroma .sx { color: #c65d09 }

+/* LiteralStringRegex */ .chroma .sr { color: #235388 }

+/* LiteralStringSingle */ .chroma .s1 { color: #4070a0 }

+/* LiteralStringSymbol */ .chroma .ss { color: #517918 }

+/* LiteralNumber */ .chroma .m { color: #40a070 }

+/* LiteralNumberBin */ .chroma .mb { color: #40a070 }

+/* LiteralNumberFloat */ .chroma .mf { color: #40a070 }

+/* LiteralNumberHex */ .chroma .mh { color: #40a070 }

+/* LiteralNumberInteger */ .chroma .mi { color: #40a070 }

+/* LiteralNumberIntegerLong */ .chroma .il { color: #40a070 }

+/* LiteralNumberOct */ .chroma .mo { color: #40a070 }

+/* Operator */ .chroma .o { color: #666666 }

+/* OperatorWord */ .chroma .ow { color: #007020; font-weight: bold }

+/* Comment */ .chroma .c { color: #60a0b0; font-style: italic }

+/* CommentHashbang */ .chroma .ch { color: #60a0b0; font-style: italic }

+/* CommentMultiline */ .chroma .cm { color: #60a0b0; font-style: italic }

+/* CommentSingle */ .chroma .c1 { color: #60a0b0; font-style: italic }

+/* CommentSpecial */ .chroma .cs { color: #60a0b0; background-color: #fff0f0 }

+/* CommentPreproc */ .chroma .cp { color: #007020 }

+/* CommentPreprocFile */ .chroma .cpf { color: #007020 }

+/* GenericDeleted */ .chroma .gd { color: #a00000 }

+/* GenericEmph */ .chroma .ge { font-style: italic }

+/* GenericError */ .chroma .gr { color: #ff0000 }

+/* GenericHeading */ .chroma .gh { color: #000080; font-weight: bold }

+/* GenericInserted */ .chroma .gi { color: #00a000 }

+/* GenericOutput */ .chroma .go { color: #888888 }

+/* GenericPrompt */ .chroma .gp { color: #c65d09; font-weight: bold }

+/* GenericStrong */ .chroma .gs { font-weight: bold }

+/* GenericSubheading */ .chroma .gu { color: #800080; font-weight: bold }

+/* GenericTraceback */ .chroma .gt { color: #0044dd }

+/* TextWhitespace */ .chroma .w { color: #bbbbbb }

--- a/themes/gohugoioTheme/src/css/_chroma2.css

+++ /dev/null

@@ -1,67 +1,0 @@

-/* Background */ .chroma { background-color: #f0f0f0 }

-/* Error */ .chroma .err {  }

-/* LineTableTD */ .chroma .lntd { ; vertical-align: top; padding: 0; margin: 0; border: 0; }

-/* LineTable */ .chroma .lntable { ; border-spacing: 0; padding: 0; margin: 0; border: 0; width: 100%; overflow: auto; display: block; }

-/* LineHighlight */ .chroma .hl { background-color: #ffffcc; display: block; width: 100% }

-/* LineNumbersTable */ .chroma .lnt { ; margin-right: 0.4em; padding: 0 0.4em 0 0.4em; display: block; }

-/* LineNumbers */ .chroma .ln { ; margin-right: 0.4em; padding: 0 0.4em 0 0.4em; }

-/* Keyword */ .chroma .k { color: #007020; font-weight: bold }

-/* KeywordConstant */ .chroma .kc { color: #007020; font-weight: bold }

-/* KeywordDeclaration */ .chroma .kd { color: #007020; font-weight: bold }

-/* KeywordNamespace */ .chroma .kn { color: #007020; font-weight: bold }

-/* KeywordPseudo */ .chroma .kp { color: #007020 }

-/* KeywordReserved */ .chroma .kr { color: #007020; font-weight: bold }

-/* KeywordType */ .chroma .kt { color: #902000 }

-/* NameAttribute */ .chroma .na { color: #4070a0 }

-/* NameBuiltin */ .chroma .nb { color: #007020 }

-/* NameClass */ .chroma .nc { color: #0e84b5; font-weight: bold }

-/* NameConstant */ .chroma .no { color: #60add5 }

-/* NameDecorator */ .chroma .nd { color: #555555; font-weight: bold }

-/* NameEntity */ .chroma .ni { color: #d55537; font-weight: bold }

-/* NameException */ .chroma .ne { color: #007020 }

-/* NameFunction */ .chroma .nf { color: #06287e }

-/* NameLabel */ .chroma .nl { color: #002070; font-weight: bold }

-/* NameNamespace */ .chroma .nn { color: #0e84b5; font-weight: bold }

-/* NameTag */ .chroma .nt { color: #062873; font-weight: bold }

-/* NameVariable */ .chroma .nv { color: #bb60d5 }

-/* LiteralString */ .chroma .s { color: #4070a0 }

-/* LiteralStringAffix */ .chroma .sa { color: #4070a0 }

-/* LiteralStringBacktick */ .chroma .sb { color: #4070a0 }

-/* LiteralStringChar */ .chroma .sc { color: #4070a0 }

-/* LiteralStringDelimiter */ .chroma .dl { color: #4070a0 }

-/* LiteralStringDoc */ .chroma .sd { color: #4070a0; font-style: italic }

-/* LiteralStringDouble */ .chroma .s2 { color: #4070a0 }

-/* LiteralStringEscape */ .chroma .se { color: #4070a0; font-weight: bold }

-/* LiteralStringHeredoc */ .chroma .sh { color: #4070a0 }

-/* LiteralStringInterpol */ .chroma .si { color: #70a0d0; font-style: italic }

-/* LiteralStringOther */ .chroma .sx { color: #c65d09 }

-/* LiteralStringRegex */ .chroma .sr { color: #235388 }

-/* LiteralStringSingle */ .chroma .s1 { color: #4070a0 }

-/* LiteralStringSymbol */ .chroma .ss { color: #517918 }

-/* LiteralNumber */ .chroma .m { color: #40a070 }

-/* LiteralNumberBin */ .chroma .mb { color: #40a070 }

-/* LiteralNumberFloat */ .chroma .mf { color: #40a070 }

-/* LiteralNumberHex */ .chroma .mh { color: #40a070 }

-/* LiteralNumberInteger */ .chroma .mi { color: #40a070 }

-/* LiteralNumberIntegerLong */ .chroma .il { color: #40a070 }

-/* LiteralNumberOct */ .chroma .mo { color: #40a070 }

-/* Operator */ .chroma .o { color: #666666 }

-/* OperatorWord */ .chroma .ow { color: #007020; font-weight: bold }

-/* Comment */ .chroma .c { color: #60a0b0; font-style: italic }

-/* CommentHashbang */ .chroma .ch { color: #60a0b0; font-style: italic }

-/* CommentMultiline */ .chroma .cm { color: #60a0b0; font-style: italic }

-/* CommentSingle */ .chroma .c1 { color: #60a0b0; font-style: italic }

-/* CommentSpecial */ .chroma .cs { color: #60a0b0; background-color: #fff0f0 }

-/* CommentPreproc */ .chroma .cp { color: #007020 }

-/* CommentPreprocFile */ .chroma .cpf { color: #007020 }

-/* GenericDeleted */ .chroma .gd { color: #a00000 }

-/* GenericEmph */ .chroma .ge { font-style: italic }

-/* GenericError */ .chroma .gr { color: #ff0000 }

-/* GenericHeading */ .chroma .gh { color: #000080; font-weight: bold }

-/* GenericInserted */ .chroma .gi { color: #00a000 }

-/* GenericOutput */ .chroma .go { color: #888888 }

-/* GenericPrompt */ .chroma .gp { color: #c65d09; font-weight: bold }

-/* GenericStrong */ .chroma .gs { font-weight: bold }

-/* GenericSubheading */ .chroma .gu { color: #800080; font-weight: bold }

-/* GenericTraceback */ .chroma .gt { color: #0044dd }

-/* TextWhitespace */ .chroma .w { color: #bbbbbb }

--- a/themes/gohugoioTheme/src/css/main.css

+++ b/themes/gohugoioTheme/src/css/main.css

@@ -26,7 +26,6 @@

 @import '_svg';

 @import '_chroma';

-@import '_chroma2';

 @import '_variables';

 .nested-blockquote blockquote {

--- a/themes/gohugoioTheme/src/readme.md

+++ b/themes/gohugoioTheme/src/readme.md

@@ -24,12 +24,12 @@

 You'll find the commands to run in `src/package.json`.

-For development, you'll need Node and Yarn installed:

+For development, you'll need Node with NPM installed:

```

 $ cd themes/gohugo-theme/src/

-$ yarn install

+$ npm install

 $ npm start

@@ -37,13 +37,3 @@

 This will process both the postcss and scripts.

 For production, instead of `npm start`, run `npm run build:production,` which will output minified versions of your files.

----

-To run the NPM "critical" from package.json, you first must run `hugo` from the root of the project to generate a `public` folder.

-Make critical better:

-- [ ] run for a wider variety of pages. It currently runs off the new Hugo home page, but should run for docs/themes. There's much shared between them though.

-- [ ] Minify the CSS. The critical script seems only to minify when running inline, which we don't want to do (because it would change the build process)

--- /dev/null

+++ b/themes/gohugoioTheme/static/images/sponsors/forestry-logotype.svg

@@ -1,0 +1,1 @@

+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 296.5 76"><style>.st0{fill:none;}</style><path class="st0" d="M198 53.5c.3-.3.4-.8.4-1.4 0-.5-.1-.9-.3-1.3-.2-.3-.5-.6-.8-.7-.3-.2-.7-.3-1.1-.3-.4-.1-.8-.1-1.3-.1h-2.5v4.9h3.1c.5 0 1-.1 1.4-.3.4-.3.8-.5 1.1-.8zM29.5 34.7l-5-9.6c-.5-1-1.9-1-2.4 0L15 38.7c-.5.9.2 2 1.2 2H22v2.1c0 .5.4.9.9.9h.9c.5 0 .9-.4.9-.9v-2.1h1.7l3.1-6zM184.4 51c-.5-.6-1.1-1-1.8-1.3-.7-.3-1.5-.5-2.4-.5-.9 0-1.6.2-2.4.5-.7.3-1.3.8-1.8 1.3-.5.6-.9 1.2-1.2 1.9-.3.7-.4 1.5-.4 2.4s.1 1.6.4 2.4c.3.7.7 1.4 1.2 1.9.5.6 1.1 1 1.8 1.3.7.3 1.5.5 2.4.5.9 0 1.6-.2 2.4-.5.7-.3 1.3-.8 1.8-1.3s.9-1.2 1.2-1.9c.3-.7.4-1.5.4-2.4s-.1-1.6-.4-2.4c-.3-.6-.7-1.3-1.2-1.9zM121.4 31.6c4.2 0 6.4-2.8 6.4-8.4 0-5.6-2.1-8.5-6.3-8.5-2.1 0-3.7.7-4.8 2.1-1.1 1.4-1.6 3.5-1.6 6.3s.5 4.9 1.6 6.3c1 1.5 2.6 2.2 4.7 2.2zM151.3 15.8c-.8-.5-2.1-.8-3.8-.8h-1.6v6.8h1.7c1.7 0 2.9-.3 3.7-.8.8-.6 1.2-1.4 1.2-2.6.1-1.2-.4-2.1-1.2-2.6zM96 50.3l-3.1 7.2H99l-3-7.2zM242.1 15.8c-.8-.5-2.1-.8-3.8-.8h-1.6v6.8h1.7c1.7 0 2.9-.3 3.7-.8.8-.6 1.2-1.4 1.2-2.6.1-1.2-.3-2.1-1.2-2.6zM39.5 24.9c-.3-.5-.7-.7-1.2-.7s-.9.2-1.2.7L26.2 45.7c-.5.9.2 2 1.2 2h8.9V51c0 .5.4.9.9.9h2.3c.5 0 .9-.4.9-.9v-3.3h8.9c1 0 1.7-1.1 1.2-2l-11-20.8zM291.4 15.3c-.8 0-1.3.3-1.7.8-.3.5-.5 1.2-.5 2.2 0 2 .7 3 2.2 3 1.5 0 2.2-1 2.2-3s-.7-3-2.2-3zM266 51c-.5-.6-1.1-1-1.8-1.3-.7-.3-1.5-.5-2.4-.5-.9 0-1.6.2-2.4.5-.7.3-1.3.8-1.8 1.3-.5.6-.9 1.2-1.2 1.9-.3.7-.4 1.5-.4 2.4s.1 1.6.4 2.4c.3.7.7 1.4 1.2 1.9.5.6 1.1 1 1.8 1.3.7.3 1.5.5 2.4.5.9 0 1.6-.2 2.4-.5.7-.3 1.3-.8 1.8-1.3s.9-1.2 1.2-1.9c.3-.7.4-1.5.4-2.4s-.1-1.6-.4-2.4c-.3-.6-.7-1.3-1.2-1.9z"/><path d="M89.3 35.8h5.2v-9.9h8.5v-4.4h-8.5v-6.4h9.1v-4.4H89.3zM121.4 36.1c3.8 0 6.8-1.1 8.8-3.3 2.1-2.2 3.1-5.4 3.1-9.6 0-4.2-1-7.3-3.1-9.6-2-2.2-5-3.3-8.8-3.3s-6.8 1.1-8.9 3.3c-2.1 2.2-3.1 5.4-3.1 9.5s1 7.4 3.1 9.6c2.1 2.3 5.1 3.4 8.9 3.4zm-4.7-19.2c1.1-1.4 2.7-2.1 4.8-2.1 4.2 0 6.3 2.8 6.3 8.5 0 5.6-2.1 8.4-6.4 8.4-2.1 0-3.7-.7-4.8-2.1-1.1-1.4-1.6-3.5-1.6-6.3s.6-5 1.7-6.4zM156.7 22.2c.8-1.1 1.2-2.5 1.2-3.9 0-2.5-.8-4.4-2.4-5.6s-4.1-1.9-7.5-1.9h-7.3v25h5.3v-9.6h2.8l6 9.6h5.9c-1.1-1.6-3.6-5.3-7.4-10.9 1.4-.7 2.6-1.6 3.4-2.7zm-5.3-1.2c-.8.6-2 .8-3.7.8H146V15h1.6c1.7 0 3 .3 3.8.8.8.5 1.2 1.3 1.2 2.5 0 1.3-.4 2.1-1.2 2.7zM180.3 31.4h-9.1v-5.5h8.5v-4.4h-8.5v-6.4h9.1v-4.4h-14.4v25.1h14.4zM196.3 21.3c-1.8-.8-2.9-1.4-3.4-1.8-.5-.3-.8-.7-1-1-.2-.3-.3-.8-.3-1.2 0-.8.3-1.4.8-1.8.5-.5 1.3-.7 2.3-.7.8 0 1.7.1 2.6.3.9.2 2 .6 3.3 1.1l1.7-4.1c-1.3-.6-2.5-1-3.7-1.3-1.2-.3-2.4-.5-3.7-.5-2.6 0-4.7.6-6.2 1.9-1.5 1.3-2.3 3-2.3 5.2 0 1.2.2 2.2.7 3.1s1.1 1.6 1.8 2.3c.8.7 1.9 1.4 3.4 2.1 1.6.8 2.7 1.3 3.2 1.7.5.4.9.7 1.2 1.1.3.4.4.8.4 1.3 0 .9-.3 1.5-.9 2-.6.4-1.5.7-2.7.7-1 0-2-.2-3.2-.5-1.2-.3-2.6-.8-4.3-1.6v4.9c2.1 1 4.4 1.5 7.1 1.5 2.9 0 5.2-.7 6.8-2 1.6-1.3 2.4-3.1 2.4-5.3 0-1.6-.4-3-1.3-4.1-.8-1.1-2.4-2.2-4.7-3.3zM213.4 35.8h5.3V15.1h6.8v-4.4h-18.9v4.4h6.8zM247.5 22.2c.8-1.1 1.2-2.5 1.2-3.9 0-2.5-.8-4.4-2.4-5.6-1.6-1.2-4.1-1.9-7.5-1.9h-7.3v25h5.3v-9.6h2.8l6 9.6h5.9c-1.1-1.6-3.6-5.3-7.4-10.9 1.4-.7 2.6-1.6 3.4-2.7zm-5.3-1.2c-.8.6-2 .8-3.7.8h-1.7V15h1.6c1.7 0 3 .3 3.8.8.8.5 1.2 1.3 1.2 2.5 0 1.3-.4 2.1-1.2 2.7zM264.5 21l-5.2-10.3h-5.8l8.3 15.5v9.6h5.3V26l8.3-15.3h-5.7zM282.4 14h1.8v8.7h-1.8zM283.3 10.6c-.3 0-.6.1-.8.3-.2.2-.3.4-.3.8 0 .3.1.6.3.7s.4.3.8.3c.3 0 .6-.1.8-.3s.3-.4.3-.7c0-.3-.1-.6-.3-.8-.2-.2-.5-.3-.8-.3zM294.4 15c-.7-.8-1.7-1.2-3-1.2s-2.3.4-3 1.2c-.7.8-1.1 1.9-1.1 3.3 0 .9.2 1.7.5 2.4s.8 1.2 1.4 1.6c.6.4 1.3.5 2.1.5 1.3 0 2.3-.4 3-1.2.7-.8 1.1-1.9 1.1-3.3.1-1.4-.3-2.5-1-3.3zm-3 6.3c-1.5 0-2.2-1-2.2-3 0-1 .2-1.7.5-2.2.3-.5.9-.8 1.7-.8 1.5 0 2.2 1 2.2 3s-.7 3-2.2 3zM62.9 18L34.4 1.5c-1.1-.6-2.5-.6-3.6 0L2.3 18c-1.1.6-1.8 1.8-1.8 3.1v33c0 1.3.7 2.5 1.8 3.1l28.5 16.5c1.1.6 2.5.6 3.6 0l28.5-16.5c1.1-.6 1.8-1.8 1.8-3.1v-33c0-1.3-.7-2.5-1.8-3.1zM24.6 42.7c0 .5-.4.9-.9.9h-.9c-.5 0-.9-.4-.9-.9v-2.1h-5.8c-1 0-1.7-1.1-1.2-2L22 25c.5-1 1.9-1 2.4 0l5 9.6-3.1 6h-1.7v2.1zm24.6 5h-8.9V51c0 .5-.4.9-.9.9h-2.3c-.5 0-.9-.4-.9-.9v-3.3h-8.9c-1 0-1.7-1.1-1.2-2L37 24.9c.3-.5.7-.7 1.2-.7s.9.2 1.2.7l10.9 20.8c.5.9-.1 2-1.1 2zM95.3 48l-6.5 14.7h2l1.5-3.6h7.4l1.5 3.6h2L96.9 4

\ No newline at end of file