From 92bd0b1f5c0e163c05271f921bef67260fc4a071 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Fri, 7 Feb 2020 01:15:37 +0100 Subject: [PATCH 1/7] Update errorf.md --- content/en/functions/errorf.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/en/functions/errorf.md b/content/en/functions/errorf.md index 9cd7e69b6..450e92679 100644 --- a/content/en/functions/errorf.md +++ b/content/en/functions/errorf.md @@ -14,7 +14,6 @@ workson: [] hugoversion: relatedfuncs: [printf] deprecated: false -aliases: [/functions/errorf] --- `errorf` or `warnf` will evaluate a format string, then output the result to the ERROR or WARNING log (and only once per error message to avoid flooding the log). From af33bb7245d0992febbae0d3c11082563988aeef Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Sun, 9 Feb 2020 22:00:46 +0100 Subject: [PATCH 2/7] netlify: Bump version --- netlify.toml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/netlify.toml b/netlify.toml index 0a9bf7dcf..7b9b92285 100644 --- a/netlify.toml +++ b/netlify.toml @@ -3,7 +3,7 @@ publish = "public" command = "hugo --gc --minify" [context.production.environment] -HUGO_VERSION = "0.64.0" +HUGO_VERSION = "0.64.1" HUGO_ENV = "production" HUGO_ENABLEGITINFO = "true" @@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true" command = "hugo --gc --minify --enableGitInfo" [context.split1.environment] -HUGO_VERSION = "0.64.0" +HUGO_VERSION = "0.64.1" HUGO_ENV = "production" [context.deploy-preview] command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL" [context.deploy-preview.environment] -HUGO_VERSION = "0.64.0" +HUGO_VERSION = "0.64.1" [context.branch-deploy] command = "hugo --gc --minify -b $DEPLOY_PRIME_URL" [context.branch-deploy.environment] -HUGO_VERSION = "0.64.0" +HUGO_VERSION = "0.64.1" [context.next.environment] HUGO_ENABLEGITINFO = "true" From a9d0e7c6812b490b3ce2a7e8125b399a453e6311 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Wed, 12 Feb 2020 16:40:16 +0100 Subject: [PATCH 3/7] Revise the wildly inaccurate types doc --- content/en/content-management/types.md | 85 ++------------------------ 1 file changed, 5 insertions(+), 80 deletions(-) diff --git a/content/en/content-management/types.md b/content/en/content-management/types.md index 4ac1ce04a..6be16b408 100644 --- a/content/en/content-management/types.md +++ b/content/en/content-management/types.md @@ -1,10 +1,7 @@ --- title: Content Types -linktitle: Types -description: Hugo supports sites with multiple content types and assumes your site will be organized into sections, where each section represents the corresponding type. +description: Hugo is built around content organized in sections. date: 2017-02-01 -publishdate: 2017-02-01 -lastmod: 2017-02-01 categories: [content management] keywords: [lists,sections,content types,types,organization] menu: @@ -17,83 +14,11 @@ aliases: [/content/types] toc: true --- -A **content type** can have a unique set of metadata (i.e., [front matter][]) or customized [template][] and can be created by the `hugo new` command via [archetypes][]. +A **content type** is a way to organize your content. Hugo resolves the content type from either the `type` in front matter or, if not set, the first directory in the file path. E.g. `content/blog/my-first-event.md` will be of type `blog` if no `type` set. -## What is a Content Type +A content type is used to -[Tumblr][] is a good example of a website with multiple content types. A piece of "content" could be a photo, quote, or a post, each with different sets of metadata and different visual rendering. - -## Assign a Content Type - -Hugo assumes that your site will be organized into [sections][] and each section represents a corresponding type. This is to reduce the amount of configuration necessary for new Hugo projects. - -If you are taking advantage of this default behavior, each new piece of content you place into a section will automatically inherit the type. Therefore a new file created at `content/posts/new-post.md` will automatically be assigned the type `posts`. Alternatively, you can set the content type in a content file's [front matter][] in the field "`type`". - -## Create New Content of a Specific Type - -You can manually add files to your content directories, but Hugo can create and populate a new content file with preconfigured front matter via [archetypes][]. - -## Define a Content Type - -Creating a new content type is easy. You simply define the templates and archetype unique to your new content type, or Hugo will use defaults. +* Determine how the content is rendered. See [Template Lookup Order](/templates/lookup-order/) and [Content Views](https://gohugo.io/templates/views) for more. +* Determine which [archetype](/content-management/archetypes/) template to use for new content. -{{% note "Declaring Content Types" %}} -Remember, all of the following are *optional*. If you do not specifically declare content types in your front matter or develop specific layouts for content types, Hugo is smart enough to assume the content type from the file path and section. (See [Content Sections](/content-management/sections/) for more information.) -{{% /note %}} - -The following examples take you stepwise through creating a new type layout for a content file that contains the following front matter: - -{{< code file="content/events/my-first-event.md" copy="false" >}} -+++ -title = My First Event -date = "2016-06-24T19:20:04-07:00" -description = "Today is my 36th birthday. How time flies." -type = "event" -layout = "birthday" -+++ -{{< /code >}} - -By default, Hugo assumes `*.md` under `events` is of the `events` content type. However, we have specified that this particular file at `content/events/my-first-event.md` is of type `event` and should render using the `birthday` layout. - -### Create a Type Layout Directory - -Create a directory with the name of the type in `/layouts`. For creating these custom layouts, **type is always singular**; e.g., `events => event` and `posts => post`. - -For this example, you need to create `layouts/event/birthday.html`. - -{{% note %}} -If you have multiple content files in your `events` directory that are of the `special` type and you don't want to define the `layout` specifically for each piece of content, you can create a layout at `layouts/special/single.html` to observe the [single page template lookup order](/templates/single-page-templates/). -{{% /note %}} - -{{% warning %}} -With the "everything is a page" data model introduced in v0.18 (see [Content Organization](/content-management/organization/)), you can use `_index.md` in content directories to add both content and front matter to [list pages](/templates/lists/). -{{% /warning %}} - -### Create Views - -Many sites support rendering content in a few different ways; e.g., a single page view and a summary view to be used when displaying a [list of section contents][sectiontemplates]. - -Hugo limits assumptions about how you want to display your content to an intuitive set of sane defaults and will support as many different views of a content type as your site requires. All that is required for these additional views is that a template exists in each `/layouts/` directory with the same name. - -### Custom Content Type Template Lookup Order - -The lookup order for the `content/events/my-first-event.md` templates would be as follows: - -* `layouts/event/birthday.html` -* `layouts/event/single.html` -* `layouts/events/single.html` -* `layouts/_default/single.html` - -### Create a Corresponding Archetype - -We can then create a custom archetype with preconfigured front matter at `event.md` in the `/archetypes` directory; i.e. `archetypes/event.md`. - -Read [Archetypes][archetypes] for more information on archetype usage with `hugo new`. - -[archetypes]: /content-management/archetypes/ -[front matter]: /content-management/front-matter/ -[sectiontemplates]: /templates/section-templates/ -[sections]: /content-management/sections/ -[template]: /templates/ -[Tumblr]: https://www.tumblr.com/ From e8bf224974448f37148b22a712ebd76254fd3180 Mon Sep 17 00:00:00 2001 From: Christian Oliff Date: Thu, 13 Feb 2020 21:19:22 +0900 Subject: [PATCH 4/7] HTTPS links to Vimeo embeds This matches what Vimeo recommends and Hugo's included shortcodes. --- content/en/templates/shortcode-templates.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/templates/shortcode-templates.md b/content/en/templates/shortcode-templates.md index 898296f2b..ac0de0ab2 100644 --- a/content/en/templates/shortcode-templates.md +++ b/content/en/templates/shortcode-templates.md @@ -252,11 +252,11 @@ Would load the template found at `/layouts/shortcodes/vimeo.html`: {{< code file="/layouts/shortcodes/vimeo.html" >}} {{ if .IsNamedParams }}
- +
{{ else }}
- +
{{ end }} {{< /code >}} @@ -265,10 +265,10 @@ Would be rendered as: {{< code file="vimeo-iframes.html" copy="false" >}}
- +
- +
{{< /code >}} From 7a1e0b7422091ca51464886c3531c12505d3f2ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Thu, 13 Feb 2020 14:50:35 +0100 Subject: [PATCH 5/7] Update shortcodes.md Shortcodes with raw string parameters. --- content/en/content-management/shortcodes.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/content/en/content-management/shortcodes.md b/content/en/content-management/shortcodes.md index 806ac9874..fbcd10c86 100644 --- a/content/en/content-management/shortcodes.md +++ b/content/en/content-management/shortcodes.md @@ -51,6 +51,17 @@ Here are two examples of paired shortcodes: The examples above use two different delimiters, the difference being the `%` character in the first and the `<>` characters in the second. +### Shortcodes with raw string parameters + +{{< new-in "0.64.1" >}} + +You can pass multiple lines as parameters to a shortcode by using raw string literals: + +``` +{{HTML, +and a new line with a "quouted string".` */>}} +``` + ### Shortcodes with Markdown In Hugo `0.55` we changed how the `%` delimiter works. Shortcodes using the `%` as the outer-most delimiter will now be fully rendered when sent to the content renderer (e.g. Blackfriday for Markdown), meaning they can be part of the generated table of contents, footnotes, etc. From bfabd8ce87ff2b9505be5d45fa68919ac1c87756 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?L=C3=A1szl=C3=B3=20G=C3=B6r=C3=B6g?= Date: Fri, 14 Feb 2020 21:14:12 +0100 Subject: [PATCH 6/7] Update homepage.md --- content/en/templates/homepage.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/en/templates/homepage.md b/content/en/templates/homepage.md index 55af8f99b..b6ce87f8e 100644 --- a/content/en/templates/homepage.md +++ b/content/en/templates/homepage.md @@ -54,8 +54,7 @@ The following is an example of a homepage template that uses [partial][partials] {{.Content}}
- - {{ range first 10 .Pages }} + {{ range first 10 .Site.RegularPages }} {{ .Render "summary"}} {{ end }}
From 341ecabb29abb9a9626d52309ce0650311607b81 Mon Sep 17 00:00:00 2001 From: tibnew Date: Thu, 17 Oct 2019 09:45:47 +0300 Subject: [PATCH 7/7] Update lookup-order.md The document starts with "Hugo takes the parameters listed below into consideration when choosing a layout for a given page. They are listed in a priority order." So it lists parameters from lower priority to higher priority. But according to examples output format and language priority is higher than Layout priority. It is quite confusing to read. --- content/en/templates/lookup-order.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/en/templates/lookup-order.md b/content/en/templates/lookup-order.md index 61ce35ef2..629f437c9 100644 --- a/content/en/templates/lookup-order.md +++ b/content/en/templates/lookup-order.md @@ -28,15 +28,15 @@ Hugo takes the parameters listed below into consideration when choosing a layout Kind : The page `Kind` (the home page is one). See the example tables below per kind. This also determines if it is a **single page** (i.e. a regular content page. We then look for a template in `_default/single.html` for HTML) or a **list page** (section listings, home page, taxonomy lists, taxonomy terms. We then look for a template in `_default/list.html` for HTML). +Layout +: Can be set in page front matter. + Output Format : See [Custom Output Formats](/templates/output-formats). An output format has both a `name` (e.g. `rss`, `amp`, `html`) and a `suffix` (e.g. `xml`, `html`). We prefer matches with both (e.g. `index.amp.html`, but look for less specific templates. Language : We will consider a language code in the template name. If the site language is `fr`, `index.fr.amp.html` will win over `index.amp.html`, but `index.amp.html` will be chosen before `index.fr.html`. -Layout -: Can be set in page front matter. - Type : Is value of `type` if set in front matter, else it is the name of the root section (e.g. "blog"). It will always have a value, so if not set, the value is "page".