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的,请参考


认领章节记录

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)
  6. modified: README.md
  7. no changes added to commit (use "git add" and/or "git commit -a")
  8. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git add .
  9. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git commit -m "完成规范编写"
  10. iceskysls-MacBook-Pro:material_design_zh iceskysl$ git push origin master
  11. Counting objects: 46, done.
  12. Delta compression using up to 4 threads.
  13. Compressing objects: 100% (39/39), done.
  14. Writing objects: 100% (44/44), 7.50 KiB | 0 bytes/s, done.
  15. Total 44 (delta 13), reused 0 (delta 0)
  16. To git@github.com:IceskYsl/material_design_zh.git
  17. * [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的代码规范处理,如

```html
\

…\
```

图片如何处理

在章(如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