博客文章镜像

Kubernetes 有两个官方博客,CNCF 也有自己的博客,您可以在其中介绍 Kubernetes。对于主 Kubernetes 博客,我们(Kubernetes 项目)喜欢发表具有不同视角和特殊侧重点,且与 Kubernetes 有关联的文章。

有些文章会同时出现在两个博客上:一篇主版本文章,以及在另一个博客上的镜像文章

本文介绍文章镜像的标准、镜像的动机,并解释您应如何操作以确保文章能同时发布到两个博客上。

开始之前

请确保您熟悉 贡献 Kubernetes 博客 的介绍部分,不仅是为了了解这两个官方博客及其区别,也是为了了解整个流程的概况。

我们为何要镜像

镜像几乎总是从贡献者博客到主博客。项目对那些涉及贡献者社区或其中一部分内容,同时对 Kubernetes 主博客更广泛读者群体相关的文章进行镜像。

作为作者(或评审人),请考虑目标受众以及博文是否适合 主博客。例如:如果目标受众仅是 Kubernetes 贡献者,那么 贡献者博客 可能更适合;如果博文是关于一般性的开源内容,那么可能更适合发布在 Kubernetes 项目之外的其他网站上。

关于目标受众的这一考量同样适用于原始文章和镜像文章。

Kubernetes 项目愿意镜像任何发布到 https://kubernetes.dev/blog/ (贡献者博客)的博文,前提是满足以下所有条件:

  • 镜像文章与原始文章具有相同的发布日期(理想情况下发布时间也应相同,但在特殊情况下最多可设置晚 12 小时的发布时间)

  • 对于在原始文章合并到贡献者博客之后才在主博客中添加镜像文章的 PR,请确保满足以下所有条件:

    • 原始文章发布到贡献者博客后,没有其他文章发布到主博客。
    • 在原始文章的发布时间与您的镜像文章的发布时间之间,没有其他主博客文章计划发布。

    这是因为 Kubernetes 项目不希望在人们的订阅源(例如 RSS)中插入文章,除非是在订阅源的最末尾。

  • 原始文章不违反任何强烈推荐的评审指南或社区规范

  • 镜像文章在其 Front Matter 中正确设置了 canonicalUrl

  • 原始文章的受众会觉得其相关

  • 文章内容与镜像文章将要出现的那个目标博客的主题不跑偏

从主博客到贡献者博客的镜像情况很少见,但也可能发生。

如何镜像

您针对另一个 Git 仓库(通常是 https://github.com/kubernetes/website)创建一个添加文章的 PR。您应该在文章合并之前完成此操作。

作为文章作者,您应该将镜像文章的规范 URL 设置为原始文章的 URL(您可以使用预览来预测 URL 并在实际发布之前填写好)。为此,请使用 Front Matter 中的 canonicalUrl 字段。

最后修改于 2025 年 3 月 13 日太平洋标准时间 10:41 AM:Add guide to blog contributions (815a75d025)