From 3710a5ec7efe6baca6e452f43632c05d22bab3c4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Fri, 27 Oct 2023 10:06:44 +0200 Subject: [PATCH] Squashed 'docs/' changes from cb18a5183..417593493 417593493 Fix broken link 9829e2862 Mention Go variable naming rules 11ce3a59c Fix typo 0d62feed5 Update glossary 5e9ecb217 Prepare for pending deprecations c5f76c776 Update Twitter Cards URL git-subtree-dir: docs git-subtree-split: 4175934933feca8fa1f9936ccf7d16b90b41e833 --- config/_default/params.toml | 3 +++ content/en/getting-started/glossary.md | 4 ++++ content/en/templates/internal.md | 2 +- content/en/templates/introduction.md | 3 +++ content/en/templates/lists/index.md | 2 +- hugo.toml | 3 +++ 6 files changed, 15 insertions(+), 2 deletions(-) diff --git a/config/_default/params.toml b/config/_default/params.toml index 7103394a6..3fddf9dbc 100644 --- a/config/_default/params.toml +++ b/config/_default/params.toml @@ -19,3 +19,6 @@ images = ["images/gohugoio-card.png"] flex_box_interior_classes = "flex-auto w-100 w-40-l mr3 mb3 bg-white ba b--moon-gray nested-copy-line-height" #sidebar_direction = "sidebar_left" + +[social] +twitter = "GoHugoIO" diff --git a/content/en/getting-started/glossary.md b/content/en/getting-started/glossary.md index c15af5170..759cb1cd1 100644 --- a/content/en/getting-started/glossary.md +++ b/content/en/getting-started/glossary.md @@ -92,6 +92,10 @@ Used within a [template action](#template-action), a function takes one or more Metadata at the beginning of each content page, separated from the content by format-specific delimiters. See [details](/content-management/front-matter/). +### identifier + +A string that represents a variable, method, object, or field. It must conform to Go's [language specification](https://go.dev/ref/spec#Identifiers), beginning with a letter or underscore, followed by zero or more letters, digits, or underscores. + ### int See [integer](#integer). diff --git a/content/en/templates/internal.md b/content/en/templates/internal.md index ee0d7258d..cdac50478 100644 --- a/content/en/templates/internal.md +++ b/content/en/templates/internal.md @@ -159,7 +159,7 @@ To add Open Graph metadata, include the following line between the `` tags ## Twitter Cards -An internal template for [Twitter Cards](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/overview/abouts-cards), +An internal template for [Twitter Cards](https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards), metadata used to attach rich media to Tweets linking to your site. ### Configure Twitter Cards diff --git a/content/en/templates/introduction.md b/content/en/templates/introduction.md index 93666de28..2eb436f82 100644 --- a/content/en/templates/introduction.md +++ b/content/en/templates/introduction.md @@ -114,6 +114,8 @@ all other pages: Var is {{ $var }} ``` +Variable names must conform to Go's naming rules for [identifiers][identifier]. + ## Functions Go Templates only ship with a few basic functions but also provide a mechanism for applications to extend the original set. @@ -660,6 +662,7 @@ If you restrict front matter to the TOML format, and omit quotation marks surrou [dotdoc]: https://golang.org/pkg/text/template/#hdr-Variables [front matter]: /content-management/front-matter [functions]: /functions +[identifier]: /getting-started/glossary/#identifier [internal templates]: /templates/internal [math]: /functions/math [pagevars]: /variables/page diff --git a/content/en/templates/lists/index.md b/content/en/templates/lists/index.md index e586460db..b48969e96 100644 --- a/content/en/templates/lists/index.md +++ b/content/en/templates/lists/index.md @@ -592,6 +592,6 @@ See the documentation on [`where`] and [taxvars]: /variables/taxonomy/ [views]: /templates/views/ [`where`]: /functions/collections/where -[`first]: /functions/first/ +[`first`]: /functions/first/ [main sections]: /functions/collections/where#mainsections [`time.Format`]: /functions/time/format diff --git a/hugo.toml b/hugo.toml index 46486aec9..3126027a9 100644 --- a/hugo.toml +++ b/hugo.toml @@ -86,6 +86,9 @@ ID = 'G-MBZGKNMDWC' weight = 60 cardinalityThreshold = 50 +# TODO delete when (a) Netlify is building the site with v0.120.0 or later, +# and (b) the changes fom gohugoioTheme/commit/af97b8e61638ddf043b87590cd567d76045bf9be +# have been pulled into this repo. [social] twitter = "GoHugoIO"