Skip to content

Latest commit

 

History

History
131 lines (85 loc) · 6.33 KB

README_en.md

File metadata and controls

131 lines (85 loc) · 6.33 KB

GitHub issues License Github downloads GitHub release

Online reading address: http://python3-cookbook.readthedocs.org/zh_CN/latest/

The latest version (3.0.0) download

Translator's words

Life is short, I use Python!

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.

Life is short, I use Python!

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, And the future of Python 3 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.

I recently saw a Python Cookbook 3rd Edition, based entirely on Python3, which is also very good. 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! 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.

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. If there is anything wrong with the translation, please forgive me and welcome everyone to correct me.

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.

**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. **

[[Public Number] (https://github.com/yidao620c/python3-cookbook/raw/master/exts/wuxiong.jpg)

project instruction

# on_rtd is whether we are on readthedocs.org, this line of code grabbed from docs.readthedocs.org
on_rtd = os.environ.get('READTHEDOCS', None) == 'True'

if not on_rtd:  # only import and set the theme if we're building docs locally
    import sphinx_rtd_theme
    html_theme = 'sphinx_rtd_theme'
    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]

# otherwise, readthedocs.org uses their theme by default, so no need to specify it

Other contributors

names not listed in order:

  1. Yu Longjun (https://github.com/yulongjun)
  2. tylinux (https://github.com/tylinux)
  3. Kevin Guan (https://github.com/K-Guan)
  4. littlezz (https://github.com/littlezz)
  5. cclauss (https://github.com/cclauss)
  6. Yan Zhang (https://github.com/Eskibear)
  7. xiuyanduan (https://github.com/xiuyanduan)
  8. FPlust (https://github.com/fplust)
  9. lambdaplus (https://github.com/lambdaplus)
  10. Tony Yang ([email protected])

[More contributors] (https://github.com/yidao620c/python3-cookbook/graphs/contributors)


About source code generation PDF file

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. 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.

https://www.xncoding.com/2017/01/22/fullstack/readthedoc.html

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. Please refer to issues108:

yidao620c#108

Thanks again to each contributor.


How to Contribute

You are welcome to contribute to the project as follow

  • fork project and commit pull requests
  • add/edit wiki
  • report/fix issue
  • code review
  • commit new feature
  • add testcase

Meanwhile you'd better follow the rules below

  • It's NOT recommended to submit a pull request directly to master branch. develop branch is more appropriate
  • Follow common Python coding conventions
  • Add the following license in each source file

License

(The Apache License)

Copyright (c) 2014-2018 Xiong Neng and other contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.