Skip to content

Commit 6ff6bb5

Browse files
Merge pull request #1 from kubernetes/master
update
2 parents 2c4bc30 + 4ef03eb commit 6ff6bb5

File tree

1,129 files changed

+40203
-20597
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,129 files changed

+40203
-20597
lines changed

Dockerfile

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,9 @@ RUN apk add --no-cache \
1414
openssh-client \
1515
rsync \
1616
build-base \
17-
libc6-compat
17+
libc6-compat \
18+
npm && \
19+
npm install -G autoprefixer postcss-cli
1820

1921
ARG HUGO_VERSION
2022

Makefile

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ NETLIFY_FUNC = $(NODE_BIN)/netlify-lambda
66
# but this can be overridden when calling make, e.g.
77
# CONTAINER_ENGINE=podman make container-image
88
CONTAINER_ENGINE ?= docker
9-
CONTAINER_IMAGE = kubernetes-hugo
9+
IMAGE_VERSION=$(shell scripts/hash-files.sh Dockerfile Makefile | cut -c 1-12)
10+
CONTAINER_IMAGE = kubernetes-hugo:v$(HUGO_VERSION)-$(IMAGE_VERSION)
1011
CONTAINER_RUN = $(CONTAINER_ENGINE) run --rm --interactive --tty --volume $(CURDIR):/src
1112

1213
CCRED=\033[0;31m
@@ -64,7 +65,7 @@ container-image:
6465
--build-arg HUGO_VERSION=$(HUGO_VERSION)
6566

6667
container-build: module-check
67-
$(CONTAINER_RUN) $(CONTAINER_IMAGE) hugo
68+
$(CONTAINER_RUN) $(CONTAINER_IMAGE) hugo --minify
6869

6970
container-serve: module-check
7071
$(CONTAINER_RUN) --mount type=tmpfs,destination=/src/resources,tmpfs-mode=0755 -p 1313:1313 $(CONTAINER_IMAGE) hugo server --buildFuture --bind 0.0.0.0

OWNERS_ALIASES

Lines changed: 3 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,4 @@
11
aliases:
2-
sig-cluster-lifecycle-kubeadm-approvers: # Approving changes to kubeadm documentation
3-
- timothysc
4-
- lukemarsden
5-
- luxas
6-
- fabriziopandini
7-
sig-cluster-lifecycle-kubeadm-reviewers: # Reviewing kubeadm documentation
8-
- timothysc
9-
- lukemarsden
10-
- luxas
11-
- fabriziopandini
12-
- kad
13-
- xiangpengzhao
14-
- stealthybox
15-
- liztio
16-
- chuckha
17-
- detiber
18-
- dixudx
192
sig-docs-blog-owners: # Approvers for blog content
203
- castrojo
214
- kbarnard10
@@ -124,10 +107,12 @@ aliases:
124107
- danninov
125108
sig-docs-it-owners: # Admins for Italian content
126109
- fabriziopandini
110+
- Fale
127111
- mattiaperi
128112
- micheleberardi
129113
sig-docs-it-reviews: # PR reviews for Italian content
130114
- fabriziopandini
115+
- Fale
131116
- mattiaperi
132117
- micheleberardi
133118
sig-docs-ja-owners: # Admins for Japanese content
@@ -209,6 +194,7 @@ aliases:
209194
- potapy4
210195
- dianaabv
211196
sig-docs-ru-reviews: # PR reviews for Russian content
197+
- Arhell
212198
- msheldyakov
213199
- aisonaku
214200
- potapy4

README-ja.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
# Kubernetesのドキュメント
22

3-
[![Build Status](https://api.travis-ci.org/kubernetes/website.svg?branch=master)](https://travis-ci.org/kubernetes/website)
4-
[![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
3+
[![Netlify Status](https://api.netlify.com/api/v1/badges/be93b718-a6df-402a-b4a4-855ba186c97d/deploy-status)](https://app.netlify.com/sites/kubernetes-io-master-staging/deploys) [![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
54

65
このリポジトリには、[KubernetesのWebサイトとドキュメント](https://kubernetes.io/)をビルドするために必要な全アセットが格納されています。貢献に興味を持っていただきありがとうございます!
76

@@ -14,7 +13,20 @@ Hugoがインストールできたら、以下のコマンドを使ってWebサ
1413
```bash
1514
git clone https://github.com/kubernetes/website.git
1615
cd website
17-
git submodule update --init --recursive
16+
git submodule update --init --recursive --depth 1
17+
```
18+
19+
**注意:** Kubernetesのウェブサイトでは[DocsyというHugoのテーマ](https://github.com/google/docsy#readme)を使用しています。リポジトリを更新していない場合、 `website/themes/docsy`ディレクトリは空です。 このサイトはテーマのローカルコピーなしでは構築できません。
20+
21+
テーマをアップデートするには以下のコマンドを実行します:
22+
23+
```bash
24+
git submodule update --init --recursive --depth 1
25+
```
26+
27+
サイトをローカルでビルドしてテストするには以下のコマンドを実行します:
28+
29+
```bash
1830
hugo server --buildFuture
1931
```
2032

@@ -33,11 +45,11 @@ hugo server --buildFuture
3345

3446
GitHubの画面右上にある**Fork**ボタンをクリックすると、お使いのGitHubアカウントに紐付いた本リポジトリのコピーが作成され、このコピーのことを*フォーク*と呼びます。フォークリポジトリの中ではお好きなように変更を加えていただいて構いません。加えた変更をこのリポジトリに追加したい任意のタイミングにて、フォークリポジトリからPull Reqeustを作成してください。
3547

36-
Pull Requestが作成されると、レビュー担当者が責任を持って明確かつ実用的なフィードバックを返します。
37-
Pull Requestの所有者は作成者であるため、**ご自身で作成したPull Requestを編集し、フィードバックに対応するのはご自身の役目です。**
48+
Pull Requestが作成されると、レビュー担当者が責任を持って明確かつ実用的なフィードバックを返します。Pull Requestの所有者は作成者であるため、**ご自身で作成したPull Requestを編集し、フィードバックに対応するのはご自身の役目です。**
49+
3850
また、状況によっては2人以上のレビュアーからフィードバックが返されたり、アサインされていないレビュー担当者からのフィードバックが来ることがある点もご注意ください。
39-
さらに、特定のケースにおいては、レビュー担当者がKubernetesの技術的なレビュアーに対してレビューを依頼することもあります。
40-
レビュー担当者はタイムリーにフィードバックを提供するために最善を尽くしますが、応答時間は状況に応じて異なる場合があります。
51+
52+
さらに、特定のケースにおいては、レビュー担当者がKubernetesの技術的なレビュアーに対してレビューを依頼することもあります。レビュー担当者はタイムリーにフィードバックを提供するために最善を尽くしますが、応答時間は状況に応じて異なる場合があります。
4153

4254
Kubernetesのドキュメントへの貢献に関する詳細については以下のページをご覧ください:
4355

README.md

Lines changed: 40 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4,37 +4,61 @@
44

55
This repository contains the assets required to build the [Kubernetes website and documentation](https://kubernetes.io/). We're glad that you want to contribute!
66

7-
## Running the website locally using Hugo
7+
# Using this repository
88

9-
See the [official Hugo documentation](https://gohugo.io/getting-started/installing/) for Hugo installation instructions. Make sure to install the Hugo extended version specified by the `HUGO_VERSION` environment variable in the [`netlify.toml`](netlify.toml#L10) file.
9+
You can run the website locally using Hugo, or you can run it in a container runtime. We strongly recommend using the container runtime, as it gives deployment consistency with the live website.
1010

11-
Before building the site, clone the Kubernetes website repository:
11+
## Prerequisites
1212

13-
```bash
13+
To use this repository, you need the following installed locally:
14+
15+
- [yarn](https://yarnpkg.com/)
16+
- [npm](https://www.npmjs.com/)
17+
- [Go](https://golang.org/)
18+
- [Hugo](https://gohugo.io/)
19+
- A container runtime, like [Docker](https://www.docker.com/).
20+
21+
Before you start, install the dependencies. Clone the repository and navigate to the directory:
22+
23+
```
1424
git clone https://github.com/kubernetes/website.git
1525
cd website
16-
git submodule update --init --recursive --depth 1
1726
```
1827

19-
**Note:** The Kubernetes website deploys the [Docsy Hugo theme](https://github.com/google/docsy#readme).
20-
If you have not updated your website repository, the `website/themes/docsy` directory is empty. The site cannot build
21-
without a local copy of the theme.
28+
The Kubernetes website uses the [Docsy Hugo theme](https://github.com/google/docsy#readme). Even if you plan to run the website in a container, we strongly recommend pulling in the submodule and other development dependencies by running the following:
2229

23-
Update the website theme:
30+
```
31+
# install dependencies
32+
yarn
2433
25-
```bash
34+
# pull in the Docsy submodule
2635
git submodule update --init --recursive --depth 1
2736
```
2837

38+
## Running the website using a container
39+
40+
To build the site in a container, run the following to build the container image and run it:
41+
42+
```
43+
make container-image
44+
make container-serve
45+
```
46+
47+
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.
48+
49+
## Running the website locally using Hugo
50+
51+
Make sure to install the Hugo extended version specified by the `HUGO_VERSION` environment variable in the [`netlify.toml`](netlify.toml#L10) file.
52+
2953
To build and test the site locally, run:
3054

3155
```bash
32-
hugo server --buildFuture
56+
make serve
3357
```
3458

3559
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.
3660

37-
## Get involved with SIG Docs
61+
# Get involved with SIG Docs
3862

3963
Learn more about SIG Docs Kubernetes community and meetings on the [community page](https://github.com/kubernetes/community/tree/master/sig-docs#meetings).
4064

@@ -43,7 +67,7 @@ You can also reach the maintainers of this project at:
4367
- [Slack](https://kubernetes.slack.com/messages/sig-docs)
4468
- [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
4569

46-
## Contributing to the docs
70+
# Contributing to the docs
4771

4872
You can click the **Fork** button in the upper-right area of the screen to create a copy of this repository in your GitHub account. This copy is called a *fork*. Make any changes you want in your fork, and when you are ready to send those changes to us, go to your fork and create a new pull request to let us know about it.
4973

@@ -60,7 +84,7 @@ For more information about contributing to the Kubernetes documentation, see:
6084
* [Documentation Style Guide](https://kubernetes.io/docs/contribute/style/style-guide/)
6185
* [Localizing Kubernetes Documentation](https://kubernetes.io/docs/contribute/localization/)
6286

63-
## Localization `README.md`'s
87+
# Localization `README.md`'s
6488

6589
| Language | Language |
6690
|---|---|
@@ -72,10 +96,10 @@ For more information about contributing to the Kubernetes documentation, see:
7296
|[Italian](README-it.md)|[Ukrainian](README-uk.md)|
7397
|[Japanese](README-ja.md)|[Vietnamese](README-vi.md)|
7498

75-
## Code of conduct
99+
# Code of conduct
76100

77101
Participation in the Kubernetes community is governed by the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/master/code-of-conduct.md).
78102

79-
## Thank you!
103+
# Thank you!
80104

81105
Kubernetes thrives on community participation, and we appreciate your contributions to our website and our documentation!

SECURITY.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Security Policy
2+
3+
## Security Announcements
4+
5+
Join the [kubernetes-security-announce] group for security and vulnerability announcements.
6+
7+
You can also subscribe to an RSS feed of the above using [this link][kubernetes-security-announce-rss].
8+
9+
## Reporting a Vulnerability
10+
11+
Instructions for reporting a vulnerability can be found on the
12+
[Kubernetes Security and Disclosure Information] page.
13+
14+
## Supported Versions
15+
16+
Information about supported Kubernetes versions can be found on the
17+
[Kubernetes version and version skew support policy] page on the Kubernetes website.
18+
19+
[kubernetes-security-announce]: https://groups.google.com/forum/#!forum/kubernetes-security-announce
20+
[kubernetes-security-announce-rss]: https://groups.google.com/forum/feed/kubernetes-security-announce/msgs/rss_v2_0.xml?num=50
21+
[Kubernetes version and version skew support policy]: https://kubernetes.io/docs/setup/release/version-skew-policy/#supported-versions
22+
[Kubernetes Security and Disclosure Information]: https://kubernetes.io/docs/reference/issues-security/security/#report-a-vulnerability

assets/scss/_base.scss

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -511,7 +511,7 @@ section#cncf {
511511
}
512512

513513
#desktopKCButton {
514-
position: relative;
514+
position: absolute;
515515
font-size: 18px;
516516
background-color: $dark-grey;
517517
border-radius: 8px;

assets/scss/_custom.scss

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
$announcement-size-adjustment: 8px;
2+
13
/* GLOBAL */
24
.td-main {
35
.row {
@@ -390,4 +392,32 @@ main.content {
390392
}
391393
}
392394
}
393-
}
395+
}
396+
397+
/* ANNOUNCEMENTS */
398+
section#fp-announcement ~ .header-hero {
399+
padding: $announcement-size-adjustment 0;
400+
401+
> div {
402+
margin-top: $announcement-size-adjustment;
403+
margin-bottom: $announcement-size-adjustment;
404+
}
405+
406+
h1, h2, h3, h4, h5 {
407+
margin: $announcement-size-adjustment 0;
408+
}
409+
}
410+
411+
section#announcement ~ .header-hero {
412+
padding: #{$announcement-size-adjustment / 2} 0;
413+
414+
> div {
415+
margin-top: #{$announcement-size-adjustment / 2};
416+
margin-bottom: #{$announcement-size-adjustment / 2};
417+
padding-bottom: #{$announcement-size-adjustment / 2};
418+
}
419+
420+
h1, h2, h3, h4, h5 {
421+
margin: #{$announcement-size-adjustment / 2} 0;
422+
}
423+
}

assets/scss/_tablet.scss

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ $main-nav-left-button-size: 50px;
2323
$main-nav-left-button-font-size: 18px;
2424

2525
// hero
26-
$hero-padding-top: 136px;
26+
$hero-padding-top: 116px;
2727
$headline-wrapper-margin-bottom: 40px;
2828
$quickstart-button-padding: 0 50px;
2929
$vendor-strip-font-size: 16px;
@@ -91,13 +91,15 @@ $feature-box-div-width: 45%;
9191
max-width: 25%;
9292
max-height: 100%;
9393
transform: translateY(-50%);
94+
width: 100%;
9495
}
9596

9697
&:nth-child(odd) {
9798
padding-right: 210px;
9899

99100
.image-wrapper {
100101
right: 0;
102+
text-align: right;
101103
}
102104
}
103105

@@ -106,6 +108,7 @@ $feature-box-div-width: 45%;
106108

107109
.image-wrapper {
108110
left: 0;
111+
text-align: left;
109112
}
110113
}
111114

0 commit comments

Comments
 (0)