Fix tocs and template in docs/home/contribute (#8998)
These pages did not use any template and the displayed toc started with two bullet points. Fixes: * Use the concept template everywhere and add capture markers. * Rework content-organization.md to move the references to a "whatsnext" section. * Fix in localization.md a misparsed list.
This commit is contained in:
committed by
k8s-ci-robot
parent
560932ae4e
commit
200dd071a4
@@ -1,16 +1,19 @@
|
|||||||
---
|
---
|
||||||
title: Content Organization
|
title: Content Organization
|
||||||
date: 2018-04-30
|
date: 2018-04-30
|
||||||
|
content_template: templates/concept
|
||||||
weight: 42
|
weight: 42
|
||||||
---
|
---
|
||||||
|
|
||||||
|
{{< toc >}}
|
||||||
|
|
||||||
|
{{% capture overview %}}
|
||||||
|
|
||||||
This site uses Hugo. In Hugo, [content organization](https://gohugo.io/content-management/organization/) is a core concept.
|
This site uses Hugo. In Hugo, [content organization](https://gohugo.io/content-management/organization/) is a core concept.
|
||||||
|
|
||||||
Also see:
|
{{% /capture %}}
|
||||||
|
|
||||||
* [Custom Hugo Shortcodes](/docs/home/contribute/includes)
|
|
||||||
* [Style Guide](/docs/home/contribute/style-guide)
|
|
||||||
|
|
||||||
|
{{% capture body %}}
|
||||||
|
|
||||||
{{% note %}}
|
{{% note %}}
|
||||||
**Hugo Tip:** Start Hugo with `hugo server --navigateToChanged` for content edit-sessions.
|
**Hugo Tip:** Start Hugo with `hugo server --navigateToChanged` for content edit-sessions.
|
||||||
@@ -128,3 +131,12 @@ Some important notes to the files in the bundles:
|
|||||||
|
|
||||||
The `SASS` source of the stylesheets for this site is stored below `src/sass` and can be built with `make sass` (note that Hugo will get `SASS` support soon, see https://github.com/gohugoio/hugo/issues/4243).
|
The `SASS` source of the stylesheets for this site is stored below `src/sass` and can be built with `make sass` (note that Hugo will get `SASS` support soon, see https://github.com/gohugoio/hugo/issues/4243).
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
|
|
||||||
|
{{% capture whatsnext %}}
|
||||||
|
|
||||||
|
* [Custom Hugo Shortcodes](/docs/home/contribute/includes)
|
||||||
|
* [Style Guide](/docs/home/contribute/style-guide)
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
|
|
||||||
|
|||||||
@@ -1,14 +1,23 @@
|
|||||||
---
|
---
|
||||||
title: Localizing Kubernetes Documentation
|
title: Localizing Kubernetes Documentation
|
||||||
|
content_template: templates/concept
|
||||||
approvers:
|
approvers:
|
||||||
- chenopis
|
- chenopis
|
||||||
- zacharysarah
|
- zacharysarah
|
||||||
---
|
---
|
||||||
|
|
||||||
|
{{% capture overview %}}
|
||||||
|
|
||||||
We're happy to add localizations (l10n) of Kubernetes documentation to the website!
|
We're happy to add localizations (l10n) of Kubernetes documentation to the website!
|
||||||
|
|
||||||
Localizations must meet the following requirements for _workflow_ (how to localize) and _output_ (what to localize).
|
Localizations must meet the following requirements for _workflow_ (how to localize) and _output_ (what to localize).
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
|
|
||||||
|
{{< toc >}}
|
||||||
|
|
||||||
|
{{% capture body %}}
|
||||||
|
|
||||||
## Workflow
|
## Workflow
|
||||||
|
|
||||||
All l10n work must be stored and tracked within the [Kubernetes organization](https://github.com/kubernetes).
|
All l10n work must be stored and tracked within the [Kubernetes organization](https://github.com/kubernetes).
|
||||||
@@ -72,12 +81,18 @@ Home | [All heading and subheading URLs](https://kubernetes.io/docs/home/)
|
|||||||
Setup | [All heading and subheading URLs](https://kubernetes.io/docs/setup/)
|
Setup | [All heading and subheading URLs](https://kubernetes.io/docs/setup/)
|
||||||
Tutorials | [Kubernetes Basics](https://kubernetes.io/docs/tutorials/), [Hello Minikube](https://kubernetes.io/docs/tutorials/stateless-application/hello-minikube/)
|
Tutorials | [Kubernetes Basics](https://kubernetes.io/docs/tutorials/), [Hello Minikube](https://kubernetes.io/docs/tutorials/stateless-application/hello-minikube/)
|
||||||
|
|
||||||
## Next steps
|
{{% /capture %}}
|
||||||
|
|
||||||
|
{{% capture whatsnext %}}
|
||||||
|
|
||||||
Once a l10n meets requirements for workflow and minimum output, SIG docs will:
|
Once a l10n meets requirements for workflow and minimum output, SIG docs will:
|
||||||
- Work with the localization team to implement language selection on the website
|
|
||||||
|
- Work with the localization team to implement language selection on the website.
|
||||||
- Publicize availability through [Cloud Native Computing Foundation](https://www.cncf.io/) (CNCF) channels.
|
- Publicize availability through [Cloud Native Computing Foundation](https://www.cncf.io/) (CNCF) channels.
|
||||||
|
|
||||||
{{< note >}}
|
{{< note >}}
|
||||||
**Note:** Implementation of language selection is pending Kubernetes' first completed localization project.
|
**Note:** Implementation of language selection is pending Kubernetes' first completed localization project.
|
||||||
{{< /note >}}
|
{{< /note >}}
|
||||||
|
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
|
|||||||
Reference in New Issue
Block a user