|
| 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