Python, the world’s most useful language, has been officially supported without Chinese documentation. Friends are used to original English documents, but if there is an official Chinese document, it will be much faster to consult or understand. This article introduces the Chinese documentation hidden in the Python official website

  • Official Chinese document address: docs.python.org/zh-cn

In the past, there were some Python Chinese documents maintained by third parties, but they could not be updated and maintained synchronously due to human resources and other limitations. There are many high-quality Python Chinese resources available, but most of them are books or tutorials written by Daniel, and the translation of official documents is not guaranteed.

Recently many developers have noticed that Python now has an official Chinese documentation, but you can’t see it directly from the Python documentation interface. As shown in the Python documentation, only English, French, Japanese, and Korean are available. We do not see Chinese.

But if we manually type in the address bar useful – cn, that is: https://docs.python.org/zh-cn, then we can see the official document in Chinese. As follows, we can now see the Chinese option directly from the dropdown. Because higher-level content such as the Python/C API interface is in English, it is likely that the Chinese documentation is still in progress and not fully open.

What are the official Chinese documents

At present, the official Chinese document has several mainstream versions of 3.8.0 A2, 3.7.3, 3.6.8 and 2.7.16. Compared with the English document, only 3.5.7 is missing. For each Python release, the documentation contains a lot of content, including introductory tutorials and language references that have been translated into Chinese, as well as other basic content, such as new changes for each version, installing and distributing Python modules, faQs, and so on.

However, some higher-level topics, such as Python/C API interfaces, standard library references, extensions, and embedding, remain largely in English. Some of these are difficult to understand, and perhaps they require more of the translator, and the completion is slower.

For starters, introductory tutorials and Python language references are probably the most desirable. The getting Started tutorial informally introduces the basic concepts and functions of the Python language. It is best to have a Python interpreter ready to practice with as you read, but all the examples are independent of each other, so this tutorial can also be read offline.

The Python language Reference provides more formal syntax and “core semantics” than the introductory tutorial. This reference is very concise, and it wants to keep the knowledge points accurate and complete. In addition to these two basic learning materials, the Python documentation provides two additional manuals for C/C++, although these higher-level materials are not yet available in Chinese.

Finally, the Python Chinese documentation has a little Easter egg that goes through all the Python terms. Many times, these terms have different translations and expressions. For example, a decorator can be either reserved or translated as a decorator or decorator. Perhaps in the future, this official vocabulary will help us find a more appropriate expression.



How to search for Chinese documents

Retrieving Python functions or usages is probably a common method of documentation for most developers. For example, if we want to find the use of functional programming, we can search for Lambda in the Chinese documentation:

The flow control tool has a brief introduction to the use of the anonymous function Lambda, while only a small portion of the important functional programming guidelines have been translated for now. The retrieved Lambda usage guide is shown below.