Skip to content

Commit 656320a

Browse files
authored
Merge pull request #50427 from my-git9/np-9947
[zh-cn]Add contribute/blog/mirroring.md
2 parents 419424e + cc4bb67 commit 656320a

File tree

1 file changed

+143
-0
lines changed

1 file changed

+143
-0
lines changed
Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
---
2+
title: 博客文章镜像
3+
slug: article-mirroring
4+
content_type: concept
5+
weight: 50
6+
---
7+
<!--
8+
title: Blog article mirroring
9+
slug: article-mirroring
10+
content_type: concept
11+
weight: 50
12+
-->
13+
14+
<!-- overview -->
15+
16+
<!--
17+
There are two official Kubernetes blogs, and the CNCF has its own blog where you can cover Kubernetes too.
18+
For the main Kubernetes blog, we (the Kubernetes project) like to publish articles with different perspectives and special focuses, that have a link to Kubernetes.
19+
20+
Some articles appear on both blogs: there is a primary version of the article, and
21+
a _mirror article_ on the other blog.
22+
23+
This page describes the criteria for mirroring, the motivation for mirroring, and
24+
explains what you should do to ensure that an article publishes to both blogs.
25+
-->
26+
官方有两个 Kubernetes 博客,CNCF 也有自己的博客,你也可以在其中了解 Kubernetes。
27+
对于主要的 Kubernetes 博客,我们(Kubernetes 项目)喜欢发表具有不同视角和特别焦点的文章,
28+
这些文章与 Kubernetes 有一定的关联。
29+
30+
有些文章会同时出现在两个博客上:一篇文章是主要版本,另一篇是另一个博客上的**镜像文章**
31+
32+
本文介绍了镜像的标准、镜像的动机,并解释了你应该做什么来确保文章发布到两个博客。
33+
34+
# {{% heading "prerequisites" %}}
35+
36+
<!--
37+
Make sure you are familiar with the introduction sections of
38+
[contributing to Kubernetes blogs](/docs/contribute/blog/), not just to learn about
39+
the two official blogs and the differences between them, but also to get an overview
40+
of the process.
41+
-->
42+
请确保你已熟悉[为 Kubernetes 博客贡献内容](/zh-cn/docs/contribute/blog/)的介绍部分,
43+
这不仅是为了了解两个官方博客及其之间的区别,还能帮助你概览整个发布流程。
44+
45+
<!-- content -->
46+
47+
<!--
48+
## Why we mirror
49+
50+
Mirroring is nearly always from the contributor blog to the main blog. The project does this
51+
for articles that are about the contributor community, or a part of it, but are also relevant
52+
to the wider set of readers for Kubernetes' main blog.
53+
-->
54+
## 为什么要镜像
55+
56+
镜像几乎总是从贡献者博客到主博客。项目组不仅针对有关贡献者社区或一部分文章这么做,
57+
而且和 Kubernetes 主博客更为广泛的读者相关。
58+
59+
<!--
60+
As an author (or reviewer), consider the target audience and whether the blog post is appropriate for the [main blog](/docs/contribute/blog/#main-blog).
61+
For example: if the target audience are Kubernetes contributors only, then the
62+
[contributor blog](/docs/contribute/blog/#contributor-blog).
63+
may be more appropriate;
64+
if the blog post is about open source in general then it may be more suitable on another site outside the Kubernetes project.
65+
66+
This consideration about target audience applies to original and mirrored articles equally.
67+
-->
68+
作为作者(或评审者),请考虑目标受众,并判断该博客文章是否适合发布在[主博客](/zh-cn/docs/contribute/blog/#main-blog)上。
69+
例如:如果目标受众仅限于 Kubernetes 的贡献者,
70+
那么[贡献者博客](/zh-cn/docs/contribute/blog/#contributor-blog)可能更为合适;
71+
如果博客文章是关于开源的普遍话题,那么它可能更适合发布在 Kubernetes 项目之外的其他网站上。
72+
73+
这种对目标受众的考量同样适用于原创文章和镜像文章。
74+
75+
<!--
76+
The Kubernetes project is willing to mirror any blog article that was published to https://kubernetes.dev/blog/
77+
(the contributor blog), provided that all of the following criteria are met:
78+
79+
- the mirrored article has the same publication date as the original (it should have the same publication time too,
80+
but you can also set a time stamp up to 12 hours later for special cases)
81+
82+
- For PRs that add a mirrored article to the main blog *after* the original article has merged into the contributor blog, ensure that all of the following criteria are met:
83+
- No articles were published to the main blog after the original article was published to the contributor blog.
84+
- There are no main blog articles scheduled for publication between the publication time of the original article and the publication time of your mirrored article.
85+
86+
This is because the Kubernetes project doesn't want to add articles to people's feeds, such as RSS, except at the very end of their feed.
87+
-->
88+
Kubernetes 项目愿意镜像任何发布在 https://kubernetes.dev/blog/ (贡献者博客)上的文章,但前提是满足以下所有条件:
89+
90+
- 镜像文章的发布日期必须与原始文章相同(发布时间也应相同,但在特殊情况下,可以设置最多延迟 12 小时的时间戳)。
91+
92+
- 对于在原始文章已合并到贡献者博客**之后**,向主博客添加镜像文章的 PR,请确保满足以下所有条件:
93+
- 在原始文章发布到贡献者博客之后,没有文章发布到主博客。
94+
- 在原始文章的发布时间和镜像文章的发布时间之间,主博客没有文章发布计划。
95+
96+
这是因为 Kubernetes 项目不希望在人们的订阅源(例如 RSS)中插入文章,除非是在订阅源的末尾。
97+
98+
<!--
99+
- the original article doesn't contravene any strongly recommended review guidelines or community norms
100+
101+
- the mirrored article will have `canonicalUrl` set correctly in its
102+
[front matter](https://gohugo.io/content-management/front-matter/)
103+
-->
104+
- 原始文章不违反任何强烈推荐的评审指南或社区规范。
105+
106+
- 镜像文章的 `canonicalUrl` 将在其[前言](https://gohugo.io/content-management/front-matter/)中正确设置。
107+
`canonicalUrl`
108+
109+
<!--
110+
- the audience for the original article would find it relevant
111+
112+
- the article content is not off-topic for the target blog where the mirror article would
113+
appear
114+
115+
116+
Mirroring from the main blog to the contributor blog is rare, but could feasibly happen.
117+
-->
118+
- 原文章的读者会认为其相关
119+
120+
- 文章内容与镜像文章出现的目标博客主题一致
121+
122+
从主博客到贡献者博客的镜像操作很少见,但理论上是可行的。
123+
124+
<!--
125+
## How to mirror
126+
127+
You make a PR against the other Git repository (usually,
128+
[https://github.com/kubernetes/website](https://github.com/kubernetes/website)) that adds
129+
the article. You do this _before_ the articles merge.
130+
131+
As the article author, you should set the canonical URL for the mirrored article, to the URL of the original article
132+
(you can use a preview to predict the URL and fill this in ahead of actual publication). Use the `canonicalUrl`
133+
field in [front matter](https://gohugo.io/content-management/front-matter/) for this.
134+
-->
135+
## 如何镜像
136+
137+
你需要向另一个 Git 仓库(通常是 [https://github.com/kubernetes/website](https://github.com/kubernetes/website)
138+
提交一个 PR,以添加该文章。此操作应在文章合并**之前**完成。
139+
140+
作为文章的作者,你应该为镜像文章设置规范 URL,
141+
并将其指向原始文章的 URL(你可以使用预览功能预测 URL,并在实际发布前填写此内容)。
142+
[前言](https://gohugo.io/content-management/front-matter/)中使用
143+
`canonicalUrl` 字段来完成这一设置。

0 commit comments

Comments
 (0)