Awesome
layout: page title: Readme permalink: readme.html
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日更新
- Style
- Icons by Goshin
翻译认领章节记录
- Material Design
- 概述 - Introduction √ by iceskysl
What is material?
- Animation
- 真实的动作 - Authentic Motion √ by zhenbeiju
- 交互响应 - Responsive Interaction √ by 7heaven
- 有意义的转场动画 - Meaningful Transitions √ by Jingsha
- 打动用户的细节 - Delightful Details √ by com360
- Style
- Layout
- 准则 - Principles √ by lightlz
单位和度量
-Units and measurements
- 度量与边框 - Metrics and Keylines √ by CodeDiving
- 结构 - Structure √ by donlianggit
自适应 UI
-Adaptive UI
- Components
- 底部窗口 - Bottom Sheets √ by com360
- 按钮 - Buttons √ by 7heaven
按钮:浮动动作按钮
-Buttons: Floating Action Button
- 卡片 - Cards √ by ThatMrL
- 纸片 - Chips √ by Kris
数据表格
-Data tables
- 提示框 - Dialogs √ by Kris
- 分隔线 - Dividers √ by Kris
- 网格 - Grids √ by CodeDiving
- 列表 - Lists √ by CodeDiving
- 列表控制 - List controls √ by leiweibo
- 菜单 - Menus √ by CodeDiving
选择器
-Pickers
- 进度和动态 - Progress and Activity √ by SamanthaChou
选择控制
-Selection controls
- 滑片 - Sliders √ by siton
- Snackbars 与 Toasts - Snackbars and Toasts √ by chenzimu7
- 副标题 - Subheaders √ by marshluca
- 开关 - Switches √ by vincent4j
- Tabs - Tabs √ by vincent4j
- 文本框 - Text fields √ by SamanthaChou
- 工具提示 - Tooltips √ by lhyqy5
- Patterns
App 结构
-App structure
数据格式
-Data formats
空状态
-Empty states
错误
-Errors
- 数据格式 - Data formats 100% by IsNoFate
- 错误 - Errors 100% by IsNoFate
- 手势 - Gestures √ by Jingsha
启动屏幕
-Launch screens
加载图像
-Loading Images
- 抽屉式导航 - Navigation drawer √ by hcz017
导航
-Navigation
导航过渡
-Navigational transitions
滚动技巧
-Scrolling techniques
- 搜索 - Search √ by lhyqy5
- 内容选取 - Selection √ by lhyqy5
- 设置 - Settings √ by ZeroLu
刷新
-Swipe to refresh
√ by awong1900- 促进的动作 - Promoted Actions √ by ZeroLu
- 影像处理 - Imagery Treatment √ by ZeroLu
- Usability
- 可达性 - Accessibility √ by fortianwei
双向性
-Bidirectionality
- Resources
- 调色板 - Color Palettes √ by iceskysl
设备
-Devices
- 布局模板 - Layout Templates √ by iceskysl
- Roboto 字体 - Roboto Font √ by iceskysl
- 贴片集 - Sticker Sheets √ by iceskysl
- What's new
协作过程演示
录了一个动作演示,如下
git st
是我设置的一个git的别名,其全称是git status
fork主仓库
打开https://github.com/1sters/material_design_zh ,fork一份自己的仓库;
初始化本地仓库
iceskysls-MacBook-Pro:1sters iceskysl$ git clone git@github.com:IceskYsl/material_design_zh.git
Cloning into 'material_design_zh'...
remote: Counting objects: 3, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 3 (delta 0), reused 3 (delta 0)
Receiving objects: 100% (3/3), done.
Checking connectivity... done.
iceskysls-MacBook-Pro:1sters iceskysl$ cd material_design_zh
添加远程主仓库
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git remote add upstream https://github.com/1sters/material_design_zh.git
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git remote -v
origin git@github.com:IceskYsl/material_design_zh.git (fetch)
origin git@github.com:IceskYsl/material_design_zh.git (push)
upstream https://github.com/1sters/material_design_zh.git (fetch)
upstream https://github.com/1sters/material_design_zh.git (push)
和远程主仓库保持更新
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git fetch upstream
remote: Counting objects: 43, done.
remote: Compressing objects: 100% (33/33), done.
remote: Total 41 (delta 12), reused 32 (delta 3)
Unpacking objects: 100% (41/41), done.
From https://github.com/1sters/material_design_zh
* [new branch] master -> upstream/master
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git merge upstream/master
Updating 6899552..ea46595
Fast-forward
README.md | 115 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-----------------------------------------------
SOURCE/SUMMARY.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 119 insertions(+), 47 deletions(-)
create mode 100644 SOURCE/SUMMARY.md
推送本地修改到自己的远端仓库
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git st
On branch ing
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git add .
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git commit -m "完成规范编写"
iceskysls-MacBook-Pro:material_design_zh iceskysl$ git push origin master
Counting objects: 46, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (39/39), done.
Writing objects: 100% (44/44), 7.50 KiB | 0 bytes/s, done.
Total 44 (delta 13), reused 0 (delta 0)
To git@github.com:IceskYsl/material_design_zh.git
* [new branch] master -> master
发Pull Request
推送自己的远端仓库(master分支)到主仓库(master分支)
目录结构
├── README.md
├── SUMMARY.md
├── cover.jpg
├── cover_small.jpg
├── material-design
│ ├── images
│ │ ├── materialdesign-goals-cutrectangles_large_mdpi.png
│ │ ├── materialdesign-goals-landingimage_large_mdpi.png
│ │ ├── materialdesign-goals-swirlanddot_large_mdpi.png
│ │ ├── materialdesign-principles-circleplus_large_mdpi.png
│ │ ├── materialdesign-principles-flyingsquare_large_mdpi.png
│ │ └── materialdesign-principles-layersquares_large_mdpi.png
│ └── introduction.md
├── animation
│ ├── authentic-motion.md
│ ├── delightful-details.md
│ ├── meaningful-transitions.md
│ └── responsive-interaction.md
├── style
│ ├── color.md
│ ├── icons.md
│ ├── imagery.md
│ └── typography.md
├── layout
│ ├── layout-principles.md
│ ├── metrics-and-keylines.md
│ └── structure.md
├── components
│ ├── bottom-sheets.md
│ ├── buttons.md
│ ├── cards.md
│ ├── chips-tokens.md
│ ├── dialogs.md
│ ├── dividers.md
│ ├── grids.md
│ ├── list-controls.md
│ ├── lists.md
│ ├── menus.md
│ ├── progress-activity.md
│ ├── sliders.md
│ ├── snackbars-and-toasts.md
│ ├── subheaders.md
│ ├── switches.md
│ ├── tabs.md
│ ├── text-fields.md
│ └── tooltips.md
├── patterns
│ ├── gestures.md
│ ├── imagery-treatment.md
│ ├── promoted-actions.md
│ ├── search.md
│ ├── selection.md
│ └── settings.md
└── usability
└── accessibility.md
├── resources
│ ├── color-palettes.md
│ ├── layout-templates.md
│ ├── roboto-font.md
│ └── sticker-sheets.md
参与者(按认领章节排序)
翻译
- iceskysl
- zhenbeiju
- 7heaven
- Jingsha
- com360
- arjinmc
- acely
- Haoxiqiang
- lhyqy5
- lightlz
- CodeDiving
- donlianggit
- ThatMrL
- Kris
- leiweibo
- SamanthaChou
- siton
- chenzimu7
- marshluca
- vincent4j
- ZeroLu
- fortianwei
校对
- siton
- iceskysl
- KongZhen
- poppinlp
- chenyusi
- cxytomo
- Jingsha
- miaoiyy
- xianglifei
- huanglizhuo
- K0ST
- sisyphus60
- hyaocuk
- vincent4j
编写规范 issue#89
常见问题
代码如何处理
使用markdown的代码规范处理,如
```html
<div class="hey">...</div>
```
图片如何处理
在章(如components)下创建images
目录,将图片原文件名(如materialdesign-goals-cutrectangles_large_mdpi.png)存到该目录下,然后在文档中这样调用
![ALT文字](images/materialdesign-goals-landingimage_large_mdpi.png)