博客文章镜像
官方有两个 Kubernetes 博客,CNCF 也有自己的博客,你也可以在其中了解 Kubernetes。
对于主要的 Kubernetes 博客,我们(Kubernetes 项目)喜欢发表具有不同视角和特别焦点的文章,
这些文章与 Kubernetes 有一定的关联。
有些文章会同时出现在两个博客上:一篇文章是主要版本,另一篇是另一个博客上的镜像文章。
本文介绍了镜像的标准、镜像的动机,并解释了你应该做什么来确保文章发布到两个博客。
准备开始
请确保你已熟悉为 Kubernetes 博客贡献内容的介绍部分, 这不仅是为了了解两个官方博客及其之间的区别,还能帮助你概览整个发布流程。
为什么要镜像
镜像几乎总是从贡献者博客到主博客。项目组不仅针对有关贡献者社区或一部分文章这么做, 而且和 Kubernetes 主博客更为广泛的读者相关。
作为作者(或评审者),请考虑目标受众,并判断该博客文章是否适合发布在主博客上。
例如:如果目标受众仅限于 Kubernetes 的贡献者,
那么贡献者博客可能更为合适;
如果博客文章是关于开源的普遍话题,那么它可能更适合发布在 Kubernetes 项目之外的其他网站上。
这种对目标受众的考量同样适用于原创文章和镜像文章。
Kubernetes 项目愿意镜像任何发布在 https://kubernetes.dev/blog/ (贡献者博客)上的文章,但前提是满足以下所有条件:
-
镜像文章的发布日期必须与原始文章相同(发布时间也应相同,但在特殊情况下,可以设置最多延迟 12 小时的时间戳)。
-
对于在原始文章已合并到贡献者博客之后,向主博客添加镜像文章的 PR,请确保满足以下所有条件:
- 在原始文章发布到贡献者博客之后,没有文章发布到主博客。
-
在原始文章的发布时间和镜像文章的发布时间之间,主博客没有文章发布计划。
这是因为 Kubernetes 项目不希望在人们的订阅源(例如 RSS)中插入文章,除非是在订阅源的末尾。
-
原始文章不违反任何强烈推荐的评审指南或社区规范。
-
镜像文章的
canonicalUrl
将在其前言中正确设置。canonicalUrl
。
-
原文章的读者会认为其相关
-
文章内容与镜像文章出现的目标博客主题一致
从主博客到贡献者博客的镜像操作很少见,但理论上是可行的。
如何镜像
你需要向另一个 Git 仓库(通常是 https://github.com/kubernetes/website) 提交一个 PR,以添加该文章。此操作应在文章合并之前完成。
作为文章的作者,你应该为镜像文章设置规范 URL,
并将其指向原始文章的 URL(你可以使用预览功能预测 URL,并在实际发布前填写此内容)。
在前言中使用
canonicalUrl
字段来完成这一设置。
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.