Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[zh] updated 2 files in content/zh/docs/contribute/new-content/ #33648

Merged
merged 1 commit into from
May 15, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 101 additions & 14 deletions content/zh/docs/contribute/new-content/blogs-case-studies.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,14 +34,78 @@ Anyone can write a blog post and submit it for review.
-->
## Kubernetes 博客

Kubernetes 博客用于项目发布新功能特性、社区报告以及其他一些可能对整个社区
很重要的新闻
Kubernetes 博客用于项目发布新功能特性、
社区报告以及其他一些可能对整个社区很重要的新闻
其读者包括最终用户和开发人员。
大多数博客的内容是关于核心项目中正在发生的事情,不过我们也鼓励你提交一些
关于生态系统中其他地方发生的事情的博客
大多数博客的内容是关于核心项目中正在发生的事情,
不过我们也鼓励你提交一些有关生态系统中其他时事的博客

任何人都可以撰写博客并提交评阅。

<!--
### Submit a Post

Blog posts should not be commercial in nature and should consist of original content that applies broadly to the Kubernetes community.
Appropriate blog content includes:

- New Kubernetes capabilities
- Kubernetes projects updates
- Updates from Special Interest Groups
- Tutorials and walkthroughs
- Thought leadership around Kubernetes
- Kubernetes Partner OSS integration
- **Original content only**
-->
### 提交博文

博文不应该是商业性质的,应该包含广泛适用于 Kubernetes 社区的原创内容。
合适的博客内容包括:

- Kubernetes 新能力
- Kubernetes 项目更新信息
- 来自特别兴趣小组(Special Interest Groups, SIG)的更新信息
- 教程和演练
- 有关 Kubernetes 的纲领性理念
- Kubernetes 合作伙伴 OSS 集成信息
- **仅限原创内容**

<!--
Unsuitable content includes:

- Vendor product pitches
- Partner updates without an integration and customer story
- Syndicated posts (language translations ok)
-->

不合适的博客内容包括:

- 供应商产品推介
- 不含集成信息和客户故事的合作伙伴更新信息
- 已发表的博文(可刊登博文译稿)

<!--
To submit a blog post, follow these steps:

1. [Sign the CLA](https://kubernetes.io/docs/contribute/start/#sign-the-cla) if you have not yet done so.
1. Have a look at the Markdown format for existing blog posts in the [website repository](https://github.com/kubernetes/website/tree/master/content/en/blog/_posts).
1. Write out your blog post in a text editor of your choice.
1. On the same link from step 2, click the Create new file button. Paste your content into the editor. Name the file to match the proposed title of the blog post, but don’t put the date in the file name. The blog reviewers will work with you on the final file name and the date the blog will be published.
1. When you save the file, GitHub will walk you through the pull request process.
1. A blog post reviewer will review your submission and work with you on feedback and final details. When the blog post is approved, the blog will be scheduled for publication.
-->
要提交博文,你可以遵从以下步骤:

1. 如果你还未签署 CLA,请先[签署 CLA](https://kubernetes.io/docs/contribute/start/#sign-the-cla)。
2. 查阅[网站仓库](https://github.com/kubernetes/website/tree/master/content/en/blog/_posts)中现有博文的 Markdown 格式。
3. 在你所选的文本编辑器中撰写你的博文。
4. 在第 2 步的同一链接上,点击 **Create new file** 按钮。
将你的内容粘贴到编辑器中。为文件命名,使其与提议的博文标题一致,
但不要在文件名中写日期。
博客评阅者将与你一起确定最终的文件名和发表博客的日期。
5. 保存文件时,GitHub 将引导你完成 PR 流程。
6. 博客评阅者将评阅你提交的内容,并与你一起处理反馈和最终细节。
当博文被批准后,博客将排期发表。

<!--
### Guidelines and expectations

Expand Down Expand Up @@ -74,7 +138,7 @@ Kubernetes 博客用于项目发布新功能特性、社区报告以及其他一
- 博客内容并非在某特定日期发表。
- 文章会交由社区自愿者评阅。我们会尽力满足特定的时限要求,只是无法就此作出承诺。
- Kubernetes 项目的很多核心组件会在发布窗口期内提交博客文章,导致发表时间被推迟。
因此,请考虑在发布周期内较为平静的时间段提交博文
因此,请考虑在发布周期内较为平静的时间段提交博客文章
- 如果你希望就博文发表日期上进行较大范围的协调,请联系
[CNCF 推广团队](https://www.cncf.io/about/contact/)。
这也许是比提交博客文章更合适的一种选择。
Expand All @@ -87,6 +151,7 @@ Kubernetes 博客用于项目发布新功能特性、社区报告以及其他一
- The components of Kubernetes are purposely modular, so tools that use existing integration points like CNI and CSI are on topic.
- Posts about other CNCF projects may or may not be on topic. We recommend asking the blog team before submitting a draft.
- Many CNCF projects have their own blog. These are often a better choice for posts. There are times of major feature or milestone for a CNCF project that users would be interested in reading on the Kubernetes blog.
- Blog posts about contributing to the Kubernetes project should be in the [Kubernetes Contributors site](https://kubernetes.dev)
-->
- 博客内容应该对 Kubernetes 用户有用。
- 与参与 Kubernetes SIGs 活动相关,或者与这类活动的结果相关的主题通常是切题的。
Expand All @@ -98,6 +163,7 @@ Kubernetes 博客用于项目发布新功能特性、社区报告以及其他一
- 很多 CNCF 项目有自己的博客。这些博客通常是更好的选择。
有些时候,某个 CNCF 项目的主要功能特性或者里程碑的变化可能是用户有兴趣在
Kubernetes 博客上阅读的内容。
- 关于为 Kubernetes 项目做贡献的博客内容应该放在 [Kubernetes 贡献者站点](https://kubernetes.dev)上。
<!--
- Blog posts should be original content
- The official blog is not for repurposing existing content from a third party as new content.
Expand Down Expand Up @@ -126,7 +192,7 @@ We recognize that this requirement makes the process more difficult for less-fam
-->
### 提交博客的技术考虑

所提交的内容应该是 Markdown 格式的,以便能够被[Hugo](https://gohugo.io/) 生成器来处理。
所提交的内容应该是 Markdown 格式的,以便能够被 [Hugo](https://gohugo.io/) 生成器来处理。
关于如何使用相关技术,有[很多可用的资源](https://gohugo.io/documentation/)。

我们知道这一需求可能给那些对此过程不熟悉的朋友们带来不便,
Expand All @@ -141,7 +207,6 @@ To submit a blog post follow these directions:
SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject) 负责管理博客的评阅过程。
更多信息可参考[提交博文](https://github.com/kubernetes/community/tree/master/sig-docs/blog-subproject#submit-a-post)。


要提交博文,你可以遵从以下指南:
<!--
- [Open a pull request](/docs/contribute/new-content/open-a-pr/#fork-the-repo) with a new blog post. New blog posts go under the [`content/en/blog/_posts`](https://github.com/kubernetes/website/tree/main/content/en/blog/_posts) directory.
Expand All @@ -152,7 +217,7 @@ SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/s
- Do **not** include dots in the filename. A name like `2020-01-01-whats-new-in-1.19.md` causes failures during a build.
- The front matter must include the following:
-->
- [发起一个包含博文的 PR](/zh/docs/contribute/new-content/open-a-pr/#fork-the-repo)。
- [发起一个包含新博文的 PR](/zh/docs/contribute/new-content/open-a-pr/#fork-the-repo)。
新博文要创建于 [`content/en/blog/_posts`](https://github.com/kubernetes/website/tree/main/content/en/blog/_posts) 目录下。

- 确保你的博文遵从合适的命名规范,并带有下面的引言(元数据)信息:
Expand Down Expand Up @@ -198,6 +263,30 @@ SIG Docs [博客子项目](https://github.com/kubernetes/community/tree/master/s
- 博客团队会对 PR 内容进行评阅,为你提供一些评语以便修订。
之后,机器人会将你的博文合并并发表。

<!--
- If the content of the blog post contains only content that is not expected to require updates to stay accurate for the reader, it can be marked as evergreen and exempted from the automatic warning about outdated content added to blog posts older than one year.
- To mark a blog post as evergreen, add this to the front matter:

```yaml
evergreen: true
```
- Examples of content that should not be marked evergreen:
- **Tutorials** that only apply to specific releases or versions and not all future versions
- References to pre-GA APIs or features
-->

- 如果博文的内容仅包含预期无需更新就能对读者保持精准的内容,
则可以将这篇博文标记为长期有效(evergreen),
且免除添加博文发表一年后内容过期的自动警告。
- 要将一篇博文标记为长期有效,请在引言部分添加以下标记:

```yaml
evergreen: true
```
- 不应标记为长期有效的内容示例:
- 仅适用于特定发行版或版本而不是所有未来版本的**教程**
- 对非正式发行(Pre-GA)API 或功能特性的引用

<!--
## Submit a case study

Expand All @@ -212,13 +301,11 @@ Refer to the [case study guidelines](https://github.com/cncf/foundation/blob/mas
## 提交案例分析

案例分析用来概述组织如何使用 Kubernetes 解决现实世界的问题。
Kubernetes 市场化团队和 {{< glossary_tooltip text="CNCF" term_id="cncf" >}} 成员
会与你一起工作,撰写所有的案例分析。
Kubernetes 市场化团队和 {{< glossary_tooltip text="CNCF" term_id="cncf" >}} 成员会与你一起工作,
撰写所有的案例分析。

请查看
[现有案例分析](https://github.com/kubernetes/website/tree/main/content/en/case-studies)
的源码。
请查看[现有案例分析](https://github.com/kubernetes/website/tree/main/content/en/case-studies)的源码。

参考[案例分析指南](https://github.com/cncf/foundation/blob/master/case-study-guidelines.md)
参考[案例分析指南](https://github.com/cncf/foundation/blob/master/case-study-guidelines.md)
根据指南中的注意事项提交你的 PR 请求。

Loading