Merge branch 'main' into fix-broken-link

Author: dukecat0

locales/zh_Hans/LC_MESSAGES/messages.po

@@ -6,21 +6,22 @@
 # bluewindde <13548563428@139.com>, 2021.
 # Cube Kassaki <2524737581@qq.com>, 2021.
 # xlivevil <xlivevil@163.com>, 2021.
+# Eric <spice2wolf@gmail.com>, 2021.
 msgid ""
 msgstr ""
 "Project-Id-Version: Python Packaging User Guide\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2021-07-06 19:32+0800\n"
-"PO-Revision-Date: 2021-09-05 14:34+0000\n"
-"Last-Translator: meowmeowmeowcat <meowmeowcat1211@gmail.com>\n"
+"PO-Revision-Date: 2021-09-13 10:46+0000\n"
+"Last-Translator: Zuorong Zhang <zuorong-zhang@outlook.com>\n"
 "Language-Team: Chinese (Simplified) <https://hosted.weblate.org/projects/"
 "pypa/packaging-python-org/zh_Hans/>\n"
 "Language: zh_Hans\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 "Plural-Forms: nplurals=1; plural=0;\n"
-"X-Generator: Weblate 4.8.1-dev\n"
+"X-Generator: Weblate 4.9-dev\n"
 
 #: ../source/contribute.rst:5
 msgid "Contribute to this guide"
@@ -162,7 +163,7 @@ msgid ""
 "Python 3.6 on your operating system."
 msgstr ""
 "Python 3.6。我们的构建脚本只为 Python 3.6 而设计。请参阅 `Hitchhiker's Guide to Python "
-"installation instructions`_ 以在你您的操作系统上安装Python 3.6。"
+"installation instructions`_ 将 Python 3.6 安装于您的操作系统中。"
 
 #: ../source/contribute.rst:91
 msgid ""
@@ -656,8 +657,9 @@ msgid ""
 "what index or source).  The where (i.e. how they are to be made \"Concrete"
 "\") is to be determined at install time using :ref:`pip` options. [1]_"
 msgstr ""
-"最后，重要的是要了解“install_requires”是“Abstract”要求的列表，即只是名称和版本限制，并不能确定从哪里满足依赖关系（即从什么索引"
-"或来源）。在安装时使用 :ref:`pip` 选项确定在哪里（即如何使它们“Concrete”）。 [1]_"
+"最后，重要的是要了解 ``install_requires`` "
+"是“Abstract”要求的列表，即只是名称和版本限制，并不能确定从哪里满足依赖关系（即从什么索引或来源）。在安装时使用 :ref:`pip` "
+"选项确定在哪里（即如何使它们“Concrete”）。 [1]_"
 
 #: ../source/discussions/install-requires-vs-requirements.rst:64
 #: ../source/tutorials/installing-packages.rst:460
@@ -699,8 +701,8 @@ msgid ""
 "\"Concrete\", i.e. associated with a particular index or directory of "
 "packages. [1]_"
 msgstr ""
-"而“install_requires”需求是“Abstract”，即不与任何特定索引相关联，需求文件通常包含诸如“--index-url”或"
-"“--find-links”之类的pip选项来提出需求“Concrete”，即与包的特定索引或目录相关联。 [1]_"
+"而 ``install_requires`` 需求是“Abstract”的，即不与任何特定索引相关联，需求文件通常包含 pip 选项，如 "
+"``--index-url`` 或 ``--find-links`` 使需求“Concrete”，即与包的特定索引或目录相关联。 [1]_"
 
 #: ../source/discussions/install-requires-vs-requirements.rst:84
 msgid ""
@@ -1020,6 +1022,8 @@ msgid ""
 "to distribute a :term:`Release`. The archive file is what an end-user will "
 "download from the internet and install."
 msgstr ""
+"一个版本化的存档文件包含 Python :term:`packages <Import Package>`、:term:`modules "
+"<Module>` 和其他用于分发:term:`Release` 的资源文件的版本化存档文件。存档文件是最终用户将从 Internet 下载并安装的文件。"
 
 #: ../source/glossary.rst:34
 msgid ""
@@ -1031,6 +1035,9 @@ msgid ""
 "distribution), which are often referred to with the single term "
 "\"distribution\"."
 msgstr ""
+"分发包更常被称为“包”或“分发”，但是当需要更清楚地防止与 :term:`Import Package` "
+"混淆时，本指南可能会使用扩展术语（通常也称为“包”）或另一种发行版（例如 Linux 发行版或 Python "
+"语言发行版），通常用单个术语“发行版”来指代。"
 
 #: ../source/glossary.rst:41
 msgid "Egg"
@@ -1067,7 +1074,7 @@ msgstr ""
 
 #: ../source/glossary.rst:59
 msgid "Known Good Set (KGS)"
-msgstr ""
+msgstr "已知良好集 (KGS)"
 
 #: ../source/glossary.rst:62
 msgid ""
@@ -1096,7 +1103,7 @@ msgid ""
 "\", but this guide will use the expanded term when more clarity is needed to "
 "prevent confusion with a :term:`Distribution Package` which is also commonly "
 "called a \"package\"."
-msgstr ""
+msgstr "导入包通常用单个词“包”来指代，但本指南将在需要更清楚地说明时使用扩展术语，以防止与通常也称为“包”的 :term:`分发包` 混淆."
 
 #: ../source/glossary.rst:78
 msgid "Module"
@@ -1107,6 +1114,8 @@ msgid ""
 "The basic unit of code reusability in Python, existing in one of two types: :"
 "term:`Pure Module`, or :term:`Extension Module`."
 msgstr ""
+"Python 中代码可重用性的基本单元，存在于以下两种类型之一：:term:`Pure Module` 或 :term:`Extension "
+"Module`。"
 
 #: ../source/glossary.rst:84
 msgid "Package Index"
@@ -1116,7 +1125,7 @@ msgstr "包索引 (Package Index)"
 msgid ""
 "A repository of distributions with a web interface to automate :term:"
 "`package <Distribution Package>` discovery and consumption."
-msgstr ""
+msgstr "一个带有 Web 界面的发行版存储库，用于自动化 :term:`package <Distribution Package>` 发现和消费。"
 
 #: ../source/glossary.rst:90
 msgid "Per Project Index"
@@ -1500,7 +1509,7 @@ msgstr ""
 
 #: ../source/guides/analyzing-pypi-package-downloads.rst:58
 msgid "Navigate to the `BigQuery web UI`_."
-msgstr "导航到 `BigQuery 网页界面<BigQuery web UI>`_ 。"
+msgstr "导航到 `BigQuery 网页用户界面`_。"
 
 #: ../source/guides/analyzing-pypi-package-downloads.rst:59
 msgid "Create a new project."
@@ -3266,7 +3275,7 @@ msgstr ""
 #: ../source/specifications/core-metadata.rst:693
 #: ../source/specifications/core-metadata.rst:722
 msgid "Examples::"
-msgstr "例子：:"
+msgstr "例子::"
 
 #: ../source/guides/dropping-older-python-versions.rst:86
 msgid ""

source/conf.py

@@ -389,26 +389,22 @@
 
 linkcheck_ignore = [
     "http://localhost:\d+",
-    # Ignoring these links as they will redirect to login page if folks haven't logged in.
-    "https://github.com/pypa/packaging-problems/issues/new?/*",
-    "https://console.cloud.google.com/bigquery/*",
-    "https://console.developers.google.com/apis/library/bigquery-json.googleapis.com",
-    "https://test.pypi.org/manage/account/#api-tokens",
-    "https://pypi.org/manage/account/#api-tokens",
-    # This shows that PyPI previously hosted at pypi.python.org
-    "https://pypi.python.org",
-    # Weblate has different UI for different languages
-    "https://weblate.org/",
-    # This is an example that showing to folks
+    # This is an example that showing to the reader
     "https://test.pypi.org/project/example-pkg-YOUR-USERNAME-HERE",
+    # Ignoring it as it will redirect to login page if reader hasn't logged in.
+    "https://pypi.org/manage/*",
+    "https://test.pypi.org/manage/*",
 ]
 
 # Example configuration for intersphinx: refer to the Python standard library.
 intersphinx_mapping = {
+    'openstack': ('https://docs.openstack.org/glance/latest/', None),
     'python': ('https://docs.python.org/3', None),
     'python2': ('https://docs.python.org/2', None),
     'pip': ('https://pip.pypa.io/en/latest/', None),
+    'scipy': ('https://www.scipy.org', None),
     'setuptools': ('https://setuptools.readthedocs.io/en/latest/', None),
+    'tox': ('https://tox.readthedocs.io/en/latest/', None),
     'twine': ('https://twine.readthedocs.io/en/stable/', None),
     'pypa': ('https://www.pypa.io/en/latest/', None),
     'nox': ('https://nox.thea.codes/en/latest/', None),

source/guides/distributing-packages-using-setuptools.rst

@@ -536,7 +536,7 @@ generated during the install of your :term:`distribution <Distribution
 Package>`.
 
 For more information, see `Automatic Script Creation
-<https://setuptools.readthedocs.io/en/latest/setuptools.html#automatic-script-creation>`_
+<https://setuptools.readthedocs.io/en/latest/userguide/quickstart.html#entry-points-and-automatic-script-creation>`_
 from the :doc:`setuptools docs <setuptools:index>`.
 
 .. _`Choosing a versioning scheme`:

source/guides/installing-scientific-packages.rst

@@ -91,8 +91,8 @@ published on python.org.
 
 macOS users also have access to Linux distribution style package managers
 such as ``MacPorts``. The SciPy site has more details on using MacPorts to
-install the `scientific Python stack
-<https://www.scipy.org/install.html#mac>`__
+install the :ref:`scientific Python stack
+<scipy:mac>`
 
 
 SciPy distributions

source/guides/installing-using-pip-and-virtual-environments.rst

@@ -301,7 +301,7 @@ specifying the extra in brackets:
         py -m pip install requests[security]
 
 .. _extras:
-    https://setuptools.readthedocs.io/en/latest/setuptools.html#declaring-extras-optional-features-with-their-own-dependencies
+    https://setuptools.readthedocs.io/en/latest/userguide/dependency_management.html#optional-dependencies
 
 
 Installing from source

source/guides/packaging-namespace-packages.rst

@@ -238,6 +238,6 @@ in the `pkg_resources namespace example project`_.
 
 .. _setuptools: https://setuptools.readthedocs.io/en/latest/
 .. _pkg_resources.declare_namespace:
-    https://setuptools.readthedocs.io/en/latest/setuptools.html#namespace-packages
+    https://setuptools.readthedocs.io/en/latest/pkg_resources.html#namespace-package-support
 .. _pkg_resources namespace example project:
     https://github.com/pypa/sample-namespace-packages/tree/master/pkg_resources

source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst

@@ -144,4 +144,5 @@ sure that your release pipeline remains healthy!
 .. _`pypa/gh-action-pypi-publish GitHub Action`:
    https://github.com/marketplace/actions/pypi-publish
 .. _Secrets:
-   https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners#creating-and-using-secrets-encrypted-variables
+   https://docs.github.com/en/actions/reference/encrypted-secrets
+

source/guides/supporting-windows-using-appveyor.rst

@@ -149,7 +149,7 @@ Additional notes
 Testing with tox
 ----------------
 
-Many projects use the `Tox`_ tool to run their tests. It ensures that tests
+Many projects use the :doc:`Tox <tox:index>` tool to run their tests. It ensures that tests
 are run in an isolated environment using the exact files that will be distributed
 by the project.
 
@@ -239,6 +239,6 @@ For reference, the SDK setup support script is listed here:
 
 .. _Appveyor: https://www.appveyor.com//
 .. _Travis: https://travis-ci.org/
-.. _Github: https://github.com/
+.. _Github: https://github.com
 .. _Bitbucket: https://bitbucket.org/
 .. _Tox: https://tox.readthedocs.io/en/latest/

source/key_projects.rst

@@ -370,8 +370,8 @@ fetching them from PyPI and modifying their metadata.
 devpi
 =====
 
-`Docs <https://devpi.net/docs/devpi/devpi/latest/%2Bd/index.html>`__ |
-`Issues <https://github.com/devpi/devpi/issues>`__ |
+`Docs <http://doc.devpi.net/latest/>`__ |
+:gh:`Issues <devpi/devpi/issues>` |
 `PyPI <https://pypi.org/project/devpi>`__
 
 devpi features a powerful PyPI-compatible server and PyPI proxy cache
@@ -406,8 +406,8 @@ Python 2, so long as they can be imported on Python 3.
 enscons
 =======
 
-`Source <https://github.com/dholth/enscons>`__ |
-`Issues <https://github.com/dholth/enscons/issues>`__ |
+:gh:`Source <dholth/enscons>` |
+:gh:`Issues <dholth/enscons/issues>` |
 `PyPI <https://pypi.org/project/enscons>`__
 
 Enscons is a Python packaging tool based on `SCons`_. It builds

source/overview.rst

@@ -205,8 +205,8 @@ respective packaging guides.
 * `Heroku <https://devcenter.heroku.com/articles/getting-started-with-python>`_
 * `Google App Engine <https://cloud.google.com/appengine/docs/python/>`_
 * `PythonAnywhere <https://www.pythonanywhere.com/>`_
-* `OpenShift <https://cloud.redhat.com/blog/getting-started-python>`_
-* "Serverless" frameworks like `Zappa <https://github.com/zappa/Zappa>`_
+* `OpenShift <https://blog.openshift.com/getting-started-python/>`_
+* "Serverless" frameworks like :gh:`Zappa <zappa/Zappa>`
 
 In all these setups, the platform takes care of packaging and
 deployment, as long as you follow their patterns. Most software does
@@ -228,7 +228,7 @@ If you're planning on releasing to these new frontiers, you'll want to
 check out the following frameworks, and refer to their packaging
 guides:
 
-* `Kivy <https://kivy.org/#home>`_
+* `Kivy <https://kivy.org/>`_
 * `Beeware <https://pybee.org/>`_
 * `Brython <https://brython.info/>`_
 * `Flexx <https://flexx.readthedocs.io/en/latest/>`_
@@ -248,9 +248,9 @@ machines of developers and data scientists.
 
 Technologies which support this model:
 
-* `PEX <https://github.com/pantsbuild/pex#pex>`_ (Python EXecutable)
+* :gh:`PEX <pantsbuild/pex#user-content-pex>` (Python EXecutable)
 * :doc:`zipapp <python:library/zipapp>` (does not help manage dependencies, requires Python 3.5+)
-* `shiv <https://github.com/linkedin/shiv#shiv>`_ (requires Python 3)
+* :gh:`shiv <linkedin/shiv#user-content-shiv>` (requires Python 3)
 
 .. note:: Of all the approaches here, depending on a pre-installed
           Python relies the most on the target environment. Of course,
@@ -290,7 +290,7 @@ A similar model involves installing an alternative Python
 distribution, but does not support arbitrary operating system-level
 packages:
 
-* `ActiveState ActivePython <https://www.activestate.com/products/python/>`_
+* `ActiveState ActivePython <https://www.activestate.com/activepython>`_
 * `WinPython <http://winpython.github.io/>`_
 
 .. _bringing-your-own-python:
@@ -323,8 +323,8 @@ A selection of Python freezers:
 * `pynsist <https://pypi.org/project/pynsist/>`_ - Windows only
 
 Most of the above imply single-user deployments. For multi-component
-server applications, see `Chef Omnibus
-<https://github.com/chef/omnibus#-omnibus>`_.
+server applications, see :gh:`Chef Omnibus
+<chef/omnibus#user-content--omnibus>`.
 
 
 Bringing your own userspace
@@ -361,7 +361,7 @@ data centers, though certain complex applications can benefit from
 this packaging. Technologies are Python agnostic, and include:
 
 * `Vagrant <https://www.vagrantup.com/>`_
-* `VHD <https://en.wikipedia.org/wiki/VHD_(file_format)>`_, `AMI <https://en.wikipedia.org/wiki/Amazon_Machine_Image>`_, and `other formats <https://docs.openstack.org/glance/pike/user/formats.html>`_
+* `VHD <https://en.wikipedia.org/wiki/VHD_(file_format)>`_, `AMI <https://en.wikipedia.org/wiki/Amazon_Machine_Image>`_, and :doc:`other formats <openstack:user/formats>`
 * `OpenStack <https://www.redhat.com/en/topics/openstack>`_ - A cloud management system in Python, with extensive VM support
 
 Bringing your own hardware
@@ -375,8 +375,7 @@ Whereas the virtual machines described above are primarily reserved
 for the tech-savvy, you can find hardware appliances being used by
 everyone from the most advanced data centers to the youngest children.
 
-Embed your code on an `Adafruit
-<https://github.com/adafruit/circuitpython#adafruit-circuitpython>`_,
+Embed your code on an :gh:`Adafruit <adafruit/circuitpython>`,
 `MicroPython <https://micropython.org/>`_, or more-powerful hardware
 running Python, then ship it to the datacenter or your users'
 homes. They plug and play, and you can call it a day.