From 95e78d6576799702f17642085c2fdf44a6988684 Mon Sep 17 00:00:00 2001 From: Ayaka Date: Mon, 10 Jul 2023 17:36:23 +0800 Subject: [PATCH] Typesetting README --- README.md | 60 ++++++++++++++++++++++++++----------------------------- 1 file changed, 28 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 9feb7cbb..96d0fb49 100644 --- a/README.md +++ b/README.md @@ -1,60 +1,59 @@ - [![GitHub issues](https://img.shields.io/github/issues/yidao620c/python3-cookbook.svg)](https://github.com/yidao620c/python3-cookbook/issues) [![License][licensesvg]][license] [![Github downloads](https://img.shields.io/github/downloads/yidao620c/python3-cookbook/total.svg)](https://github.com/yidao620c/python3-cookbook/releases/latest) [![GitHub release](https://img.shields.io/github/release/yidao620c/python3-cookbook.svg)](https://github.com/yidao620c/python3-cookbook/releases) -# 《Python Cookbook in Chinese》 3rd Edition 翻译 +# Python Cookbook 3rd Edition 中文翻译 -《Python Cookbook》3rd 中文版3.0.0正式发布啦 ^_^！ ——2017/12/07 +_Python Cookbook_ 3rd Edition 中文版正式发布啦 ^_^！ —— 2017/12/07 在线阅读地址： -最新版(3.0.0)下载 +最新版（3.0.0）下载 -* 中文简体版PDF下载地址： -* 中文繁体版PDF下载地址： +* 简体中文版 PDF 下载地址： +* 繁体中文版 PDF 下载地址： -## 关于作者David Beazley +## 关于作者 David Beazley -本书作者是David Beazley大神，一位独立的计算机科学家、教育家，以及有着35年开发经验的软件开发者。 -他在Python社区一直都很活跃，编写了很多的[python包](http://www.dabeaz.com/software.html)， +本书作者是 David Beazley 大神，一位独立的计算机科学家、教育家，以及有着 35 年开发经验的软件开发者。 +他在 Python 社区一直都很活跃，编写了很多的 [Python 包](http://www.dabeaz.com/software.html)， 发表了很多的公开[演讲视频](http://www.dabeaz.com/talks.html) 以及 [编程教程](http://www.dabeaz.com/tutorials.html)。 -同时还是[Python Essential Reference](http://www.dabeaz.com/per.html) 以及 -[ Python Cookbook (O'Reilly Media)](http://www.dabeaz.com/cookbook.html)的作者。 +同时还是 [Python Essential Reference](http://www.dabeaz.com/per.html) 以及 +[ Python Cookbook (O'Reilly Media)](http://www.dabeaz.com/cookbook.html) 的作者。 -David Beazley大神的博客地址： +David Beazley 大神的博客地址： ## 译者的话 -人生苦短，我用Python！ +人生苦短，我用 Python！ -译者一直坚持使用Python3，因为它代表了Python的未来。虽然向后兼容是它的硬伤，但是这个局面迟早会改变的， -而且Python3的未来需要每个人的帮助和支持。 -目前市面上的教程书籍，网上的手册大部分基本都是2.x系列的，专门基于3.x系列的书籍少的可怜。 +译者一直坚持使用 Python 3，因为它代表了 Python 的未来。虽然向后兼容是它的硬伤，但是这个局面迟早会改变的， +而且 Python 3 的未来需要每个人的帮助和支持。 +目前市面上的教程书籍，网上的手册大部分基本都是 2.x 系列的，专门基于 3.x 系列的书籍少得可怜。 -最近看到一本《Python Cookbook》3rd Edition，完全基于Python3，写的也很不错。 -为了Python3的普及，我也不自量力，想做点什么事情。于是乎，就有了翻译这本书的冲动了！ -这不是一项轻松的工作，却是一件值得做的工作：不仅方便了别人，而且对自己翻译能力也是一种锻炼和提升。 +最近看到一本 _Python Cookbook_ 3rd Edition，完全基于 Python 3，写的也很不错。 +为了 Python 3 的普及，我也不自量力，想做点什么事情。于是乎，就有了翻译这本书的冲动了！ +这不是一项轻松的工作，却是一件值得做的工作：不仅方便了别人，而且对自己的翻译能力也是一种锻炼和提升。 译者会坚持对自己每一句的翻译负责，力求高质量。但受能力限制，也难免有疏漏或者表意不当的地方。 如果译文中有什么错漏的地方请大家见谅，也欢迎大家随时指正。 -目前已经正式完成了整本书的翻译工作，历时2年，不管怎样还是坚持下来了。现在共享给python社区。 +目前已经正式完成了整本书的翻译工作，历时2年，不管怎样还是坚持下来了。现在共享给 Python 社区。 -**欢迎关注我的个人公众号“飞污熊”，我会定期分享一些自己的Python学习笔记和心得。** +**欢迎关注我的个人公众号“飞污熊”，我会定期分享一些自己的 Python 学习笔记和心得。** ![公众号](https://github.com/yidao620c/python3-cookbook/raw/master/exts/wuxiong.jpg) ## 项目说明 -* 所有文档均使用reStructuredText编辑，参考 [reStructuredText](http://docutils.sourceforge.net/docs/user/rst/quickref.html) -* 当前文档生成托管在 [readthedocs](https://readthedocs.org/) 上 +* 所有文档均使用 reStructuredText 编辑，参考 [reStructuredText](http://docutils.sourceforge.net/docs/user/rst/quickref.html) +* 当前文档生成托管在 [Read the Docs](https://readthedocs.org/) 上 * 生成的文档预览地址： [python3-cookbook](http://python3-cookbook.readthedocs.org/zh_CN/latest/) -* 使用了python官方文档主题 [sphinx-rtd-theme](https://github.com/snide/sphinx_rtd_theme) ，也是默认的主题default. -* 书中所有代码均在python 3.6版本下面运行通过，所有源码放在cookbook包下面 +* 使用了 Python 官方文档主题 [sphinx-rtd-theme](https://github.com/snide/sphinx_rtd_theme)，也是默认的主题 +* 书中所有代码均在 Python 3.6 版本下运行通过，所有源码放在 cookbook 包下面 ``` # on_rtd is whether we are on readthedocs.org, this line of code grabbed from docs.readthedocs.org @@ -87,17 +86,14 @@ if not on_rtd: # only import and set the theme if we're building docs locally ----------------------------------------------------- -## 关于源码生成PDF文件 +## 关于源码生成 PDF 文件 -有网友提问怎样通过源码生成PDF文件，由于这个步骤介绍有点长，不适合放在README里面， -我专门写了篇博客专门介绍怎样通过ReadtheDocs托管文档，怎样自己生成PDF文件，大家可以参考一下。 +有网友提问怎样通过源码生成 PDF 文件，由于这个步骤介绍有点长，不适合放在 README 中，我专门写了篇博客专门介绍怎样通过 Read the Docs 托管文档，怎样自己生成 PDF 文件，大家可以参考一下。 -另外关于生成的PDF文件中会自动生成标题编号的问题，有热心网友 [CarlKing5019](https://github.com/CarlKing5019)提出了解决方案， -请参考issues108： - - +另外关于生成的 PDF 文件中会自动生成标题编号的问题，有热心网友 [CarlKing5019](https://github.com/CarlKing5019) 提出了解决方案， +请参考 [issues#108](https://github.com/yidao620c/python3-cookbook/issues/108)。 再次感谢每一位贡献者。