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
This commit is contained in:
Bjørn Erik Pedersen 2023-06-13 20:43:03 +02:00
parent dfb1895e4b
commit 3c1deaf201
13 changed files with 136 additions and 39 deletions

View file

@ -23,6 +23,7 @@ hugo config [command] [flags]
-c, --contentDir string filesystem path to content directory -c, --contentDir string filesystem path to content directory
--format string preferred file format (toml, yaml or json) (default "toml") --format string preferred file format (toml, yaml or json) (default "toml")
-h, --help help for config -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/) -t, --theme strings themes to use (located in /themes/THEMENAME/)
``` ```

View file

@ -11,8 +11,6 @@ A high performance webserver
Hugo provides its own webserver which builds and serves the site. Hugo provides its own webserver which builds and serves the site.
While hugo server is high performance, it is a webserver with limited options. 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, 'hugo server' will avoid writing the rendered and served content to disk,
preferring to store it in memory. 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. of a second, you will be able to save and see your changes nearly instantly.
``` ```
hugo server [flags] [args] hugo server [command] [flags]
``` ```
### Options ### Options
@ -69,6 +67,9 @@ hugo server [flags] [args]
--templateMetrics display metrics about template executions --templateMetrics display metrics about template executions
--templateMetricsHints calculate some improvement hints when combined with --templateMetrics --templateMetricsHints calculate some improvement hints when combined with --templateMetrics
-t, --theme strings themes to use (located in /themes/THEMENAME/) -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) --trace file write trace to file (not useful in general)
-w, --watch watch filesystem for changes and recreate as needed (default true) -w, --watch watch filesystem for changes and recreate as needed (default true)
``` ```
@ -95,4 +96,5 @@ hugo server [flags] [args]
### SEE ALSO ### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site * [hugo](/commands/hugo/) - hugo builds your site
* [hugo server trust](/commands/hugo_server_trust/) - Install the local CA in the system trust store.

View file

@ -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

View file

@ -233,7 +233,7 @@ It's possible to set some options for Markdown rendering in a content's front ma
[pagevars]: /variables/page/ [pagevars]: /variables/page/
[section]: /content-management/sections/ [section]: /content-management/sections/
[taxweight]: /content-management/taxonomies/ [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/ [urls]: /content-management/urls/
[variables]: /variables/ [variables]: /variables/
[yaml]: https://yaml.org/spec/ "Specification for YAML, YAML Ain't Markup Language" [yaml]: https://yaml.org/spec/ "Specification for YAML, YAML Ain't Markup Language"

View file

@ -1,16 +1,21 @@
--- ---
title: eq title: eq
description: Returns the boolean truth of arg1 == arg2. description: Returns the boolean truth of arg1 == arg2 || arg1 == arg3.
categories: [functions] categories: [functions]
menu: menu:
docs: docs:
parent: functions parent: functions
keywords: [operators,logic] keywords: [comparison,operators,logic]
signature: ["eq ARG1 ARG2"] signature: ["eq ARG1 ARG2 [ARG...]"]
relatedfuncs: [] relatedfuncs: []
--- ---
```go-html-template ```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
``` ```

View file

@ -1,16 +1,26 @@
--- ---
title: ge title: ge
description: Returns the boolean truth of arg1 >= arg2. description: Returns the boolean truth of arg1 >= arg2 && arg1 >= arg3.
categories: [functions] categories: [functions]
menu: menu:
docs: docs:
parent: functions parent: functions
keywords: [operators,logic] keywords: [comparison,operators,logic]
signature: ["ge ARG1 ARG2"] signature: ["ge ARG1 ARG2 [ARG...]"]
relatedfuncs: [] relatedfuncs: []
--- ---
```go-html-template ```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
``` ```

View file

@ -1,16 +1,26 @@
--- ---
title: gt title: gt
description: Returns the boolean truth of arg1 > arg2. description: Returns the boolean truth of arg1 > arg2 && arg1 > arg3.
categories: [functions] categories: [functions]
menu: menu:
docs: docs:
parent: functions parent: functions
keywords: [operators,logic] keywords: [comparison,operators,logic]
signature: ["gt ARG1 ARG2"] signature: ["gt ARG1 ARG2 [ARG...]"]
relatedfuncs: [] relatedfuncs: []
--- ---
```go-html-template ```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
``` ```

View file

@ -1,16 +1,26 @@
--- ---
title: le title: le
description: Returns the boolean truth of arg1 <= arg2. description: Returns the boolean truth of arg1 <= arg2 && arg1 <= arg3.
categories: [functions] categories: [functions]
menu: menu:
docs: docs:
parent: functions parent: functions
keywords: [operators,logic] keywords: [comparison,operators,logic]
signature: ["le ARG1 ARG2"] signature: ["le ARG1 ARG2 [ARG...]"]
relatedfuncs: [] relatedfuncs: []
--- ---
```go-html-template ```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
``` ```

View file

@ -1,16 +1,26 @@
--- ---
title: lt title: lt
description: Returns the boolean truth of arg1 < arg2. description: Returns the boolean truth of arg1 < arg2 && arg1 < arg3.
categories: [functions] categories: [functions]
menu: menu:
docs: docs:
parent: functions parent: functions
keywords: [operators,logic] keywords: [comparison,operators,logic]
signature: ["lt ARG1 ARG2"] signature: ["lt ARG1 ARG2 [ARG...]"]
relatedfuncs: [] relatedfuncs: []
--- ---
```go-html-template ```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
``` ```

View file

@ -1,16 +1,21 @@
--- ---
title: ne title: ne
description: Returns the boolean truth of arg1 != arg2. description: Returns the boolean truth of arg1 != arg2 && arg1 != arg3.
categories: [functions] categories: [functions]
menu: menu:
docs: docs:
parent: functions parent: functions
keywords: [operators,logic] keywords: [comparison,operators,logic]
signature: ["ne ARG1 ARG2"] signature: ["ne ARG1 ARG2 [ARG...]"]
relatedfuncs: [] relatedfuncs: []
--- ---
```go-html-template ```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
``` ```

View file

@ -1,6 +1,6 @@
--- ---
title: plainify 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] categories: [functions]
menu: menu:
docs: docs:

View file

@ -35,6 +35,7 @@ The Hugo community uses a wide range of preferred tools and has developed plug-i
## Vim ## 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 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 ## Atom

View file

@ -3,7 +3,7 @@ publish = "public"
command = "hugo --gc --minify" command = "hugo --gc --minify"
[context.production.environment] [context.production.environment]
HUGO_VERSION = "0.112.5" HUGO_VERSION = "0.113.0"
HUGO_ENV = "production" HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true" HUGO_ENABLEGITINFO = "true"
@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
command = "hugo --gc --minify --enableGitInfo" command = "hugo --gc --minify --enableGitInfo"
[context.split1.environment] [context.split1.environment]
HUGO_VERSION = "0.112.5" HUGO_VERSION = "0.113.0"
HUGO_ENV = "production" HUGO_ENV = "production"
[context.deploy-preview] [context.deploy-preview]
command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL" command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
[context.deploy-preview.environment] [context.deploy-preview.environment]
HUGO_VERSION = "0.112.5" HUGO_VERSION = "0.113.0"
[context.branch-deploy] [context.branch-deploy]
command = "hugo --gc --minify -b $DEPLOY_PRIME_URL" command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
[context.branch-deploy.environment] [context.branch-deploy.environment]
HUGO_VERSION = "0.112.5" HUGO_VERSION = "0.113.0"
[context.next.environment] [context.next.environment]
HUGO_ENABLEGITINFO = "true" HUGO_ENABLEGITINFO = "true"