From 3c1deaf201a35de08d23cc58f8f03682cace3349 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B8rn=20Erik=20Pedersen?= Date: Tue, 13 Jun 2023 20:43:03 +0200 Subject: [PATCH] Squashed 'docs/' changes from 1d5548d73..85befbb4d 85befbb4d Update plainify.md 56e137043 Update comparison operators (#2104) 4241135e0 Front matter docu: improve link to TOML spec (#2102) 5115de3c0 netlify: Hugo 0.113.0 99b74a053 Merge branch 'temp01130' 1622d5d1a docs: Regenerate CLI docs adb4297eb netlify: Hugo 0.112.7 cd6813309 Update editors.md to include vim-hugo (#2098) f7c2406dd netlify: Hugo 0.112.6 b891028c3 docs: Regenerate CLI docs git-subtree-dir: docs git-subtree-split: 85befbb4dc2f526da99fa9f47d54a12e6282d36e --- content/en/commands/hugo_config.md | 1 + content/en/commands/hugo_server.md | 8 ++-- content/en/commands/hugo_server_trust.md | 43 +++++++++++++++++++ content/en/content-management/front-matter.md | 2 +- content/en/functions/eq.md | 15 ++++--- content/en/functions/ge.md | 20 ++++++--- content/en/functions/gt.md | 20 ++++++--- content/en/functions/le.md | 20 ++++++--- content/en/functions/lt.md | 20 ++++++--- content/en/functions/ne.md | 15 ++++--- content/en/functions/plainify.md | 2 +- content/en/tools/editors.md | 1 + netlify.toml | 8 ++-- 13 files changed, 136 insertions(+), 39 deletions(-) create mode 100644 content/en/commands/hugo_server_trust.md diff --git a/content/en/commands/hugo_config.md b/content/en/commands/hugo_config.md index 1dbf4c0de..42cd188b7 100644 --- a/content/en/commands/hugo_config.md +++ b/content/en/commands/hugo_config.md @@ -23,6 +23,7 @@ hugo config [command] [flags] -c, --contentDir string filesystem path to content directory --format string preferred file format (toml, yaml or json) (default "toml") -h, --help help for config + --lang string the language to display config for. Defaults to the first language defined. -t, --theme strings themes to use (located in /themes/THEMENAME/) ``` diff --git a/content/en/commands/hugo_server.md b/content/en/commands/hugo_server.md index 27e12deb9..d328ee685 100644 --- a/content/en/commands/hugo_server.md +++ b/content/en/commands/hugo_server.md @@ -11,8 +11,6 @@ A high performance webserver Hugo provides its own webserver which builds and serves the site. While hugo server is high performance, it is a webserver with limited options. -Many run it in production, but the standard behavior is for people to use it -in development and use a more full featured server such as Nginx or Caddy. 'hugo server' will avoid writing the rendered and served content to disk, preferring to store it in memory. @@ -23,7 +21,7 @@ and push the latest content to them. As most Hugo sites are built in a fraction of a second, you will be able to save and see your changes nearly instantly. ``` -hugo server [flags] [args] +hugo server [command] [flags] ``` ### Options @@ -69,6 +67,9 @@ hugo server [flags] [args] --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/) + --tlsAuto generate and use locally-trusted certificates. + --tlsCertFile string path to TLS certificate file + --tlsKeyFile string path to TLS key file --trace file write trace to file (not useful in general) -w, --watch watch filesystem for changes and recreate as needed (default true) ``` @@ -95,4 +96,5 @@ hugo server [flags] [args] ### SEE ALSO * [hugo](/commands/hugo/) - hugo builds your site +* [hugo server trust](/commands/hugo_server_trust/) - Install the local CA in the system trust store. diff --git a/content/en/commands/hugo_server_trust.md b/content/en/commands/hugo_server_trust.md new file mode 100644 index 000000000..0217f0d6c --- /dev/null +++ b/content/en/commands/hugo_server_trust.md @@ -0,0 +1,43 @@ +--- +title: "hugo server trust" +slug: hugo_server_trust +url: /commands/hugo_server_trust/ +--- +## hugo server trust + +Install the local CA in the system trust store. + +``` +hugo server trust [flags] [args] +``` + +### Options + +``` + -h, --help help for trust + --uninstall Uninstall the local CA (but do not delete it). +``` + +### Options inherited from parent commands + +``` + --clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00 + --config string config file (default is hugo.yaml|json|toml) + --configDir string config dir (default "config") + --debug debug output + -d, --destination string filesystem path to write files to + -e, --environment string build environment + --ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern + --log enable Logging + --logFile string log File path (if set, logging enabled automatically) + --quiet build in quiet mode + -s, --source string filesystem path to read files relative from + --themesDir string filesystem path to themes directory + -v, --verbose verbose output + --verboseLog verbose logging +``` + +### SEE ALSO + +* [hugo server](/commands/hugo_server/) - A high performance webserver + diff --git a/content/en/content-management/front-matter.md b/content/en/content-management/front-matter.md index 062288320..fb02f99f5 100644 --- a/content/en/content-management/front-matter.md +++ b/content/en/content-management/front-matter.md @@ -233,7 +233,7 @@ It's possible to set some options for Markdown rendering in a content's front ma [pagevars]: /variables/page/ [section]: /content-management/sections/ [taxweight]: /content-management/taxonomies/ -[toml]: https://github.com/toml-lang/toml "Specification for TOML, Tom's Obvious Minimal Language" +[toml]: https://toml.io/ [urls]: /content-management/urls/ [variables]: /variables/ [yaml]: https://yaml.org/spec/ "Specification for YAML, YAML Ain't Markup Language" diff --git a/content/en/functions/eq.md b/content/en/functions/eq.md index 98eca1aa5..d10539e49 100644 --- a/content/en/functions/eq.md +++ b/content/en/functions/eq.md @@ -1,16 +1,21 @@ --- title: eq -description: Returns the boolean truth of arg1 == arg2. +description: Returns the boolean truth of arg1 == arg2 || arg1 == arg3. categories: [functions] menu: docs: parent: functions -keywords: [operators,logic] -signature: ["eq ARG1 ARG2"] +keywords: [comparison,operators,logic] +signature: ["eq ARG1 ARG2 [ARG...]"] relatedfuncs: [] --- - ```go-html-template -{{ if eq .Section "blog" }}current{{ end }} +{{ eq 1 1 }} → true +{{ eq 1 2 }} → false + +{{ eq 1 1 1 }} → true +{{ eq 1 1 2 }} → true +{{ eq 1 2 1 }} → true +{{ eq 1 2 2 }} → false ``` diff --git a/content/en/functions/ge.md b/content/en/functions/ge.md index 8306935f0..e59b0f9c9 100644 --- a/content/en/functions/ge.md +++ b/content/en/functions/ge.md @@ -1,16 +1,26 @@ --- title: ge -description: Returns the boolean truth of arg1 >= arg2. +description: Returns the boolean truth of arg1 >= arg2 && arg1 >= arg3. categories: [functions] menu: docs: parent: functions -keywords: [operators,logic] -signature: ["ge ARG1 ARG2"] +keywords: [comparison,operators,logic] +signature: ["ge ARG1 ARG2 [ARG...]"] relatedfuncs: [] --- - ```go-html-template -{{ if ge 10 5 }}true{{ end }} +{{ ge 1 1 }} → true +{{ ge 1 2 }} → false +{{ ge 2 1 }} → true + +{{ ge 1 1 1 }} → true +{{ ge 1 1 2 }} → false +{{ ge 1 2 1 }} → false +{{ ge 1 2 2 }} → false + +{{ ge 2 1 1 }} → true +{{ ge 2 1 2 }} → true +{{ ge 2 2 1 }} → true ``` diff --git a/content/en/functions/gt.md b/content/en/functions/gt.md index dba0d4dfc..dac1986fe 100644 --- a/content/en/functions/gt.md +++ b/content/en/functions/gt.md @@ -1,16 +1,26 @@ --- title: gt -description: Returns the boolean truth of arg1 > arg2. +description: Returns the boolean truth of arg1 > arg2 && arg1 > arg3. categories: [functions] menu: docs: parent: functions -keywords: [operators,logic] -signature: ["gt ARG1 ARG2"] +keywords: [comparison,operators,logic] +signature: ["gt ARG1 ARG2 [ARG...]"] relatedfuncs: [] --- - ```go-html-template -{{ if gt 10 5 }}true{{ end }} +{{ gt 1 1 }} → false +{{ gt 1 2 }} → false +{{ gt 2 1 }} → true + +{{ gt 1 1 1 }} → false +{{ gt 1 1 2 }} → false +{{ gt 1 2 1 }} → false +{{ gt 1 2 2 }} → false + +{{ gt 2 1 1 }} → true +{{ gt 2 1 2 }} → false +{{ gt 2 2 1 }} → false ``` diff --git a/content/en/functions/le.md b/content/en/functions/le.md index 632e43a0e..1953bfae0 100644 --- a/content/en/functions/le.md +++ b/content/en/functions/le.md @@ -1,16 +1,26 @@ --- title: le -description: Returns the boolean truth of arg1 <= arg2. +description: Returns the boolean truth of arg1 <= arg2 && arg1 <= arg3. categories: [functions] menu: docs: parent: functions -keywords: [operators,logic] -signature: ["le ARG1 ARG2"] +keywords: [comparison,operators,logic] +signature: ["le ARG1 ARG2 [ARG...]"] relatedfuncs: [] --- - ```go-html-template -{{ if le 5 10 }}true{{ end }} +{{ le 1 1 }} → true +{{ le 1 2 }} → true +{{ le 2 1 }} → false + +{{ le 1 1 1 }} → true +{{ le 1 1 2 }} → true +{{ le 1 2 1 }} → true +{{ le 1 2 2 }} → true + +{{ le 2 1 1 }} → false +{{ le 2 1 2 }} → false +{{ le 2 2 1 }} → false ``` diff --git a/content/en/functions/lt.md b/content/en/functions/lt.md index 08cad7904..9a8651574 100644 --- a/content/en/functions/lt.md +++ b/content/en/functions/lt.md @@ -1,16 +1,26 @@ --- title: lt -description: Returns the boolean truth of arg1 < arg2. +description: Returns the boolean truth of arg1 < arg2 && arg1 < arg3. categories: [functions] menu: docs: parent: functions -keywords: [operators,logic] -signature: ["lt ARG1 ARG2"] +keywords: [comparison,operators,logic] +signature: ["lt ARG1 ARG2 [ARG...]"] relatedfuncs: [] --- - ```go-html-template -{{ if lt 5 10 }}true{{ end }} +{{ lt 1 1 }} → false +{{ lt 1 2 }} → true +{{ lt 2 1 }} → false + +{{ lt 1 1 1 }} → false +{{ lt 1 1 2 }} → false +{{ lt 1 2 1 }} → false +{{ lt 1 2 2 }} → true + +{{ lt 2 1 1 }} → false +{{ lt 2 1 2 }} → false +{{ lt 2 2 1 }} → false ``` diff --git a/content/en/functions/ne.md b/content/en/functions/ne.md index 54f66823c..49c69fbaa 100644 --- a/content/en/functions/ne.md +++ b/content/en/functions/ne.md @@ -1,16 +1,21 @@ --- title: ne -description: Returns the boolean truth of arg1 != arg2. +description: Returns the boolean truth of arg1 != arg2 && arg1 != arg3. categories: [functions] menu: docs: parent: functions -keywords: [operators,logic] -signature: ["ne ARG1 ARG2"] +keywords: [comparison,operators,logic] +signature: ["ne ARG1 ARG2 [ARG...]"] relatedfuncs: [] --- - ```go-html-template -{{ if ne .Section "blog" }}current{{ end }} +{{ ne 1 1 }} → false +{{ ne 1 2 }} → true + +{{ ne 1 1 1 }} → false +{{ ne 1 1 2 }} → false +{{ ne 1 2 1 }} → false +{{ ne 1 2 2 }} → true ``` diff --git a/content/en/functions/plainify.md b/content/en/functions/plainify.md index 78f52683b..8767a460e 100644 --- a/content/en/functions/plainify.md +++ b/content/en/functions/plainify.md @@ -1,6 +1,6 @@ --- title: plainify -description: Strips any HTML and returns the plain text version of the provided string. +description: Returns a string with all HTML tags removed. categories: [functions] menu: docs: diff --git a/content/en/tools/editors.md b/content/en/tools/editors.md index 55ab47090..5efeba336 100644 --- a/content/en/tools/editors.md +++ b/content/en/tools/editors.md @@ -35,6 +35,7 @@ The Hugo community uses a wide range of preferred tools and has developed plug-i ## Vim * [Vim Hugo Helper](https://github.com/robertbasic/vim-hugo-helper). A small Vim plugin to help me with writing posts with Hugo. +* [vim-hugo](https://github.com/phelipetls/vim-hugo). A Vim plugin with syntax highlighting for templates and a few other features. ## Atom diff --git a/netlify.toml b/netlify.toml index be3f1d9a9..135cdef64 100644 --- a/netlify.toml +++ b/netlify.toml @@ -3,7 +3,7 @@ publish = "public" command = "hugo --gc --minify" [context.production.environment] -HUGO_VERSION = "0.112.5" +HUGO_VERSION = "0.113.0" HUGO_ENV = "production" HUGO_ENABLEGITINFO = "true" @@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true" command = "hugo --gc --minify --enableGitInfo" [context.split1.environment] -HUGO_VERSION = "0.112.5" +HUGO_VERSION = "0.113.0" HUGO_ENV = "production" [context.deploy-preview] command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL" [context.deploy-preview.environment] -HUGO_VERSION = "0.112.5" +HUGO_VERSION = "0.113.0" [context.branch-deploy] command = "hugo --gc --minify -b $DEPLOY_PRIME_URL" [context.branch-deploy.environment] -HUGO_VERSION = "0.112.5" +HUGO_VERSION = "0.113.0" [context.next.environment] HUGO_ENABLEGITINFO = "true"