Skip to content

Commit c84911b

Browse files
committed
readme
1 parent 01d3afe commit c84911b

File tree

2 files changed

+169
-38
lines changed

2 files changed

+169
-38
lines changed

Diff for: README.md

+38-38
Original file line numberDiff line numberDiff line change
@@ -3,48 +3,50 @@
33
[![License][licensesvg]][license]
44
[![Github downloads](https://img.shields.io/github/downloads/yidao620c/python3-cookbook/total.svg)](https://github.com/yidao620c/python3-cookbook/releases/latest)
55
[![GitHub release](https://img.shields.io/github/release/yidao620c/python3-cookbook.svg)](https://github.com/yidao620c/python3-cookbook/releases)
6-
# Translated By google translated in English
76

87

9-
Online reading address: http://python3-cookbook.readthedocs.org/zh_CN/latest/
8+
# 《Python Cookbook》 3rd Edition 翻译
109

11-
The latest version (3.0.0) download
10+
《Python Cookbook》3rd 中文版3.0.0正式发布啦 ^_^! ——2017/12/07
1211

13-
Chinese simplified version PDF download address: https://pan.baidu.com/s/1pL1cI9d
14-
Chinese Traditional Chinese PDF download address: https://pan.baidu.com/s/1qX97VJI
15-
Translator's words
16-
Life is short, I use Python!
12+
在线阅读地址:<http://python3-cookbook.readthedocs.org/zh_CN/latest/>
1713

18-
The translator has always insisted on using Python 3 because it represents the future of Python. Although backward compatibility is its flaw, this situation will change sooner or later, and the future of Python3 needs everyone's help and support. At present, the tutorial books on the market, most of the manuals on the Internet are basically 2.x series, and the books based on the 3.x series are less pitiful.
14+
最新版(3.0.0)下载
1915

20-
Life is short, I use Python!
16+
* 中文简体版PDF下载地址:<https://pan.baidu.com/s/1pL1cI9d>
17+
* 中文繁体版PDF下载地址:<https://pan.baidu.com/s/1qX97VJI>
2118

22-
The translator has always insisted on using Python 3 because it represents the future of Python. Although backward compatibility is its hard injury, this situation will change sooner or later,
23-
And the future of Python 3 needs everyone's help and support.
24-
At present, the tutorial books on the market, most of the manuals on the Internet are basically 2.x series, and the books based on the 3.x series are less pitiful.
2519

26-
I recently saw a Python Cookbook 3rd Edition, based entirely on Python3, which is also very good.
27-
For the popularity of Python3, I am not self-sufficient and want to do something. Ever since, there is an impulse to translate this book!
28-
This is not an easy job, but it is a worthwhile job: it is not only convenient for others, but also an exercise and improvement for your ability to translate.
20+
## 译者的话
2921

30-
The translator will insist on being responsible for the translation of each sentence and strive for high quality. However, due to limited ability, it is inevitable that there will be omissions or improper expressions.
31-
If there is anything wrong with the translation, please forgive me and welcome everyone to correct me.
22+
人生苦短,我用Python!
3223

33-
At present, the translation of the entire book has been officially completed. It lasted for 2 years, and it persisted anyway. Now share it with the python community.
24+
译者一直坚持使用Python3,因为它代表了Python的未来。虽然向后兼容是它的硬伤,但是这个局面迟早会改变的,
25+
而且Python3的未来需要每个人的帮助和支持。
26+
目前市面上的教程书籍,网上的手册大部分基本都是2.x系列的,专门基于3.x系列的书籍少的可怜。
3427

35-
**Welcome to my personal public number "Flying Saffron Bear", I will share some of my own Python study notes and tips on a regular basis. **
28+
最近看到一本《Python Cookbook》3rd Edition,完全基于Python3,写的也很不错。
29+
为了Python3的普及,我也不自量力,想做点什么事情。于是乎,就有了翻译这本书的冲动了!
30+
这不是一项轻松的工作,却是一件值得做的工作:不仅方便了别人,而且对自己翻译能力也是一种锻炼和提升。
3631

32+
译者会坚持对自己每一句的翻译负责,力求高质量。但受能力限制,也难免有疏漏或者表意不当的地方。
33+
如果译文中有什么错漏的地方请大家见谅,也欢迎大家随时指正。
3734

38-
[[Public Number] (https://github.com/yidao620c/python3-cookbook/raw/master/exts/wuxiong.jpg)
35+
目前已经正式完成了整本书的翻译工作,历时2年,不管怎样还是坚持下来了。现在共享给python社区。
3936

37+
**欢迎关注我的个人公众号“飞污熊”,我会定期分享一些自己的Python学习笔记和心得。**
4038

41-
## project instruction
39+
![公众号](https://github.com/yidao620c/python3-cookbook/raw/master/exts/wuxiong.jpg)
40+
41+
42+
## 项目说明
43+
44+
* 所有文档均使用reStructuredText编辑,参考 [reStructuredText](http://docutils.sourceforge.net/docs/user/rst/quickref.html)
45+
* 当前文档生成托管在 [readthedocs](https://readthedocs.org/)
46+
* 生成的文档预览地址: [python3-cookbook](http://python3-cookbook.readthedocs.org/zh_CN/latest/)
47+
* 使用了python官方文档主题 [sphinx-rtd-theme](https://github.com/snide/sphinx_rtd_theme) ,也是默认的主题default.
48+
* 书中所有代码均在python 3.6版本下面运行通过,所有源码放在cookbook包下面
4249

43-
* All documents are edited using reStructuredText, refer to [reStructuredText] (http://docutils.sourceforge.net/docs/user/rst/quickref.html)
44-
* Current document generation is hosted on [readthedocs] (https://readthedocs.org/)
45-
* Generated document preview address: [python3-cookbook](http://python3-cookbook.readthedocs.org/zh_CN/latest/)
46-
* Use the python official documentation theme [sphinx-rtd-theme] (https://github.com/snide/sphinx_rtd_theme), which is also the default theme default.
47-
* All code in the book runs under Python 3.6, all source code is placed under the cookbook package
4850
```
4951
# on_rtd is whether we are on readthedocs.org, this line of code grabbed from docs.readthedocs.org
5052
on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
@@ -57,10 +59,9 @@ if not on_rtd: # only import and set the theme if we're building docs locally
5759
# otherwise, readthedocs.org uses their theme by default, so no need to specify it
5860
```
5961

60-
##
61-
Other contributors
62+
## 其他贡献者
6263

63-
names not listed in order
64+
排名不分先后
6465

6566
1. Yu Longjun (https://github.com/yulongjun)
6667
1. tylinux (https://github.com/tylinux)
@@ -73,24 +74,23 @@ names not listed in order:
7374
1. lambdaplus (https://github.com/lambdaplus)
7475
1. Tony Yang ([email protected])
7576

77+
[更多贡献者](https://github.com/yidao620c/python3-cookbook/graphs/contributors)
7678

77-
[More contributors] (https://github.com/yidao620c/python3-cookbook/graphs/contributors)
78-
79-
-------------------------------------------------- ---
79+
-----------------------------------------------------
8080

81-
## About source code generation PDF file
81+
## 关于源码生成PDF文件
8282

83-
Some netizens asked how to generate a PDF file from the source code. Since this step is a bit long, it is not suitable for being placed in the README.
84-
I wrote a blog dedicated to how to use the ReadtheDocs to host documents, how to generate PDF files yourself, you can refer to it.
83+
有网友提问怎样通过源码生成PDF文件,由于这个步骤介绍有点长,不适合放在README里面,
84+
我专门写了篇博客专门介绍怎样通过ReadtheDocs托管文档,怎样自己生成PDF文件,大家可以参考一下。
8585

8686
<https://www.xncoding.com/2017/01/22/fullstack/readthedoc.html>
8787

88-
In addition, the issue of the title number is automatically generated in the generated PDF file, and the enthusiastic user [CarlKing5019] (https://github.com/CarlKing5019) proposes a solution.
89-
Please refer to issues108:
88+
另外关于生成的PDF文件中会自动生成标题编号的问题,有热心网友 [CarlKing5019](https://github.com/CarlKing5019)提出了解决方案,
89+
请参考issues108:
9090

9191
<https://github.com/yidao620c/python3-cookbook/issues/108>
9292

93-
Thanks again to each contributor.
93+
再次感谢每一位贡献者。
9494

9595
-----------------------------------------------------
9696

Diff for: README_en.md

+131
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
2+
[![GitHub issues](https://img.shields.io/github/issues/yidao620c/python3-cookbook.svg)](https://github.com/yidao620c/python3-cookbook/issues)
3+
[![License][licensesvg]][license]
4+
[![Github downloads](https://img.shields.io/github/downloads/yidao620c/python3-cookbook/total.svg)](https://github.com/yidao620c/python3-cookbook/releases/latest)
5+
[![GitHub release](https://img.shields.io/github/release/yidao620c/python3-cookbook.svg)](https://github.com/yidao620c/python3-cookbook/releases)
6+
7+
Online reading address: http://python3-cookbook.readthedocs.org/zh_CN/latest/
8+
9+
The latest version (3.0.0) download
10+
11+
* Chinese simplified version PDF download address: https://pan.baidu.com/s/1pL1cI9d
12+
* Chinese Traditional Chinese PDF download address: https://pan.baidu.com/s/1qX97VJI
13+
14+
## Translator's words
15+
16+
Life is short, I use Python!
17+
18+
The translator has always insisted on using Python 3 because it represents the future of Python. Although backward compatibility is its flaw, this situation will change sooner or later, and the future of Python3 needs everyone's help and support. At present, the tutorial books on the market, most of the manuals on the Internet are basically 2.x series, and the books based on the 3.x series are less pitiful.
19+
20+
Life is short, I use Python!
21+
22+
The translator has always insisted on using Python 3 because it represents the future of Python. Although backward compatibility is its hard injury, this situation will change sooner or later,
23+
And the future of Python 3 needs everyone's help and support.
24+
At present, the tutorial books on the market, most of the manuals on the Internet are basically 2.x series, and the books based on the 3.x series are less pitiful.
25+
26+
I recently saw a Python Cookbook 3rd Edition, based entirely on Python3, which is also very good.
27+
For the popularity of Python3, I am not self-sufficient and want to do something. Ever since, there is an impulse to translate this book!
28+
This is not an easy job, but it is a worthwhile job: it is not only convenient for others, but also an exercise and improvement for your ability to translate.
29+
30+
The translator will insist on being responsible for the translation of each sentence and strive for high quality. However, due to limited ability, it is inevitable that there will be omissions or improper expressions.
31+
If there is anything wrong with the translation, please forgive me and welcome everyone to correct me.
32+
33+
At present, the translation of the entire book has been officially completed. It lasted for 2 years, and it persisted anyway. Now share it with the python community.
34+
35+
**Welcome to my personal public number "Flying Saffron Bear", I will share some of my own Python study notes and tips on a regular basis. **
36+
37+
38+
[[Public Number] (https://github.com/yidao620c/python3-cookbook/raw/master/exts/wuxiong.jpg)
39+
40+
41+
## project instruction
42+
43+
* All documents are edited using reStructuredText, refer to [reStructuredText] (http://docutils.sourceforge.net/docs/user/rst/quickref.html)
44+
* Current document generation is hosted on [readthedocs] (https://readthedocs.org/)
45+
* Generated document preview address: [python3-cookbook](http://python3-cookbook.readthedocs.org/zh_CN/latest/)
46+
* Use the python official documentation theme [sphinx-rtd-theme] (https://github.com/snide/sphinx_rtd_theme), which is also the default theme default.
47+
* All code in the book runs under Python 3.6, all source code is placed under the cookbook package
48+
```
49+
# on_rtd is whether we are on readthedocs.org, this line of code grabbed from docs.readthedocs.org
50+
on_rtd = os.environ.get('READTHEDOCS', None) == 'True'
51+
52+
if not on_rtd: # only import and set the theme if we're building docs locally
53+
import sphinx_rtd_theme
54+
html_theme = 'sphinx_rtd_theme'
55+
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
56+
57+
# otherwise, readthedocs.org uses their theme by default, so no need to specify it
58+
```
59+
60+
## Other contributors
61+
62+
names not listed in order:
63+
64+
1. Yu Longjun (https://github.com/yulongjun)
65+
1. tylinux (https://github.com/tylinux)
66+
1. Kevin Guan (https://github.com/K-Guan)
67+
1. littlezz (https://github.com/littlezz)
68+
1. cclauss (https://github.com/cclauss)
69+
1. Yan Zhang (https://github.com/Eskibear)
70+
1. xiuyanduan (https://github.com/xiuyanduan)
71+
1. FPlust (https://github.com/fplust)
72+
1. lambdaplus (https://github.com/lambdaplus)
73+
1. Tony Yang ([email protected])
74+
75+
76+
[More contributors] (https://github.com/yidao620c/python3-cookbook/graphs/contributors)
77+
78+
-------------------------------------------------- ---
79+
80+
## About source code generation PDF file
81+
82+
Some netizens asked how to generate a PDF file from the source code. Since this step is a bit long, it is not suitable for being placed in the README.
83+
I wrote a blog dedicated to how to use the ReadtheDocs to host documents, how to generate PDF files yourself, you can refer to it.
84+
85+
<https://www.xncoding.com/2017/01/22/fullstack/readthedoc.html>
86+
87+
In addition, the issue of the title number is automatically generated in the generated PDF file, and the enthusiastic user [CarlKing5019] (https://github.com/CarlKing5019) proposes a solution.
88+
Please refer to issues108:
89+
90+
<https://github.com/yidao620c/python3-cookbook/issues/108>
91+
92+
Thanks again to each contributor.
93+
94+
-----------------------------------------------------
95+
96+
## How to Contribute
97+
98+
You are welcome to contribute to the project as follow
99+
100+
* fork project and commit pull requests
101+
* add/edit wiki
102+
* report/fix issue
103+
* code review
104+
* commit new feature
105+
* add testcase
106+
107+
Meanwhile you'd better follow the rules below
108+
109+
* It's *NOT* recommended to submit a pull request directly to `master` branch. `develop` branch is more appropriate
110+
* Follow common Python coding conventions
111+
* Add the following [license] in each source file
112+
113+
## License
114+
115+
(The Apache License)
116+
117+
Copyright (c) 2014-2018 [Xiong Neng](<https://www.xncoding.com/>) and other contributors
118+
119+
Licensed under the Apache License, Version 2.0 (the "License");
120+
you may not use this file except in compliance with the License. You may obtain a copy of the License at
121+
122+
http://www.apache.org/licenses/LICENSE-2.0
123+
124+
Unless required by applicable law or agreed to in writing,
125+
software distributed under the License is distributed on an "AS IS" BASIS,
126+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
127+
See the License for the specific language governing permissions and limitations under the License.
128+
129+
130+
[licensesvg]: https://img.shields.io/hexpm/l/plug.svg
131+
[license]: http://www.apache.org/licenses/LICENSE-2.0

0 commit comments

Comments
 (0)