xcatliu/jekyllcn

Jekyll 的中文翻译网站

English | 繁體中文

JekyllCN

网址：http://jekyllcn.com/

Forked from Jekyll.

JekyllCN 是 Jekyll 的中文翻译网站。

公告

由于官方文档更新，现在中文文档落后于官方文档，欢迎参与贡献翻译。

注意：中文排版遵循这个规范：写给大家看的中文排版指南。暂时放弃了翻译 contributing 和 history，因为他们是脚本生成的。

如何贡献翻译

1. 新建一个 issue，说明要贡献哪篇文档（可以是落后于官方版本的中文文档，也可以是还没有翻译的文档），注意翻译之前先看看 issues 里面有没有人已经认领了
2. fork 之后，修改 /site/_docs/ 中的对应文档进行翻译，并在本地预览，如果不知道如何在本地启动，可以参考如何在本地启动
3. 注意在 Front Matter 中将自己加入到 translators 字段，若无此字段，则添加一个
4. 注意在 Front Matter 中更新 update_date，若无此字段，则添加一个
5. 若要修改 css，请修改 /site/_sass/_jekyllcn.scss，新增的 css 以 .jekyllcn- 开头，尽量避免破坏 jekyll 的文件
6. 提交一个 pull-request，等待审核

如何在本地启动

1. 安装 bundle
2. 执行 bundle install
3. 执行 bundle exec rake site:preview

参考 contributing。

如何发布到 jekyllcn.com

使用 Travis CI 自动发布：https://travis-ci.org/xcatliu/jekyllcn

如何同步最新的 Jekyllrb

git remote add jekyllrb [email protected]:jekyll/jekyll.git
git fetch jekyllrb master
git merge jekyllrb/master
# 解决冲突

项目进度

项目进度汇总

基础建设

• 跟进官方网站版本 (2016-05-10)
• 首页中文适配 (2016-04-20)
• 页脚加上贡献翻译链接
• 导航加上贡献翻译链接
• 每篇文档加上贡献翻译链接
• 加上 ga
• 加上适配 jekyllcn 的 css
• 加上如何贡献翻译的文档
• 加上如何本地启动的文档
• 加上项目进度的文档
• header 中文适配
• 上一节下一节中文适配
• 右侧表头中文适配
• head 中文适配
• 每篇文文档加上原文链接
• 在 header 中加入贡献翻译链接
• 每篇文档加上翻译贡献者
• 在 header 中底色代表项目进度
• 使用 Travis CI 自动发布

jekyllcn's Issues

翻译 github-pages

🐵年快乐~

找点事做 : )

缺少 ?

在Installation的Requirements缺少：

NodeJS, or another JavaScript runtime (for CoffeeScript support).

http://jekyllrb.com/docs/installation/#requirements
可能会导致jekyll serve出错。

更新到官方版本

构建方式改变了，需要在 README.md 中说明

我想知道下官方的模板是怎么整的

比如这个就挺大气
http://github.co.jp/

Continous integration translation

Setting up a pull request, thx.

[question]how to add a new post?

What version of Jekyll are you using (jekyll -v)?

Jekyll 3.1.2

What operating system are you using?

Ubuntu 15.10

What did you do?

(Please include the content causing the issue, any relevant configuration settings, and the command you ran)

When I was ready to update some old translations posts, I found there is a new post Themes in jekyllrb.com, but not in jekyllcn.com.

What did you expect to see?

I want to know how to add a new post in order.

What did you see instead?

No new posts.

翻译 history

顺便申请加入 collaborator 列表
虽然历史更新没多大意义, 但是看着就它没被翻译总心痒痒的

引导用户协助翻译

根据 #129 的讨论，需要在每篇文档添加引导用户翻译的机制。

WEBrick Options 翻译错误

You can provide custom headers for your site by adding them to _config.yml

这里的Headers很明显指的是HTTP头，而不是“标题”：

你可以在 _config.yml 中为你的站点提供自定义标题

https://jekyllrb.com/docs/configuration/webrick/
http://jekyllcn.com/docs/configuration/#自定义-webrick-标题

post中文乱码

翻译 Collections

升级 2.0 后有一些页面一直没有翻译，一个一个来吧

http://jekyllcn.com/docs/collections/

链接缺失

文档 -> 杂项 -> 常见问题

如果你还是遇到问题，你可能需要使用XCode 来安装命令行工具
点击XCode 来安装命令行工具
404

Jekyll 3.0 发布了

需要跟进

jekyll-scholar右侧导航中文锚点定位有问题

https://fdango.github.io/bookT/intro.html#linux%E7%9A%84%E8%B5%B7%E6%BA%90%EF%BC%8C，这是我的链接，用jekyll搭建的模版，但是使用中文就会有问题，希望能在这获取到答案

"配置"页面中，"头信息默认值"项中有一个单词错误。

url http://jekyllcn.com/docs/configuration/#section-4

defaults:
  -
    scope:
      path: ""
      type: "posts"
    values:
      layout: "my-site"
  -
    scope:
      path: "projects"
      type: "pages" # 以前的 `[post]`<[page]， 在 Jekyll 2.2 里。
    values:
      layout: "project" # 覆盖之前的默认布局
      author: "Mr. Hyde"

post替换掉

希望有theme收集

收罗众多jekyll theme供爱好者使用

部署方法ftp那代码不正确

http://jekyllcn.com/docs/deployment-methods/#网站托管服务商-ftp
只需要运行 jekyll 命令然后……
应改为：运行 jekyll build 命令……

原文：https://jekyllrb.com/docs/deployment/manual/

官方 repo 的 site 的构建过程有变更

需要同步一下了

部署出现 bug

部署完成后会出现一个 not staged file:

modified:   site/_docs/history.md

并且此文件未部署成功

申请加入组织~~

☺️

建议在每个doc页面中加入原文链接，以便读者对翻译产生歧义时方便查看原文

jekyll2 发布啦啦~~~

新版本发布啦

网站挂了

网站 404 了，没找到原因。ga 显示已经挂了三天了

更新home / frontmatter / posts / drafts

添加https支持

站点不支持https跳转

Travis build failed

https://travis-ci.org/xcatliu/jekyllcn/builds/142107478
#135

jekyllcn无法正常登录

都好几天了，不翻墙登陆不了。以前都好好的呀。
英文版的网站正常。
我在上海

去掉进度展示

根据 #129 讨论，决定去掉进度展示。具体需要做以下修改：

1. 给每一篇文档添加一个 frontmatter update_date，依照 README.md 中的更新日期设置它的值，没有的话置空，至于如何使用 update_date，此任务不涉及
2. 去掉 README.md 中的「项目进度」模块，但是保留「基础建设」模块
3. 注释掉顶部进度条相关的代码（方便以后添加公告）

分页代码不对

http://jekyllcn.com/docs/pagination/的
“注意首尾页
Jekyll 没有生成文件夹 ‘page1’ ，所以上边的代码有 bug ，下边的代码解决了这个问题。”之后的代码粘贴过去依然找不到分页后的地址，而且样式很挫。

更新成http://jekyllrb.com/docs/pagination/
里“Beware the page one edge-case
Jekyll does not generate a ‘page1’ folder, so the above code will not work when a /page1 link is produced. See below for a way to handle this if it’s a problem for you.”
下方的代码就好了。

更新 “开始” 栏目的文档

翻译了前两个，我先提交一个 pull request，等全部翻译完你再 merge
另外之前翻译的是哪个版本的文档？人肉对比好难找到官方更新的地方，只能在 git 的 history 里一个个找

fatal: jekyllrb/master - not something we can merge

• jekyll 3.3.0
• CentOS Linux release 7.2.1511 (Core)

I tried to follow the README to get the lastest jekyllrb

git remote add jekyllrb [email protected]:jekyll/jekyll.git
git fetch jekyllrb master
git merge jekyllrb/master
# 解决冲突

then I got the following error:

$ git remote add jekyllrb [email protected]:jekyll/jekyll.git
$ git fetch jekyllrb master
remote: Counting objects: 1421, done.
remote: Compressing objects: 100% (57/57), done.
remote: Total 1421 (delta 597), reused 567 (delta 567), pack-reused 797
Receiving objects: 100% (1421/1421), 391.78 KiB | 522.00 KiB/s, done.
Resolving deltas: 100% (979/979), completed with 158 local objects.
From github.com:jekyll/jekyll
 * branch            master     -> FETCH_HEAD
$ git merge jekyllrb/master
fatal: jekyllrb/master - not something we can merge

能加入你的github组织不？有翻译和校对经验，希望能做点贡献

Extras 的翻译

内容不多，估计再10分钟就搞好了

Windows环境安装jekyll页面翻译不全

中文网站中Windows环境安装页面没有翻译如何用WSL安装，且引用的安装指南也是英文的

jekyll文件编辑问题

---

• [* ] I am on (or have tested on) Debian/Ubuntu GNU/Linux

---

在我安装完成 jekyll 后，我使用 vim 编辑 jekyll 的配置文件，会自动安装 vim 插件，怎么设置才能让这种情况不发生？

可以考虑使用认领机制来让大家完成翻译

参见rails guide的翻译认领https://github.com/ruby-china/rails-guides/blob/master/source/documents_CN.yaml
这样可以让大家避免重复劳动

jekyll serve error

Configuration file: /Users/XcatLiu/Workspace/github/jekyllcn/site/_config.yml
            Source: /Users/XcatLiu/Workspace/github/jekyllcn/site
       Destination: /Users/XcatLiu/Workspace/github/jekyllcn/site/_site
      Generating...
  Liquid Exception: Invalid syntax for include tag. File contains invalid characters or sequences: Valid syntax: {% include file.ext param='value' param2='value' %} in _docs/templates.md
jekyll 2.5.3 | Error:  Invalid syntax for include tag. File contains invalid characters or sequences:



Valid syntax:

  {% include file.ext param='value' param2='value' %}

[更新]已翻译内容

对比阅读发现，中文文档中有好些内容落后于官方版本。

[更新]更新配置页翻译

自定义 WEBRick 消息头 & 指定 Jekyll 构建时的环境变量 部分翻译不太通顺，有一些技术性名词翻译错误，进行修正

讨论不用翻译的词汇

Wiki里现在规定了的：

• Jekyll
• GitHub Pages

我暂时想补充的 (注意大小写及词间是否使用空格的格式， 但格式仅限于正文，不限于出现在code里的)：

• GitHub
• Markdown
• Textile
• Liquid
• HTML
• CSS
• Redcarpet
• Ruby
• RubyGems
• Linux
• Unix
• Mac OS X
• Windows
• Xcode
• LaTex
• Pygments
• ProTip （因为是trademark，不宜翻译）
• Gem （或 gem，若在句中）
• URL
• Wiki
• YAML

我不能确定是否应该翻译，但大家暂时遗留在已翻译文章里，还没有翻译的短语（皆非专有名词）：

• issue
• file an issue
• pull request
• troubleshooting
• report an issue
• the extras page
• flags

[请教] 这个jekyllcn 可以用 jekyll serve 来自动生成吗？

初学者，请教一下这个 jekyllcn 可以用 jekyll build 或者 jekyll serve 来生成和预览吗？

[认领] usage.md 中有一段还没有翻译过

这是怎么回事？怎么会出现只有一段没有翻印的情况，不如我来补全吧？

如何处理进度？

我们已经可以使用 Travis CI 来自动化部署网页了。但是还是得手动修改 progress，这点很麻烦。

其实翻译基本已经完成了，只是有些文档还比较落后。所以现在的进度提示可能也不是很准确。

我提供一些想法：

1. 取消「翻译」和「更新」的区别，统一为最后更新时间。
2. 取消「进度」机制，README.md 不再显示当前进度。
3. 顶部公告栏不再显示当前进度，而改为一些更有意思的内容（比如主题搜集，博客搜集）。
4. 每篇文档显示最后更新时间，并欢迎用户协助更新。

网站关闭了？

为什么我访问网站的时候，显示的是这个样子？网站关闭了？

将网站托管到 Githis.com 吧？

跟github无缝集成，很方便就可以部署上去呢。。

有几处要改善的地方

1. README.md 的 contributing 链接应该成 jekycn 的。
2. Gemfile 里的 source 'https://rubygems.org' 改成 source 'http://ruby.taobao.org'

css 样式问题

举例里的 table 超出了宽度
浏览器：chrome 43.0, Firefox 38.0
系统： linux mint 17.1

可以参考LCTT翻译组的方法进行翻译

http://lctt.github.io/