k8smeetup/kubernetes.github.io

Kubernetes website and documentation repo:

kubernetes.github.io's Issues

本地构建测试文档

Step1 . Clone code

git clone https://github.com/k8smeetup/k8smeetup.github.io

Step2. Write the docker-compose.yml file

version: '2'
services:
  jekyll:
    image: cargo.caicloud.io/kubernetes/jekyll:v1
    command: jekyll serve --watch --incremental
    ports:
      - 4000:4000
    volumes:
      - ./k8smeetup.github.io:/srv/jekyll

Step3. Run and view the browser

docker-compose up -d

Open chrome address: http: // localhost:4000
Note: If the localhost is running localhost instead of the server IP

翻译的内容已经合入之后怎么样保证跟最新的文档一致

我这里碰到一个问题，就是文档翻译完成，已经合入到K8SMEETUP以及上游仓库，但是，我看最近又出现了文档的更新，我是应该在K8SMEETUP里面更新，在K8SMEETUP合入后再次将更新的内容，用一个新的PR提交到上游吗？谢谢！
//cc @markthink

对于上游pr的更新

目前预览库是周更新的，如果需要对上游pr的更新需要等翻译库更新后拉取文件。效率略低。

目前可以做到的一个是同步更新k8smeetup的，也同时更新到上游pr中，这样一方面操作比较麻烦，另外对一致性的保障也有问题。
另外一个是在提交上游pr前自己做好模拟构建，但是无法保证上游review后还有问题需要修改。

有什么比较高效的方法或者workaround？需要讨论一下

建议将所有译者加到k8smeetup项目的people中来

建议将所有的翻译参与者加入到people中来
https://github.com/orgs/k8smeetup/people

建议在doc头部添加matadata信息

鉴于以下几点原因，建议在文档头部追加译者的GitHub账号，如同英文版中的那样。

1. 一篇doc每个月更新后，最初的译者也不一定会跟着更新翻译，所以每篇doc的译者可以是多个人，同样的reviewer也可以是多个人
   译者的GitHub账号应该在doc中注明，写在文章的metadata中，例如下面这一篇文章最顶部的mata信息：

---
title: Extending the Kubernetes API with the aggregation layer
assignees:
- lavalamp
- cheftako
- chenopis
---

2. 中文版应该在其中加入中文译者（是否要包含reviewer的信息？）的GitHub账号信息，例如：

---
title: Extending the Kubernetes API with the aggregation layer
cn-title: 通过聚合层扩展 kubernetes API
assignees:
- lavalamp
- cheftako
- chenopis
cn-assignees:
- rootsongjc
- xxx
---

3. title部分是不是也应该再单独设置一个中文标题mata信息，同时保留原来的英文title，这样在翻译的过程中就不用删除原来的英文标题，而markdown渲染为html文件时可以根据译文语言选择不同语言版本的title

Edit This Page 配置API对象（API Object）的配额（Quota）中的链接无效

在这篇文章 https://k8smeetup.github.io/docs/tasks/administer-cluster/quota-api-object/ 有几个问题

1. What's next的链接都无效。
2. 文件头信息无效

翻译规范讨论

最近注意到部分小伙伴的PR 已经被上游Merge了，收集一下大家对上游的问题和建议，欢迎大家一起反馈：

时延军：

1. 你->您（这个我一般都是换个说法，尽量不用 ）
2. 保留单个英文单词的，都用单数形式
3. 保留单个英文单词，单词两边各加1个空格
4. 如果是链接，链接的锚文本两边，各加1个空格
5. 用来补充说明的英文括号，我都转换成中文括号，这种情况中文括号两边不加空格
6. 对内容，如果是在句子文本中间，两边各加1个空格。