Material Design 中文协同翻译

重大消息：于 2015-08-16 更新，新增 20+ 章节，发布在 <http://wiki.jikexueyuan.com/project/material-design/>

Google I/O 2014发布的Material Design将会成为统一Android，Chrome等平台的设计语言规范，对从业人员意义重大，我们正通过互联网的方式将其翻译成中文~

我们欢迎每一个人参与进来一起翻译和校对~~

一起来参与

如果想做出贡献(翻译或者校对)的话，请加QQ群：137198122，谢谢！

原文文档： <http://www.google.com/design/spec/material-design/introduction.html>

参与步骤（页尾有详细的过程演示）

  • fork主仓库（<https://github.com/1sters/material_design_zh>）
  • 按照章节（页面）认领翻译(每次申请一个章节)，在下面这个README.md里找还没有被人申请的章节，写上（@你的github号），给主仓库的master分支提pull request；
  • 提的pull request 被确认，合并到主仓库后，代表你申请的章节占位完成，开始翻译；
  • 翻译过程请参 翻译协作规范 ，完成翻译后提交pull request给主仓库的master分支；
  • 校核完成后，从主仓库的master分支合并到主publish分支；
  • 全部翻译完成后，生成PDF文档和网页发布；

翻译协作规范

为了让大家协作顺畅，需要每一个人遵循如下协作规范~

  • 使用markdown进行翻译，文件名必须使用英文，因为中文的话gitbook编译的时候会出问题
  • 翻译后的文档请放到SOURCE文件夹下的对应章节中，然后pull request即可，我会用gitbook编译成网页
  • 工作分支为master，用于GitHub的pages服务
  • fork过去之后新建一个分支进行翻译，完成后pull request这个分支，没问题的话我会合并到master分支中
  • 有其他任何问题都欢迎发issue，我们看到了会尽快回复

如果不熟悉的Markdown的，请参考

  • <https://help.github.com/articles/markdown-basics>
  • <https://help.github.com/articles/github-flavored-markdown>

认领章节记录

2015.07.15日更新

翻译认领章节记录

协作过程演示

录了一个动作演示，如下 github guide

  • git st是我设置的一个git的别名，其全称是 git status

fork主仓库

打开<https://github.com/1sters/material_design_zh> ，fork一份自己的仓库；

初始化本地仓库

1. iceskysls-MacBook-Pro:1sters iceskysl$ git clone git@github.com:IceskYsl/material_design_zh.git
2. Cloning into 'material_design_zh'...
3. remote: Counting objects: 3, done.
4. remote: Compressing objects: 100% (2/2), done.
5. remote: Total 3 (delta 0), reused 3 (delta 0)
6. Receiving objects: 100% (3/3), done.
7. Checking connectivity... done.
8. iceskysls-MacBook-Pro:1sters iceskysl$ cd material_design_zh

添加远程主仓库

1. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git remote add upstream https://github.com/1sters/material_design_zh.git
2. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git remote -v
3. origin    git@github.com:IceskYsl/material_design_zh.git (fetch)
4. origin    git@github.com:IceskYsl/material_design_zh.git (push)
5. upstream    https://github.com/1sters/material_design_zh.git (fetch)
6. upstream    https://github.com/1sters/material_design_zh.git (push)

和远程主仓库保持更新

1. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git fetch upstream
2. remote: Counting objects: 43, done.
3. remote: Compressing objects: 100% (33/33), done.
4. remote: Total 41 (delta 12), reused 32 (delta 3)
5. Unpacking objects: 100% (41/41), done.
6. From https://github.com/1sters/material_design_zh
7. * [new branch]      master     -> upstream/master
8. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git merge upstream/master
9. Updating 6899552..ea46595
10. Fast-forward
11. README.md         | 115 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-----------------------------------------------
12. SOURCE/SUMMARY.md |  51 +++++++++++++++++++++++++++++++++++++++++++++++++++
13. 2 files changed, 119 insertions(+), 47 deletions(-)
14. create mode 100644 SOURCE/SUMMARY.md

推送本地修改到自己的远端仓库

1. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git st
2. On branch ing
3. Changes not staged for commit:
4. (use "git add <file>..." to update what will be committed)
5. (use "git checkout -- <file>..." to discard changes in working directory)

7. modified:   README.md

9. no changes added to commit (use "git add" and/or "git commit -a")

11. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git add .
12. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git commit -m "完成规范编写"

14. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git push origin master
15. Counting objects: 46, done.
16. Delta compression using up to 4 threads.
17. Compressing objects: 100% (39/39), done.
18. Writing objects: 100% (44/44), 7.50 KiB | 0 bytes/s, done.
19. Total 44 (delta 13), reused 0 (delta 0)
20. To git@github.com:IceskYsl/material_design_zh.git
21. * [new branch]      master -> master

发Pull Request

推送自己的远端仓库（master分支)到主仓库（master分支)

目录结构

1. ├── README.md
2. ├── SUMMARY.md
3. ├── cover.jpg
4. ├── cover_small.jpg
5. ├── material-design
6. │   ├── images
7. │   │   ├── materialdesign-goals-cutrectangles_large_mdpi.png
8. │   │   ├── materialdesign-goals-landingimage_large_mdpi.png
9. │   │   ├── materialdesign-goals-swirlanddot_large_mdpi.png
10. │   │   ├── materialdesign-principles-circleplus_large_mdpi.png
11. │   │   ├── materialdesign-principles-flyingsquare_large_mdpi.png
12. │   │   └── materialdesign-principles-layersquares_large_mdpi.png
13. │   └── introduction.md
14. ├── animation
15. │   ├── authentic-motion.md
16. │   ├── delightful-details.md
17. │   ├── meaningful-transitions.md
18. │   └── responsive-interaction.md
19. ├── style
20. │   ├── color.md
21. │   ├── icons.md
22. │   ├── imagery.md
23. │   └── typography.md
24. ├── layout
25. │   ├── layout-principles.md
26. │   ├── metrics-and-keylines.md
27. │   └── structure.md
28. ├── components
29. │   ├── bottom-sheets.md
30. │   ├── buttons.md
31. │   ├── cards.md
32. │   ├── chips-tokens.md
33. │   ├── dialogs.md
34. │   ├── dividers.md
35. │   ├── grids.md
36. │   ├── list-controls.md
37. │   ├── lists.md
38. │   ├── menus.md
39. │   ├── progress-activity.md
40. │   ├── sliders.md
41. │   ├── snackbars-and-toasts.md
42. │   ├── subheaders.md
43. │   ├── switches.md
44. │   ├── tabs.md
45. │   ├── text-fields.md
46. │   └── tooltips.md
47. ├── patterns
48. │   ├── gestures.md
49. │   ├── imagery-treatment.md
50. │   ├── promoted-actions.md
51. │   ├── search.md
52. │   ├── selection.md
53. │   └── settings.md
54. └── usability
55. └── accessibility.md
56. ├── resources
57. │   ├── color-palettes.md
58. │   ├── layout-templates.md
59. │   ├── roboto-font.md
60. │   └── sticker-sheets.md

参与者（按认领章节排序）

翻译

校对

编写规范 issue#89

常见问题

代码如何处理

使用markdown的代码规范处理，如

\

…\

图片如何处理

在章（如components）下创建images目录，将图片原文件名（如materialdesign-goals-cutrectangles_large_mdpi.png）存到该目录下，然后在文档中这样调用 ![ALT文字](images/materialdesign-goals-landingimage_large_mdpi.png)

图片太大，如何缩小 issue#57

如何添加锚点 issue#58

视频如何处理 issue#90

来源(书栈小编注)

<https://github.com/1sters/material_design_zh>