From 3902f9a4767fe6e62ac5146728d8311b8cd227e0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Thu, 28 Apr 2022 11:52:15 +0200 Subject: [PATCH] Squashed 'docs/' changes from 4c5edacfe..7030fe3a2 7030fe3a2 Remove .hvm file dd0f98831 Add details for DigitalOcean (#1730) ff0c8a6e7 netlify: Hugo 0.97.3 e254724a7 Delete hosting-on-bitbucket.md (#1723) f4304fb7e Remove references to mmark (#1727) 255319023 remove broken link to codeplex.com (#1725) 06cc3856b delete broken link (#1724) ec80dc069 Revert "netlify: Hugo 0.97.2" 211bad5de netlify: Hugo 0.97.2 cd549bca9 Revert "netlify: Update to Hugo 0.97.1" (#1722) 1039a0a48 netlify: Update to Hugo 0.97.1 a28e0d0d3 Update AddDate method 9077b443f Update lists.md 6b174329a Update lists.md d87d9e296 netlify: Hugo 0.97.0 fa7db7c7e Merge branch 'tempv0.97.0' dd6df54b5 Fix broken anchor links (#1717) 6b6743976 Remove StackImpact showcase d00a7eda9 Fix for Cloudflare docs location (#1716) 890866722 Add git required FAQ & remove ZIP from Quick Start (#1713) 73e82d911 resources: Add `key` to reources.GetRemote options map 6795cd2a1 Correct possible typos re: Alias robots usage (#1165) efd5d186a Hosting on Cloudflare Pages (#1709) 9239c5f2a deps: Update github.com/tdewolff/minify/v2 v2.10.0 => v2.11.0 859573bc8 Merge commit 'ec920363cdeb687c8bcac9c242767d366fb058cb' 21f108f12 docs: Regen CLI docs 9b6e7afd2 Add environment as a new filter to _cascade.target git-subtree-dir: docs git-subtree-split: 7030fe3a2ea107a23a4442902cb693557a421523 --- .cspell.json | 1 - content/en/about/features.md | 6 +- content/en/commands/hugo_server.md | 3 +- content/en/content-management/comments.md | 2 +- content/en/content-management/formats.md | 5 +- content/en/content-management/front-matter.md | 8 +- content/en/content-management/multilingual.md | 2 +- content/en/content-management/shortcodes.md | 2 +- content/en/content-management/taxonomies.md | 6 +- content/en/content-management/toc.md | 4 - content/en/content-management/urls.md | 2 +- content/en/contribute/development.md | 2 - content/en/contribute/documentation.md | 2 +- content/en/documentation.md | 1 + content/en/functions/adddate.md | 48 +++--- content/en/functions/relLangURL.md | 4 +- content/en/getting-started/configuration.md | 6 +- .../en/getting-started/directory-structure.md | 4 +- content/en/getting-started/installing.md | 3 +- content/en/getting-started/quick-start.md | 9 +- .../hosting-on-bitbucket.md | 141 ------------------ .../hosting-on-cloudflare-pages.md | 19 +++ content/en/hugo-pipes/introduction.md | 13 ++ content/en/news/0.12-relnotes/index.md | 2 +- content/en/showcase/stackimpact/bio.md | 4 - content/en/showcase/stackimpact/featured.png | Bin 153794 -> 0 bytes content/en/showcase/stackimpact/index.md | 16 -- content/en/templates/404.md | 1 + content/en/templates/lists.md | 7 + content/en/templates/render-hooks.md | 2 +- content/en/templates/single-page-templates.md | 2 +- content/en/templates/taxonomy-templates.md | 8 +- content/en/troubleshooting/faq.md | 11 ++ content/en/variables/page.md | 8 +- data/docs.json | 15 +- netlify.toml | 8 +- 36 files changed, 130 insertions(+), 247 deletions(-) delete mode 100644 content/en/hosting-and-deployment/hosting-on-bitbucket.md create mode 100644 content/en/hosting-and-deployment/hosting-on-cloudflare-pages.md delete mode 100644 content/en/showcase/stackimpact/bio.md delete mode 100644 content/en/showcase/stackimpact/featured.png delete mode 100644 content/en/showcase/stackimpact/index.md diff --git a/.cspell.json b/.cspell.json index 84631ce67..1a197ea7b 100644 --- a/.cspell.json +++ b/.cspell.json @@ -163,7 +163,6 @@ "Milli", "Mittwoch", "mkdir", - "mmark", "modh", "monokai", "Morling", diff --git a/content/en/about/features.md b/content/en/about/features.md index 11f9f65b7..ed8c25821 100644 --- a/content/en/about/features.md +++ b/content/en/about/features.md @@ -60,7 +60,7 @@ toc: true [content summaries]: /content-management/summaries/ [content types]: /content-management/types/ [Disqus]: https://disqus.com/ -[Dynamic menu]: /templates/menus/ +[Dynamic menu]: /templates/menu-templates/ [Extremely fast]: https://github.com/bep/hugo-benchmark [front matter]: /content-management/front-matter/ [functions]: /functions/ @@ -73,13 +73,13 @@ toc: true [organization for your projects]: /getting-started/directory-structure/ [pagevars]: /variables/page/ [Permalink]: /content-management/urls/#permalinks -[Powerful theming]: /themes/ +[Powerful theming]: /hugo-modules/theme-components/ [Pretty URLs]: /content-management/urls/ [RSS]: /templates/rss/ [Shortcodes]: /content-management/shortcodes/ [sort content]: /templates/ [supported formats]: /content-management/formats/ -[Syntax highlighting]: /tools/syntax-highlighting/ +[Syntax highlighting]: /content-management/syntax-highlighting/ [table of contents]: /content-management/toc/ [taxonomies]: /content-management/taxonomies/ [URLs]: /content-management/urls/ diff --git a/content/en/commands/hugo_server.md b/content/en/commands/hugo_server.md index 33b95d51c..7d8067386 100644 --- a/content/en/commands/hugo_server.md +++ b/content/en/commands/hugo_server.md @@ -64,7 +64,8 @@ hugo server [flags] --printMemoryUsage print memory usage to screen at intervals --printPathWarnings print warnings on duplicate target paths etc. --printUnusedTemplates print warnings on unused templates. - --renderToDisk render to Destination path (default is render to memory & serve from there) + --renderStaticToDisk serve static files from disk and dynamic files from memory + --renderToDisk serve all files from disk (default is from memory) --templateMetrics display metrics about template executions --templateMetricsHints calculate some improvement hints when combined with --templateMetrics -t, --theme strings themes to use (located in /themes/THEMENAME/) diff --git a/content/en/content-management/comments.md b/content/en/content-management/comments.md index 311f24c14..ad3a1b55d 100644 --- a/content/en/content-management/comments.md +++ b/content/en/content-management/comments.md @@ -64,7 +64,7 @@ These are some alternatives to Disqus: * [Utterances](https://utteranc.es/) (Open source, GitHub comments widget built on GitHub issues) [configuration]: /getting-started/configuration/ -[disquspartial]: /templates/partials/#disqus +[disquspartial]: /templates/internal/#disqus [disqussetup]: https://disqus.com/profile/signup/ [forum]: https://discourse.gohugo.io [front matter]: /content-management/front-matter/ diff --git a/content/en/content-management/formats.md b/content/en/content-management/formats.md index 0b25c3171..7d2d7b0a0 100644 --- a/content/en/content-management/formats.md +++ b/content/en/content-management/formats.md @@ -5,7 +5,7 @@ description: Both HTML and Markdown are supported content formats. date: 2017-01-10 publishdate: 2017-01-10 categories: [content management] -keywords: [markdown,asciidoc,mmark,pandoc,content format] +keywords: [markdown,asciidoc,pandoc,content format] menu: docs: parent: "content-management" @@ -30,7 +30,6 @@ The current list of content formats in Hugo: | ------------- | ------------- |-------------| | Goldmark | md, markdown, goldmark |Note that you can set the default handler of `md` and `markdown` to something else, see [Configure Markup](/getting-started/configuration-markup/).{{< new-in "0.60.0" >}} | | Blackfriday | blackfriday |Blackfriday will eventually be deprecated.| -|MMark|mmark|Mmark is deprecated and will be removed in a future release.| |Emacs Org-Mode|org|See [go-org](https://github.com/niklasfasching/go-org).| |AsciiDoc|asciidocext, adoc, ad|Needs [Asciidoctor][ascii] installed.| |RST|rst|Needs [RST](https://docutils.sourceforge.io/rst.html) installed.| @@ -131,7 +130,6 @@ Markdown syntax is simple enough to learn in a single sitting. The following are [ascii]: https://asciidoctor.org/ [bfconfig]: /getting-started/configuration/#configuring-blackfriday-rendering [blackfriday]: https://github.com/russross/blackfriday -[mmark]: https://github.com/miekg/mmark [config]: /getting-started/configuration/ [developer tools]: /tools/ [emojis]: https://www.webpagefx.com/tools/emoji-cheat-sheet/ @@ -146,7 +144,6 @@ Markdown syntax is simple enough to learn in a single sitting. The following are [mdcheatsheet]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet [mdguide]: https://www.markdownguide.org/ [mdtutorial]: https://www.markdowntutorial.com/ -[Miek Gieben's website]: https://miek.nl/2016/march/05/mmark-syntax-document/ [org]: https://orgmode.org/ [pandoc]: https://www.pandoc.org/ [rest]: https://docutils.sourceforge.io/rst.html diff --git a/content/en/content-management/front-matter.md b/content/en/content-management/front-matter.md index 6986f067f..c915a5f96 100644 --- a/content/en/content-management/front-matter.md +++ b/content/en/content-management/front-matter.md @@ -92,7 +92,7 @@ keywords : the meta keywords for the content. layout -: the layout Hugo should select from the [lookup order][lookup] when rendering the content. If a `type` is not specified in the front matter, Hugo will look for the layout of the same name in the layout directory that corresponds with a content's section. See ["Defining a Content Type"][definetype] +: the layout Hugo should select from the [lookup order][lookup] when rendering the content. If a `type` is not specified in the front matter, Hugo will look for the layout of the same name in the layout directory that corresponds with a content's section. See [Content Types][content type]. lastmod : the datetime at which the content was last modified. @@ -189,6 +189,9 @@ kind lang : A Glob pattern matching the Page's language, e.g. "{en,sv}". +environment +: A Glob pattern matching the build environment, e.g. "{production,development}" + Any of the above can be omitted. ### Example @@ -229,10 +232,9 @@ It's possible to set some options for Markdown rendering in a content's front ma [config]: /getting-started/configuration/ "Hugo documentation for site configuration" [content type]: /content-management/types/ [contentorg]: /content-management/organization/ -[definetype]: /content-management/types/#defining-a-content-type "Learn how to specify a type and a layout in a content's front matter" [headless-bundle]: /content-management/page-bundles/#headless-bundle [json]: https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf "Specification for JSON, JavaScript Object Notation" -[lists]: /templates/lists/#ordering-content "See how to order content in list pages; for example, templates that look to specific _index.md for content and front matter." +[lists]: /templates/lists/#order-content "See how to order content in list pages; for example, templates that look to specific _index.md for content and front matter." [lookup]: /templates/lookup-order/ "Hugo traverses your templates in a specific order when rendering content to allow for DRYer templating." [ordering]: /templates/lists/ "Hugo provides multiple ways to sort and order your content in list templates" [outputs]: /templates/output-formats/ "With the release of v22, you can output your content to any text format using Hugo's familiar templating" diff --git a/content/en/content-management/multilingual.md b/content/en/content-management/multilingual.md index 620ec0b93..82d95f6f1 100644 --- a/content/en/content-management/multilingual.md +++ b/content/en/content-management/multilingual.md @@ -571,7 +571,7 @@ If there is more than one language defined, the `LanguagePrefix` variable will e [lang.FormatAccounting]: /functions/lang/#langformataccounting [lang.FormatCurrency]: /functions/lang/#langformatcurrency [lang.FormatNumber]: /functions/lang/#langformatnumber -[lang.FormatNumberCustom]: functions/lang/#langformatnumbercustom +[lang.FormatNumberCustom]: /functions/lang/#langformatnumbercustom [lang.FormatPercent]: /functions/lang/#langformatpercent [lang.Merge]: /functions/lang.merge/ [menus]: /content-management/menus/ diff --git a/content/en/content-management/shortcodes.md b/content/en/content-management/shortcodes.md index 013532ce4..017267ec7 100644 --- a/content/en/content-management/shortcodes.md +++ b/content/en/content-management/shortcodes.md @@ -183,7 +183,7 @@ To demonstrate the remarkably efficiency of Hugo's shortcode feature, we have em ### `highlight` -This shortcode will convert the source code provided into syntax-highlighted HTML. Read more on [highlighting](/tools/syntax-highlighting/). `highlight` takes exactly one required `language` parameter and requires a closing shortcode. +This shortcode will convert the source code provided into syntax-highlighted HTML. Read more on [highlighting](/content-management/syntax-highlighting/). `highlight` takes exactly one required `language` parameter and requires a closing shortcode. #### Example `highlight` Input diff --git a/content/en/content-management/taxonomies.md b/content/en/content-management/taxonomies.md index da29fa7be..32227d52c 100644 --- a/content/en/content-management/taxonomies.md +++ b/content/en/content-management/taxonomies.md @@ -84,7 +84,7 @@ Moonrise Kingdom <- Value Hugo natively supports taxonomies. -Without adding a single line to your [site config][config] file, Hugo will automatically create taxonomies for `tags` and `categories`. That would be the same as manually [configuring your taxonomies](#configuring-taxonomies) as below: +Without adding a single line to your [site config][config] file, Hugo will automatically create taxonomies for `tags` and `categories`. That would be the same as manually [configuring your taxonomies](#configure-taxonomies) as below: {{< code-toggle copy="false" >}} [taxonomies] @@ -189,7 +189,7 @@ categories_weight = 44 By using taxonomic weight, the same piece of content can appear in different positions in different taxonomies. {{% note "Limits to Ordering Taxonomies" %}} -Currently taxonomies only support the [default `weight => date` ordering of list content](/templates/lists/#default-weight-date). For more information, see the documentation on [taxonomy templates](/templates/taxonomy-templates/). +Currently taxonomies only support the [default `weight => date` ordering of list content](/templates/lists/#default-weight--date--linktitle--filepath). For more information, see the documentation on [taxonomy templates](/templates/taxonomy-templates/). {{% /note %}} ## Add custom metadata to a Taxonomy or Term @@ -209,7 +209,7 @@ wikipedia: "https://en.wikipedia.org/wiki/Bruce_Willis" [content type]: /content-management/types/ [documentation on archetypes]: /content-management/archetypes/ [front matter]: /content-management/front-matter/ -[taxonomy list templates]: /templates/taxonomy-templates/#taxonomy-page-templates +[taxonomy list templates]: /templates/taxonomy-templates/#taxonomy-list-templates [taxonomy templates]: /templates/taxonomy-templates/ [terms within the taxonomy]: /templates/taxonomy-templates/#taxonomy-terms-templates "See how to order terms associated with a taxonomy" [config]: /getting-started/configuration/ diff --git a/content/en/content-management/toc.md b/content/en/content-management/toc.md index 6a0b73fe5..57228ba50 100644 --- a/content/en/content-management/toc.md +++ b/content/en/content-management/toc.md @@ -49,10 +49,6 @@ Hugo will take this Markdown and create a table of contents from `## Introductio The built-in `.TableOfContents` variables outputs a `