# Python-Guide-CN

**Repository Path**: homeleaf/Python-Guide-CN

## Basic Information

- **Project Name**: Python-Guide-CN
- **Description**: Python 最佳实践指南中文版，翻译自 Hitchhiker's Guide to Python 本指南目前持续不断地更新与完善
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2017-10-08
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Python最佳实践指南中文版
============================

.. image:: https://farm1.staticflickr.com/628/33173824932_58add34581_k_d.jpg

项目翻译自 `Hitchhiker's Guide to Python <https://github.com/kennethreitz/python-guide>`_。

Readthedocs文档地址 `Python最佳实践指南中文版 <http://pythonguidecn.readthedocs.org/>`_。

-----------

本指南目前持续不断地更新与完善。这份主要是自我见解的指南旨在为Python初学者和
专家提供一个关于Python安装、配置、和日常使用的最佳实践手册。


主题包括:

- 不同平台和系统上的安装
- Py2app, Py2exe, bbfreeze, pyInstaller
- Pip
- Numpy, scipy, statpy, pyplot, matplotlib
- Virtualenv
- Fabric
- 优秀的模块推荐，按主题/目的分类
- 在哪些场景下使用哪些模块
- 服务器配置 & 不同的web框架和工具
- 文档: 写文档
- 测试: Jenkins & tox 指南
- 如何更方便地通过 ``git`` 连接 ``hg``

如果您不习惯阅读reStructuredText形式的文档, 这里有一份同步更新的 `HTML版文档，请戳它 <http://pythonguidecn.readthedocs.org/>`_。

使用指南
============================
1. 下载zip文件或clone到本地，并进入到项目根目录
2. 打开命令行，运行 `pip install -r requirements.txt` 安装依赖
3. 打开命令行，运行 `make html` ; 或者（针对Windows）运行makehtml.bat
4. 上述步骤自动在根目录下生成build文件夹，打开./build/html/index.html即可浏览文档

或者
---------------------------
- 直接访问 `Python最佳实践指南中文版 <http://pythonguidecn.readthedocs.org/>`_。

-----------

翻译进度（完成）
============================
Getting Started（开始吧）（完成）
---------------------------
- Picking an Interpreter（选择一个解释器）（完成）
- Properly Install Python（正确地安装Python）（完成）

Writing Great Code（写出优雅的代码）（完成）
---------------------------
- Structuring Your Project（结构化您的工程）（完成）
- Code Style（代码风格）（完成）
- Reading Great Code（阅读好的代码）（完成）
- Documentation（文档）（完成）
- Testing Your Code（测试您的代码）（完成）
- Logging（日志）（完成）
- Common Gotchas（常见陷阱）（完成）
- Choosing a License（选择一个许可）（完成）

Scenario Guide（场景/方案指南）（完成）
---------------------------
- Network Applications（网络应用）（完成）
- Web Applications（Web 应用）（完成）
- HTML Scraping（HTML 抓取）（完成）
- Command-line Applications（命令行应用）（完成）
- GUI Applications（GUI应用）（完成）
- Databases（数据库）（完成）
- Networking（网络）（完成）
- Systems Administration（系统管理）（完成）
- Continuous Integration（持续集成）（完成）
- Speed（速度）（完成）
- Scientific Applications（科学应用）（完成）
- Image Manipulation（图像处理）（完成）
- XML parsing（XML解析）（完成）
- JSON（JSON）（完成）
- Cryptography（密码学）（完成）
- Interfacing with C/C++ Libraries（与C/C++库交互）（完成）
- Machine Learning（机器学习）（完成）
- Data Serialization（数据序列化）（完成）

Shipping Great Code（部署优雅的代码）（完成）
---------------------------
- Packaging Your Code（打包您的代码）（完成）
- Freezing Your Code（冻结您的代码）（完成）

Development Environment（开发环境）（完成）
---------------------------
- Your Development Environment（您的开发环境）（完成）
- Virtual Environments（虚拟环境）（完成）
- Further Configuration of Pip and Virtualenv（Pip和Virtualenv的更多配置）（完成）

Additional Notes（额外关注）（完成）
---------------------------
- Introduction（介绍）（完成）
- The Community（社区）（完成）
- Learning Python（学习Python）（完成）
- Documentation（文档）（完成）
- News（新闻）（完成）

其他（完成）
---------------------------
- Contribute（贡献）（完成）
- License（许可证）（完成）
- The Guide Style Guide（风格指南指引）（完成）