Expand Up @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: Python 3.10\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date:2020-06-20 18:08+0800 \n" "POT-Creation-Date:2021-12-18 00:09+0000 \n" "PO-Revision-Date: 2018-05-23 14:09+0000\n" "Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n" "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-" Expand Down Expand Up @@ -97,6 +97,11 @@ msgstr "``bztar``" msgid "bzip2'ed tar file (:file:`.tar.bz2`)" msgstr "" #: ../../distutils/sourcedist.rst:34 ../../distutils/sourcedist.rst:37 #: ../../distutils/sourcedist.rst:43 msgid "\\(5)" msgstr "\\(5)" #: ../../distutils/sourcedist.rst:37 msgid "``xztar``" msgstr "``xztar``" Expand All @@ -114,8 +119,8 @@ msgid "compressed tar file (:file:`.tar.Z`)" msgstr "" #: ../../distutils/sourcedist.rst:40 msgid "\\(4 )" msgstr "\\(4 )" msgid "(4),(5 )" msgstr "(4),(5 )" #: ../../distutils/sourcedist.rst:43 msgid "``tar``" Expand Down Expand Up @@ -155,71 +160,77 @@ msgstr "" #: ../../distutils/sourcedist.rst:65 msgid "" "deprecated by `PEP 527 <https://www.python.org/dev/peps/pep-0527/>`_; `PyPI " "<https://pypi.org>`_ only accepts ``.zip`` and ``.tar.gz`` files." msgstr "" #: ../../distutils/sourcedist.rst:68 msgid "" "When using any ``tar`` format (``gztar``, ``bztar``, ``xztar``, ``ztar`` or " "``tar``), under Unix you can specify the ``owner`` and ``group`` names that " "will be set for each member of the archive." msgstr "" #: ../../distutils/sourcedist.rst:69 #: ../../distutils/sourcedist.rst:72 msgid "For example, if you want all files of the archive to be owned by root::" msgstr "" #: ../../distutils/sourcedist.rst:77 #: ../../distutils/sourcedist.rst:80 msgid "Specifying the files to distribute" msgstr "" #: ../../distutils/sourcedist.rst:79 #: ../../distutils/sourcedist.rst:82 msgid "" "If you don't supply an explicit list of files (or instructions on how to " "generate one), the :command:`sdist` command puts a minimal default set into " "the source distribution:" msgstr "" #: ../../distutils/sourcedist.rst:83 #: ../../distutils/sourcedist.rst:86 msgid "" "all Python source files implied by the ``py_modules`` and ``packages`` " "options" msgstr "" #: ../../distutils/sourcedist.rst:86 #: ../../distutils/sourcedist.rst:89 msgid "" "all C source files mentioned in the ``ext_modules`` or ``libraries`` options" msgstr "" #: ../../distutils/sourcedist.rst:92 #: ../../distutils/sourcedist.rst:95 msgid "" "scripts identified by the ``scripts`` option See :ref:`distutils-installing-" "scripts`." msgstr "" #: ../../distutils/sourcedist.rst:95 #: ../../distutils/sourcedist.rst:98 msgid "" "anything that looks like a test script: :file:`test/test\\*.py` (currently, " "the Distutils don't do anything with test scripts except include them in " "source distributions, but in the future there will be a standard for testing " "Python module distributions)" msgstr "" #: ../../distutils/sourcedist.rst:100 #: ../../distutils/sourcedist.rst:103 msgid "" "Any of the standard README files (:file:`README`, :file:`README.txt`, or :" "file:`README.rst`), :file:`setup.py` (or whatever you called your setup " "script), and :file:`setup.cfg`." msgstr "" #: ../../distutils/sourcedist.rst:104 #: ../../distutils/sourcedist.rst:107 msgid "" "all files that matches the ``package_data`` metadata. See :ref:`distutils-" "installing-package-data`." msgstr "" #: ../../distutils/sourcedist.rst:107 #: ../../distutils/sourcedist.rst:110 msgid "" "all files that matches the ``data_files`` metadata. See :ref:`distutils-" "additional-files`." msgstr "" #: ../../distutils/sourcedist.rst:110 #: ../../distutils/sourcedist.rst:113 msgid "" "Sometimes this is enough, but usually you will want to specify additional " "files to distribute. The typical way to do this is to write a *manifest " Expand All @@ -231,46 +242,46 @@ msgid "" "filesystem." msgstr "" #: ../../distutils/sourcedist.rst:118 #: ../../distutils/sourcedist.rst:121 msgid "" "If you prefer to roll your own manifest file, the format is simple: one " "filename per line, regular files (or symlinks to them) only. If you do " "supply your own :file:`MANIFEST`, you must specify everything: the default " "set of files described above does not apply in this case." msgstr "" #: ../../distutils/sourcedist.rst:123 #: ../../distutils/sourcedist.rst:126 msgid "" "An existing generated :file:`MANIFEST` will be regenerated without :command:" "`sdist` comparing its modification time to the one of :file:`MANIFEST.in` " "or :file:`setup.py`." msgstr "" #: ../../distutils/sourcedist.rst:128 #: ../../distutils/sourcedist.rst:131 msgid "" ":file:`MANIFEST` files start with a comment indicating they are generated. " "Files without this comment are not overwritten or removed." msgstr "" #: ../../distutils/sourcedist.rst:132 #: ../../distutils/sourcedist.rst:135 msgid "" ":command:`sdist` will read a :file:`MANIFEST` file if no :file:`MANIFEST.in` " "exists, like it used to do." msgstr "" #: ../../distutils/sourcedist.rst:136 #: ../../distutils/sourcedist.rst:139 msgid "" ":file:`README.rst` is now included in the list of distutils standard READMEs." msgstr "" #: ../../distutils/sourcedist.rst:140 #: ../../distutils/sourcedist.rst:143 msgid "" "The manifest template has one command per line, where each command specifies " "a set of files to include or exclude from the source distribution. For an " "example, again we turn to the Distutils' own manifest template:" msgstr "" #: ../../distutils/sourcedist.rst:150 #: ../../distutils/sourcedist.rst:153 msgid "" "The meanings should be fairly clear: include all files in the distribution " "root matching :file:`\\*.txt`, all files anywhere under the :file:`examples` " Expand All @@ -283,7 +294,7 @@ msgid "" "language; see section :ref:`sdist-cmd`." msgstr "" #: ../../distutils/sourcedist.rst:160 #: ../../distutils/sourcedist.rst:163 msgid "" "The order of commands in the manifest template matters: initially, we have " "the list of default files as described above, and each command in the " Expand All @@ -292,137 +303,137 @@ msgid "" "in the source distribution:" msgstr "" #: ../../distutils/sourcedist.rst:166 #: ../../distutils/sourcedist.rst:169 msgid "all files in the Distutils \"build\" tree (default :file:`build/`)" msgstr "" #: ../../distutils/sourcedist.rst:168 #: ../../distutils/sourcedist.rst:171 msgid "" "all files in directories named :file:`RCS`, :file:`CVS`, :file:`.svn`, :file:" "`.hg`, :file:`.git`, :file:`.bzr` or :file:`_darcs`" msgstr "" #: ../../distutils/sourcedist.rst:171 #: ../../distutils/sourcedist.rst:174 msgid "" "Now we have our complete list of files, which is written to the manifest for " "future reference, and then used to build the source distribution archive(s)." msgstr "" #: ../../distutils/sourcedist.rst:174 #: ../../distutils/sourcedist.rst:177 msgid "" "You can disable the default set of included files with the :option:`!--no-" "defaults` option, and you can disable the standard exclude set with :option:" "`!--no-prune`." msgstr "" #: ../../distutils/sourcedist.rst:178 #: ../../distutils/sourcedist.rst:181 msgid "" "Following the Distutils' own manifest template, let's trace how the :command:" "`sdist` command builds the list of files to include in the Distutils source " "distribution:" msgstr "" #: ../../distutils/sourcedist.rst:182 #: ../../distutils/sourcedist.rst:185 msgid "" "include all Python source files in the :file:`distutils` and :file:" "`distutils/command` subdirectories (because packages corresponding to those " "two directories were mentioned in the ``packages`` option in the setup " "script---see section :ref:`setup-script`)" msgstr "" #: ../../distutils/sourcedist.rst:187 #: ../../distutils/sourcedist.rst:190 msgid "" "include :file:`README.txt`, :file:`setup.py`, and :file:`setup.cfg` " "(standard files)" msgstr "" #: ../../distutils/sourcedist.rst:190 #: ../../distutils/sourcedist.rst:193 msgid "include :file:`test/test\\*.py` (standard files)" msgstr "" #: ../../distutils/sourcedist.rst:192 #: ../../distutils/sourcedist.rst:195 msgid "" "include :file:`\\*.txt` in the distribution root (this will find :file:" "`README.txt` a second time, but such redundancies are weeded out later)" msgstr "" #: ../../distutils/sourcedist.rst:195 #: ../../distutils/sourcedist.rst:198 msgid "" "include anything matching :file:`\\*.txt` or :file:`\\*.py` in the sub-tree " "under :file:`examples`," msgstr "" #: ../../distutils/sourcedist.rst:198 #: ../../distutils/sourcedist.rst:201 msgid "" "exclude all files in the sub-trees starting at directories matching :file:" "`examples/sample?/build`\\ ---this may exclude files included by the " "previous two steps, so it's important that the ``prune`` command in the " "manifest template comes after the ``recursive-include`` command" msgstr "" #: ../../distutils/sourcedist.rst:203 #: ../../distutils/sourcedist.rst:206 msgid "" "exclude the entire :file:`build` tree, and any :file:`RCS`, :file:`CVS`, :" "file:`.svn`, :file:`.hg`, :file:`.git`, :file:`.bzr` and :file:`_darcs` " "directories" msgstr "" #: ../../distutils/sourcedist.rst:207 #: ../../distutils/sourcedist.rst:210 msgid "" "Just like in the setup script, file and directory names in the manifest " "template should always be slash-separated; the Distutils will take care of " "converting them to the standard representation on your platform. That way, " "the manifest template is portable across operating systems." msgstr "" #: ../../distutils/sourcedist.rst:216 #: ../../distutils/sourcedist.rst:219 msgid "Manifest-related options" msgstr "" #: ../../distutils/sourcedist.rst:218 #: ../../distutils/sourcedist.rst:221 msgid "" "The normal course of operations for the :command:`sdist` command is as " "follows:" msgstr "" #: ../../distutils/sourcedist.rst:220 #: ../../distutils/sourcedist.rst:223 msgid "" "if the manifest file (:file:`MANIFEST` by default) exists and the first line " "does not have a comment indicating it is generated from :file:`MANIFEST.in`, " "then it is used as is, unaltered" msgstr "" #: ../../distutils/sourcedist.rst:224 #: ../../distutils/sourcedist.rst:227 msgid "" "if the manifest file doesn't exist or has been previously automatically " "generated, read :file:`MANIFEST.in` and create the manifest" msgstr "" #: ../../distutils/sourcedist.rst:227 #: ../../distutils/sourcedist.rst:230 msgid "" "if neither :file:`MANIFEST` nor :file:`MANIFEST.in` exist, create a manifest " "with just the default file set" msgstr "" #: ../../distutils/sourcedist.rst:230 #: ../../distutils/sourcedist.rst:233 msgid "" "use the list of files now in :file:`MANIFEST` (either just generated or read " "in) to create the source distribution archive(s)" msgstr "" #: ../../distutils/sourcedist.rst:233 #: ../../distutils/sourcedist.rst:236 msgid "" "There are a couple of options that modify this behaviour. First, use the :" "option:`!--no-defaults` and :option:`!--no-prune` to disable the standard " "\"include\" and \"exclude\" sets." msgstr "" #: ../../distutils/sourcedist.rst:237 #: ../../distutils/sourcedist.rst:240 msgid "" "Second, you might just want to (re)generate the manifest, but not create a " "source distribution::" msgstr "" #: ../../distutils/sourcedist.rst:242 #: ../../distutils/sourcedist.rst:245 msgid ":option:`!-o` is a shortcut for :option:`!--manifest-only`." msgstr ""