博客文章镜像
Kubernetes 有两个官方博客,CNCF 也有自己的博客,你也可以在上面发布与 Kubernetes 相关的文章。对于主要的 Kubernetes 博客,我们(Kubernetes 项目)希望发布具有不同视角和特殊焦点的文章,这些文章与 Kubernetes 相关。
有些文章会同时出现在两个博客上:一篇文章有一个主要版本,在另一个博客上有一个镜像文章。
本文档描述了镜像的标准、镜像的动机,并解释了你应该做什么以确保文章同时发布到两个博客。
准备工作
请确保你熟悉 贡献 Kubernetes 博客 的介绍部分,这不仅能让你了解两个官方博客及其区别,还能让你对整个流程有一个概述。
我们为什么进行镜像
镜像几乎总是从贡献者博客到主博客。项目这样做是为了发布关于贡献者社区或其一部分的文章,但这些文章也与 Kubernetes 主博客的更广泛读者相关。
作为作者(或审稿人),请考虑目标受众以及博客文章是否适合主博客。例如:如果目标受众仅限于 Kubernetes 贡献者,那么贡献者博客可能更合适;如果博客文章是关于开源的,那么它可能更适合 Kubernetes 项目以外的其他网站。
关于目标受众的考虑同样适用于原创文章和镜像文章。
Kubernetes 项目愿意镜像任何已发布到 https://kubernetes.dev/blog/(贡献者博客)的文章,前提是满足以下所有标准:
镜像的文章与原文的发布日期相同(发布时间也应相同,但在特殊情况下,你可以设置最多晚 12 小时的时间戳)
对于在原文文章合并到贡献者博客之后添加镜像文章到主博客的 PR,请确保满足以下所有标准:
- 主博客上没有发布在原文文章发布到贡献者博客之后的文章。
- 在原文文章的发布时间和你的镜像文章的发布时间之间,没有安排发布主博客文章。
这是因为 Kubernetes 项目不希望在 RSS 等用户信息流中添加文章,除非添加到信息流的末尾。
原文文章没有违反任何强烈推荐的审查指南或社区规范
镜像的文章在其前端内容中设置了正确的
canonicalUrl
原文文章的受众会觉得它相关
文章内容对于镜像文章将出现的博客来说不是离题的
从主博客镜像到贡献者博客的情况很少见,但理论上可能发生。
如何镜像
你通常会向另一个 Git 仓库(通常是 https://github.com/kubernetes/website)提交一个 PR 来添加文章。你需要在文章合并之前进行此操作。
作为文章作者,你应该为镜像的文章设置规范 URL,指向原文文章的 URL(你可以使用预览来预测 URL 并提前填写)。为此,请使用前端内容中的canonicalUrl
字段。