Skip to content

Commit d6e753b

Browse files
jmooringjmooring
committed
content: Document new dimensions
1 parent e316dbf commit d6e753b

File tree

14 files changed

+834
-2
lines changed

14 files changed

+834
-2
lines changed

‎content/en/configuration/all.md‎

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,10 +59,26 @@ dataDir
5959
: (`string`) The designated directory for data files. Default is `data`. {{% module-mounts-note %}}
6060

6161
defaultContentLanguage
62-
: (`string`) The project's default language key, conforming to the syntax described in [RFC 5646]. This value must match one of the defined language keys. Default is `en`.
62+
: (`string`) The project's default content language key, conforming to the syntax described in [RFC 5646]. This value must match one of the defined language keys. Default is `en`.
6363

6464
defaultContentLanguageInSubdir
65-
: (`bool`) Whether to publish the default language site to a subdirectory matching the `defaultContentLanguage`. Default is `false`.
65+
: (`bool`) Whether to publish the default content language site to a subdirectory matching the `defaultContentLanguage`. Default is `false`.
66+
67+
defaultContentRole
68+
: {{< new-in 0.150.0 />}}
69+
: (`string`) The site's default content role. Default is `guest`.
70+
71+
defaultContentRoleInSubdir
72+
: {{< new-in 0.150.0 />}}
73+
: (`bool`) Whether to publish the default content role to a subdirectory matching the `defaultContentRole`. Default is `false`.
74+
75+
defaultContentVersion
76+
: {{< new-in 0.150.0 />}}
77+
: (`string`) The site's default content version. Default is `TODO`.
78+
79+
defaultContentVersionInSubdir
80+
: {{< new-in 0.150.0 />}}
81+
: (`bool`) Whether to publish the default content version to a subdirectory matching the `defaultContentVersion`. Default is `false`.
6682

6783
defaultOutputFormat
6884
: (`string`) The default output format for the site. If unspecified, the first available format in the defined order (by weight, then alphabetically) will be used.
@@ -240,6 +256,9 @@ renderSegments
240256
resourceDir
241257
: (`string`) The designated directory for caching output from [asset pipelines](g). Default is `resources`.
242258

259+
roles
260+
: See [configure roles](/configuration/roles/).
261+
243262
security
244263
: See [configure security](/configuration/security/).
245264

@@ -294,6 +313,9 @@ titleCaseStyle
294313
uglyurls
295314
: See [configure ugly URLs](/configuration/ugly-urls/).
296315

316+
versions
317+
: See [configure versions](/configuration/versions/).
318+
297319
## Cache directory
298320

299321
Hugo's file cache directory is configurable via the [`cacheDir`] configuration option or the `HUGO_CACHEDIR` environment variable. If neither is set, Hugo will use, in order of preference:

‎content/en/configuration/roles.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: Configure roles
3+
linkTitle: Roles
4+
description: Configure roles.
5+
categories: []
6+
keywords: []
7+
---
8+
9+
{{< new-in 0.150.0 />}}
10+
11+
This is the default configuration:
12+
13+
{{< code-toggle config=rolls />}}

‎content/en/configuration/versions.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: Configure versions
3+
linkTitle: Versions
4+
description: Configure versions.
5+
categories: []
6+
keywords: []
7+
---
8+
9+
{{< new-in 0.150.0 />}}
10+
11+
This is the default configuration:
12+
13+
{{< code-toggle config=versions />}}

‎content/en/content-management/dimensions/dimensions.ai‎

Lines changed: 589 additions & 0 deletions
Large diffs are not rendered by default.

‎content/en/content-management/dimensions/dimensions.png‎

11.2 KB
Loading

‎content/en/content-management/dimensions/index.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: Dimensions
3+
description: TODO
4+
categories: []
5+
keywords: []
6+
---
7+
8+
{{< new-in 0.150.0 />}}
9+
10+
![line drawing of a 3x3 cube](dimensions.png)
11+
{class="md:w-2/5"}
12+
13+
TODO
14+
15+
<!-- TODO we may not need some of these sentences -->
16+
17+
See [configure languages](/configuration/languages/).
18+
19+
See [configure roles](/configuration/roles/).
20+
21+
See [configure versions](/configuration/versions/).
22+
23+
<!-- TODO we may not need some of these references -->
24+
<!-- markdownlint-disable MD053 -->
25+
<!-- site config -->
26+
[`defaultContentLanguage`]: /configuration/all/#defaultcontentlanguage
27+
[`defaultContentLanguageInSubdir`]: /configuration/all/#defaultcontentlanguageinsubdir
28+
[`defaultContentRoleInSubdir`]: /configuration/all/#defaultcontentrole
29+
[`defaultContentRole`]: /configuration/all/#defaultcontentrole
30+
[`defaultContentRoleInSubdir`]: /configuration/all/#defaultcontentrole
31+
[`defaultContentVersion`]: /configuration/all/#defaultcontentversion
32+
[`defaultContentVersionInSubdir`]: /configuration/all/#defaultcontentversioninsubdir
33+
34+
<!-- site methods -->
35+
[`Dimension`]: /methods/site/dimension/
36+
[`Language`]: /methods/site/language/
37+
[`Languages`]: /methods/site/languages/
38+
[`Role`]: /methods/site/role/
39+
[`Roles`]: /methods/site/roles/
40+
[`Version`]: /methods/site/version/
41+
[`Versions`]: /methods/site/versions/
42+
43+
<!-- front matter -->
44+
[front matter languageDelegees]: /content-management/front-matter/#languagedelegees
45+
[front matter languages]: /content-management/front-matter/#languages
46+
[front matter roleDelegees]: /content-management/front-matter/#roledelegees
47+
[front matter roles]: /content-management/front-matter/#roles
48+
[front matter versionDelegees]: /content-management/front-matter/#versiondelegees
49+
[front matter versions]: /content-management/front-matter/#versions
50+
<!-- markdownlint-enable MD053 -->

‎content/en/content-management/front-matter.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,14 @@ isCJKLanguage
7070
keywords
7171
: (`string array`) An array of keywords, typically rendered within a `meta` element within the `head` element of the published HTML file, or used as a [taxonomy](g) to classify content. Access these values from a template using the [`Keywords`] method on a `Page` object.
7272

73+
languageDelegees
74+
: {{< new-in 0.150.0 />}}
75+
: (`TODO`) TODO.
76+
77+
languages
78+
: {{< new-in 0.150.0 />}}
79+
: (`TODO`) TODO.
80+
7381
lastmod
7482
: (`string`) The date that the page was last modified. Note that the TOML format also supports unquoted date/time values. See the [dates](#dates) section for examples. Access this value from a template using the [`Lastmod`] method on a `Page` object.
7583

@@ -107,6 +115,14 @@ published
107115
resources
108116
: (`map array`) An array of maps to provide metadata for [page resources].
109117

118+
roleDelegees
119+
: {{< new-in 0.150.0 />}}
120+
: (`TODO`) TODO.
121+
122+
roles
123+
: {{< new-in 0.150.0 />}}
124+
: (`TODO`) TODO.
125+
110126
sitemap
111127
: (`map`) A map of sitemap options. See the [sitemap templates] page for details. Access these values from a template using the [`Sitemap`] method on a `Page` object.
112128

@@ -131,6 +147,14 @@ unpublishdate
131147
url
132148
: (`string`) Overrides the entire URL path. Applicable to regular pages and section pages. See the [URL management] page for details.
133149

150+
versionDelegees
151+
: {{< new-in 0.150.0 />}}
152+
: (`TODO`) TODO.
153+
154+
versions
155+
: {{< new-in 0.150.0 />}}
156+
: (`TODO`) TODO.
157+
134158
weight
135159
: (`int`) The page [weight](g), used to order the page within a [page collection](g). Access this value from a template using the [`Weight`] method on a `Page` object.
136160

‎content/en/methods/page/Rotate.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
title: Rotate
3+
description: TODO
4+
categories: []
5+
keywords: []
6+
params:
7+
functions_and_methods:
8+
returnType: page.Pages
9+
signatures: [PAGE.Rotate DIMENSION]
10+
---
11+
12+
{{< new-in 0.150.0 />}}
13+
14+
TODO
15+
16+
<!-- DIMENSION must be one of language, role, or version. -->
17+
18+
```go-html-template
19+
{{ .Rotate "language" }}
20+
```

‎content/en/methods/site/Dimension.md‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
title: Dimension
3+
description: TODO
4+
categories: []
5+
keywords: []
6+
params:
7+
functions_and_methods:
8+
returnType: TODO
9+
signatures: [SITE.Dimension DIMENSION]
10+
---
11+
12+
{{< new-in 0.150.0 />}}
13+
14+
TODO
15+
<!--
16+
Not sure how to document the returned data type; it changes based on the
17+
argument, e.g.,
18+
19+
{{ .Site.Dimension "language" }} => langs.Language
20+
{{ .Site.Dimension "role" }} => roles.RoleSite
21+
{{ .Site.Dimension "version" }} => versions.VersionSite
22+
-->
23+
24+
<!-- DIMENSION must be one of language, role, or version. -->
25+
26+
```go-html-template
27+
{{ .Site.Dimension "language" }}
28+
```

‎content/en/methods/site/Role.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: Role
3+
description: Returns the role configured for this site.
4+
categories: []
5+
keywords: []
6+
params:
7+
functions_and_methods:
8+
returnType: roles.RoleSite
9+
signatures: [SITE.Role]
10+
---
11+
12+
{{< new-in 0.150.0 />}}
13+
14+
TODO
15+
16+
```go-html-template
17+
{{ .Site.Role }}
18+
```

0 commit comments

Comments
 (0)