You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+22-1Lines changed: 22 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -55,10 +55,20 @@ To build the site in a container, run the following:
55
55
56
56
```bash
57
57
# You can set $CONTAINER_ENGINE to the name of any Docker-like container tool
58
+
59
+
# Render the full website
58
60
make container-serve
61
+
62
+
# Render only a specific language segment (e.g., English)
63
+
make container-serve segments=en
64
+
65
+
# Render multiple languages (e.g., English and Korean)
66
+
make container-serve segments=en,ko
59
67
```
60
68
61
-
If you see errors, it probably means that the hugo container did not have enough computing resources available. To solve it, increase the amount of allowed CPU and memory usage for Docker on your machine ([MacOS](https://docs.docker.com/desktop/settings/mac/) and [Windows](https://docs.docker.com/desktop/settings/windows/)).
69
+
**💡 Tip:** Using _Hugo segments_ speeds up local preview builds, by rendering only selected language(s).
70
+
71
+
If you see errors, it probably means that the Hugo container did not have enough computing resources available. To solve it, increase the amount of allowed CPU and memory usage for Docker on your machine ([macOS](https://docs.docker.com/desktop/settings/mac/) and [Windows](https://docs.docker.com/desktop/settings/windows/)).
62
72
63
73
Open up your browser to <http://localhost:1313> to view the website. As you make changes to the source files, Hugo updates the website and forces a browser refresh.
64
74
@@ -70,9 +80,19 @@ To install dependencies, deploy and test the site locally, run:
70
80
71
81
```bash
72
82
npm ci
83
+
84
+
# Render the full site (default)
73
85
make serve
86
+
87
+
# Render only a specific language segment
88
+
make serve segments=en
89
+
90
+
# Render multiple language segments
91
+
make serve segments=en,ko
74
92
```
75
93
94
+
**💡 Tip:** Hugo segments are defined in `hugo.toml` and allow faster rendering by limiting the scope to specific language(s).
95
+
76
96
- For Windows (PowerShell)
77
97
78
98
```powershell
@@ -82,6 +102,7 @@ To install dependencies, deploy and test the site locally, run:
82
102
83
103
This will start the local Hugo server on port 1313. Open up your browser to <http://localhost:1313> to view the website. As you make changes to the source files, Hugo updates the website and forces a browser refresh.
84
104
105
+
85
106
## Building the API reference pages
86
107
87
108
The API reference pages located in `content/en/docs/reference/kubernetes-api` are built from the Swagger specification, also known as OpenAPI specification, using <https://github.com/kubernetes-sigs/reference-docs/tree/master/gen-resourcesdocs>.
0 commit comments