加入了中文版的README,修改了about.jade

This commit is contained in:
Zhicheng Wang 2016-05-27 10:27:47 +08:00
parent 899e3fe219
commit 1c918ad4c4
2 changed files with 22 additions and 127 deletions

132
README.md
View File

@ -1,124 +1,30 @@
# Angular.io # angular.io 中文版
Angular.io is site for Angular 2 **documentation** .
This site also includes links to other helpful angular resources including 这里是angular.io字幕组哦不对是汉化组。译者汪志成(雪狼)和叶志敏(Rex)欢迎您的到访。
Angular 2, Angular 1, Angular Material, and AngularFire.
## Issues 我们将和官方英文版保持同步翻译,并同步发布到[国内镜像](http://www.angular.live)
将来还会发布到[官方中文版](https://cn.angular.io/)。
Please file **Developer Guide, Cookbook, and code sample issues _only_** in this # 授权协议
[Angular.io](https://github.com/angular/angular.io/issues) github repo. 本文档还遵循CC BY 4.0,请在**保持署名**、**非商业**的前提下自由使用,你甚至可以把它架设在自己的电脑或内网服务器上。
**Angular API issues, cheatsheet corrections, feature requests, defect reports, and technical questions** concerning Angular itself 特别是:
belong in the [**angular source code**](https://github.com/angular/angular/issues) github repo.
We can't handle those topics here and will ask you to re-post them on the angular repo.
## How you can help - 不得去掉“关于中文版”的入口链接,也不得增删改“关于中文版”页的内容。
- 如果您是商业网站(包括但不限于任何有广告或收费的网站)要转载,请联系我们 traveller@163.com 或 asnowwolf@gmail.com 。
Filing issues is helpful but **pull requests** that improve the docs are even better! **违反上述授权协议将面临法律追究。**
Learn how to [contribute to Angular.io](https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md). # 编译与发布
## Development Setup 1. 用`git clone https://github.com/angular/angular-cn.git`把本项目取到本地。
This site relies heavily on node and npm. 1. 进入`angular-cn`目录
1. 运行`npm install`安装依赖包
1. 运行`gulp check-deploy`命令进行编译并预览会自动打开浏览器并访问8080端口
1. 把`./www`目录发布到任何静态文件服务器上
1. Make sure you are using the latest node and npm; 如果是内网服务器你还可以通过自建CI进行同步更新。
if not install [nvm](https://github.com/creationix/nvm) to get node going on your machine.
1. install these npm packages *globally*: `npm install -g harp gulp protractor` # 更多信息
1. clone this repo and the [angular source code repo](https://github.com/angular/angular) to the same parent directory. 关于本中文版以及两位译者的更多信息,请参见“关于中文版”链接。
The two cloned repo directories must be sibling.
1. cd into root directory `Angular.io/`
1. install the *all-docs* local packages by running `npm install`
> If running node v.5+, you probably must rebuild `node-sass` in a separate step: `npm rebuild node-sass`
1. See [below](#code-sample-development) for code sample development preparation.
## Content Development
All documentation content is written in Jade which has [its own syntax](http://jade-lang.com/reference/).
Be aware of the strict demands imposed by this significant-whitespace language.
We strongly recommend running one of the gulp `serve-and-sync` commands [described below](#serve-and-sync)
while editing content so you can see the effect of your changes *as you type*.
The documentation relies on specific styles and mixins.
Learn about those in the [documentation styleguide](https://angular.io/docs/ts/latest/styleguide.html).
The jade documentation files are language-specific directories under either `public/docs/`.
For example, all of the TypeScript docs are in `public/docs/ts/latest`, e.g.
- `public/docs/ts/latest/quickstart.jade`
- `public/docs/ts/latest/guide/architecture.jade`
- `public/docs/ts/latest/cookbook/component-communication.jade`
- `public/docs/ts/latest/tutorial/toh-pt5.jade`
### Local server with watches and browser reload
1. cd into root directory `Angular.io/`
1. run `gulp serve-and-sync`
1. browser will launch on localhost:3000 and stay refreshed automatically.
<a id="serve-and-sync"></a>
If you are only going to work on a specific part of the docs, such as the dev guide, then you can use one of the more specific gulp tasks to only watch those parts of the file system:
* `gulp serve-and-sync` : watch all the local Jade/Sass files, the API source and examples, and the dev guide files
* `gulp serve-and-sync-api` : watch only the API source and example files
* `gulp serve-and-sync-devguide` : watch only the dev guide files
* `gulp build-and-serve` : watch only the local Jade/Sass files
## Code Sample Development
All documentation is supported by sample code and plunkers.
Such code resides in the `public/docs/_examples` directory, under chapter-specific directories, further divided by language track.
For example, the TypeScript QuickStart sample is in `public/docs/_examples/quickstart/ts`.
All samples are in a consistent directory structure using the same styles and the same npm packages, including the latest release of Angular 2.
This consistency is possible in part thanks to gulp-driven tooling.
To run the samples locally and confirm that they work properly,
take the following extra steps to prepare the environment:
1. cd to `public/docs/_examples`
1. install the canonical node packages for all samples by running `npm install`
1. cd back up to `Angular.io` root: `cd ../../..`
1. run `gulp add-example-boilerplate` (elevate to admin on Windows)
to copy canonical files to the sample directories and create symlinks there for node_modules and typings.
Now cd into any particular sample's language directory (e.g., `public/docs/_examples/quickstart/ts`) and try:
- `npm start` to simultaneously compile-with-watch and serve-in-browser-with-watch
- `npm run tsc` to compile only
- `npm run lite` to serve-and-watch in browser
Look at the scripts in `package.json` for other options.
Also, open any `plunkr.no-link.html` to see the code execute in plunker
(you may have to run `gulp build-plunkers` first to create/update).
### Sample end-to-end tests
All samples should be covered to some degree by end-to-end tests:
- `gulp run-e2e-tests` to run all TypeScript and JavaScript tests
- `gulp run-e2e-tests --lang=dart` to run all Dart tests
- `gulp run-e2e-tests --lang=all` to run TypeScript, JavaScript, and Dart tests
- `gulp run-e2e-tests --filter=quickstart` to filter the examples to run, by name
- `gulp run-e2e-tests --fast` to ignore npm install, webdriver update and boilerplate copy
Any combination of options is possible.
## Technology Used
- Angular 1.x: The production ready version of Angular
- Angular Material: An implementation of Material Design in Angular.js
- Gulp: node-based tooling
- Harp: The static web server with built-in preprocessing.
- Sass: A professional grade CSS extension language
- Normalize: A modern, HTML5-ready alternative to CSS resets
- Grids: A highly customizable CSS Grid Framework built with Sass
- Prettify: A JS module and CSS for syntax highlighting of source code snippets.
- Icomoon: Custom built icon fonts
## License
Powered by Google ©2010-2016. Code licensed under an [MIT-style License](https://github.com/angular.io/blob/master/LICENSE). Documentation licensed under [CC BY 4.0](http://creativecommons.org/licenses/by/4.0/).

View File

@ -11,7 +11,7 @@
同时要注意我们只翻译“TypeScript”版的文档其它语言的版本大同小异可以在看懂TS版之后再对照看JS和Dart的英文版。不过我们还是建议你试用一下TypeScript。 同时要注意我们只翻译“TypeScript”版的文档其它语言的版本大同小异可以在看懂TS版之后再对照看JS和Dart的英文版。不过我们还是建议你试用一下TypeScript。
本文档目前只完成了部分章节的初译,尚未完成审校和统稿,因此语言风格和表达等可能还有问题,欢迎到我们的<a href="https://github.com/angular-live/angular.io" target="_blank">github</a>上提出issue或Pull Request。 本文档目前只完成了部分章节的初译,尚未完成审校和统稿,因此语言风格和表达等可能还有问题,欢迎到我们的<a href="https://github.com/angular/angular-cn" target="_blank">github</a>上提出issue或Pull Request。
本文档的任何更新都会实时发布于我们的 [首发网站](http://www.angular.live) 。如果你要进行转载请自行同步不过小心别DDoS了我们或者在想要同步到最新版时 [联系我们](mailto:traveller@163.com) 。 本文档的任何更新都会实时发布于我们的 [首发网站](http://www.angular.live) 。如果你要进行转载请自行同步不过小心别DDoS了我们或者在想要同步到最新版时 [联系我们](mailto:traveller@163.com) 。
## 授权方式 ## 授权方式
@ -39,19 +39,8 @@
但你可以在精神上支持我们,比如: 但你可以在精神上支持我们,比如:
- 在Github上 <iframe src="./github-btn.html?user=angular-live&amp;repo=angular.io&amp;type=watch&amp;count=true&amp;size=large" allowtransparency="true" frameborder="0" scrolling="0" width="130" height="30""></iframe>我们 或 <iframe src="./github-btn.html?user=angular-live&amp;repo=angular.io&amp;type=fork&amp;count=true&amp;size=large" allowtransparency="true" frameborder="0" scrolling="0" width="130" height="30""></iframe> 我们 - 在Github上 <iframe src="./github-btn.html?user=angular&amp;repo=angular-cn&amp;type=watch&amp;count=true&amp;size=large" allowtransparency="true" frameborder="0" scrolling="0" width="130" height="30""></iframe>我们 或 <iframe src="./github-btn.html?user=angular&amp;repo=angular-cn&amp;type=fork&amp;count=true&amp;size=large" allowtransparency="true" frameborder="0" scrolling="0" width="130" height="30""></iframe> 我们
:marked :marked
- 提供[反馈、纠错](https://github.com/angular-live/angular.io/issues) - 提供[反馈、纠错](https://github.com/angular/angular-cn/issues)
- 帮我们宣传 - 帮我们宣传
- 等等 - 等等
当然如果实在觉得翻译质量高到狠狠点赞都不够,也可以在物质上支持我们,比如:通过支付宝或微信资助我们 ^_^
![支付宝转账](./alipay.jpg)
![微信支付](./wechat.jpg)
金额上请随意,比如你的一顿早餐钱 ——
什么?你不吃早餐?那就从现在开始吃吧,不然怎么资助我们?
严肃脸作为程序员最重要的是身体、身体、身体重要的事情说三遍这是一个18年老程序员的忠告。