Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs'

```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925

docs/.cspell.json

@@ -0,0 +1,138 @@
+{
+  "version": "0.2",
+  "allowCompoundWords": true,
+  "files": [
+    "**/*.md"
+  ],
+  "flagWords": [
+    "alot",
+    "hte",
+    "langauge",
+    "reccommend",
+    "seperate",
+    "teh"
+  ],
+  "ignorePaths": [
+    "**/emojis.md",
+    "**/commands/*",
+    "**/showcase/*",
+    "**/tools/*"
+  ],
+  "ignoreRegExpList": [
+    "# cspell: ignore fenced code blocks",
+    "^(\\s*`{3,}).*[\\s\\S]*?^\\1",
+    "# cspell: ignore words joined with dot",
+    "\\w+\\.\\w+",
+    "# cspell: ignore strings within backticks",
+    "`.+`",
+    "# cspell: ignore strings within single quotes",
+    "'.+'",
+    "# cspell: ignore strings within double quotes",
+    "\".+\"",
+    "# cspell: ignore strings within brackets",
+    "\\[.+\\]",
+    "# cspell: ignore strings within parentheses",
+    "\\(.+\\)",
+    "# cspell: ignore words that begin with a slash",
+    "/\\w+",
+    "# cspell: ignore everything within action delimiters",
+    "\\{\\{.+\\}\\}",
+    "# cspell: ignore everything after a right arrow",
+    "\\s+→\\s+.+"
+  ],
+  "language": "en",
+  "words": [
+    "antialiasing",
+    "codeowners",
+    "composability",
+    "configurators",
+    "defang",
+    "deindent",
+    "downscale",
+    "downscaled",
+    "downscaling",
+    "exif",
+    "geolocalized",
+    "grayscale",
+    "marshal",
+    "marshaling",
+    "multihost",
+    "performantly",
+    "preconfigured",
+    "prerendering",
+    "redirection",
+    "redirections",
+    "shortcode",
+    "shortcodes",
+    "subexpression",
+    "subexpressions",
+    "suppressable",
+    "templating",
+    "transpile",
+    "transpiles",
+    "unmarshal",
+    "unmarshals",
+    "unmarshaling",
+    "# ----------------------------------------------------------------------",
+    "# cspell: ignore foreign language words",
+    "# ----------------------------------------------------------------------",
+    "bezpieczeństwo",
+    "dokumentation",
+    "libros",
+    "miesiąc",
+    "miesiąc",
+    "miesięcy",
+    "miesięcy",
+    "misérables",
+    "projekt",
+    "régime",
+    "# ----------------------------------------------------------------------",
+    "# cspell: ignore proper nouns",
+    "# ----------------------------------------------------------------------",
+    "Eliott",
+    "Gregor",
+    "Jaco",
+    "Noll",
+    "Pastorius",
+    "Samsa",
+    "# ----------------------------------------------------------------------",
+    "# cspell: ignore operating systems and software packages",
+    "# ----------------------------------------------------------------------",
+    "asciidoctor",
+    "brotli",
+    "corejs",
+    "disqus",
+    "doas",
+    "eopkg",
+    "gitee",
+    "goldmark",
+    "KaTeX",
+    "kubuntu",
+    "lubuntu",
+    "MathJax",
+    "nosql",
+    "pandoc",
+    "pkgin",
+    "rclone",
+    "xubuntu",
+    "# ----------------------------------------------------------------------",
+    "# cspell: ignore miscellaneous",
+    "# ----------------------------------------------------------------------",
+    "dring",
+    "getenv",
+    "gohugo",
+    "inor",
+    "jdoe",
+    "milli",
+    "rgba",
+    "rsmith",
+    "stringifier",
+    "struct",
+    "tdewolff",
+    "tjones",
+    "toclevels",
+    "vals",
+    "xfeff",
+    "zgotmplz"
+  ]
+}

docs/.editorconfig

@@ -0,0 +1,20 @@
+# https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+
+[*.go]
+indent_size = 8
+indent_style = tab
+
+[*.js]
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

docs/.github/SUPPORT.md

@@ -0,0 +1,3 @@
+### Asking support questions
+
+We have an active [discussion forum](https://discourse.gohugo.io) where users and developers can ask questions. Please don't use the GitHub issue tracker to ask questions.

docs/.github/stale.yml

@@ -0,0 +1,22 @@
+# Number of days of inactivity before an issue becomes stale
+daysUntilStale: 120
+# Number of days of inactivity before a stale issue is closed
+daysUntilClose: 30
+# Issues with these labels will never be considered stale
+exemptLabels:
+  - Keep
+  - Security
+  - UndocumentedFeature
+# Label to use when marking an issue as stale
+staleLabel: Stale
+# Comment to post when marking an issue as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. The resources of the Hugo team are limited, and so we are asking for your help.
+
+  If you still think this is important, please tell us why.
+
+  This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.
+
+# Comment to post when closing a stale issue. Set to `false` to disable
+closeComment: false

docs/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,26 @@
+name: "CodeQL"
+
+on:
+  schedule:
+    - cron: "0 0 1 * *"
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v2
+        with:
+          languages: "javascript"
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v2

docs/.github/workflows/spellcheck.yml

@@ -0,0 +1,22 @@
+name: "Check spelling"
+on:
+  push:
+  pull_request:
+    branches-ignore:
+      - "dependabot/**"
+
+permissions:
+  contents: read
+
+jobs:
+  spellcheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: streetsidesoftware/cspell-action@v5
+        with:
+          check_dot_files: false
+          files: content/**/*.md
+          incremental_files_only: true
+          inline: warning
+          strict: false

docs/.github/workflows/super-linter.yml

@@ -0,0 +1,41 @@
+name: Super Linter
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read #  to fetch code (actions/checkout)
+
+jobs:
+  build:
+    permissions:
+      contents: read #  to fetch code (actions/checkout)
+      statuses: write #  to mark status of each linter run (github/super-linter/slim)
+
+    name: Lint Code Base
+    runs-on: ubuntu-latest
+    if: ${{ github.actor != 'dependabot[bot]' }}
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Lint Code Base
+        uses: super-linter/super-linter/slim@v5
+        env:
+          DEFAULT_BRANCH: master
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          IGNORE_GITIGNORED_FILES: true
+          LINTER_RULES_PATH: /
+          LOG_LEVEL: NOTICE
+          MARKDOWN_CONFIG_FILE: .markdownlint.yaml
+          SUPPRESS_POSSUM: true
+          VALIDATE_CSS: false
+          VALIDATE_EDITORCONFIG: false
+          VALIDATE_GITLEAKS: false
+          VALIDATE_HTML: false
+          VALIDATE_JAVASCRIPT_STANDARD: false
+          VALIDATE_JSCPD: false
+          VALIDATE_NATURAL_LANGUAGE: false
+          VALIDATE_SHELL_SHFMT: false
+          VALIDATE_XML: false

docs/.gitignore

@@ -0,0 +1,10 @@
+/.idea
+/.vscode
+/public
+/dist
+node_modules
+nohup.out
+.DS_Store
+trace.out
+.hugo_build.lock
+resources/_gen/images/

docs/.markdownlint.yaml

@@ -0,0 +1,25 @@
+# https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
+
+MD001: false
+MD002: false
+MD003: false
+MD004: false
+MD007: false
+MD012:
+  maximum: 2
+MD013: false
+MD014: false
+MD022: false
+MD024: false
+MD031: false
+MD032: false
+MD033: false
+MD034: false
+MD036: false
+MD037: false
+MD038: false
+MD041: false
+MD046: false
+MD049: false
+MD050: false
+MD053: false

docs/.markdownlintignore

@@ -0,0 +1,6 @@
+**/commands/**
+**/functions/**
+**/news/**
+**/showcase/**
+**/zh/**
+**/license.md

docs/.textlintignore

@@ -0,0 +1,3 @@
+**/news/**
+**/showcase/**
+**/zh/**

docs/.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "DavidAnson.vscode-markdownlint",
+    "EditorConfig.EditorConfig",
+    "streetsidesoftware.code-spell-checker"
+  ]
+}