77msgstr ""
88"Project-Id-Version :Python 3.10\n "
99"Report-Msgid-Bugs-To :\n "
10- "POT-Creation-Date :2022-06-22 00:18 +0000\n "
10+ "POT-Creation-Date :2022-10-11 00:23 +0000\n "
1111"PO-Revision-Date :2018-05-23 16:15+0000\n "
1212"Last-Translator :Adrian Liaw <adrianliaw2000@gmail.com>\n "
1313"Language-Team :Chinese - TAIWAN (https://github.com/python/python-docs-zh- "
@@ -333,113 +333,129 @@ msgid ""
333333"environment in ``PATH``."
334334msgstr ""
335335
336- #: ../../library/venv.rst:91
336+ #: ../../library/venv.rst:87
337+ msgid ""
338+ "Because scripts installed in environments should not expect the environment "
339+ "to be activated, their shebang lines contain the absolute paths to their "
340+ "environment's interpreters. Because of this, environments are inherently non-"
341+ "portable, in the general case. You should always have a simple means of "
342+ "recreating an environment (for example, if you have a requirements file "
343+ "``requirements.txt``, you can invoke ``pip install -r requirements.txt`` "
344+ "using the environment's ``pip`` to install all of the packages needed by the "
345+ "environment). If for any reason you need to move the environment to a new "
346+ "location, you should recreate it at the desired location and delete the one "
347+ "at the old location. If you move an environment because you moved a parent "
348+ "directory of it, you should recreate the environment in its new location. "
349+ "Otherwise, software installed into the environment may not work as expected."
350+ msgstr ""
351+
352+ #: ../../library/venv.rst:104
337353msgid "API"
338354msgstr "API"
339355
340- #: ../../library/venv.rst:95
356+ #: ../../library/venv.rst:108
341357msgid ""
342358"The high-level method described above makes use of a simple API which "
343359"provides mechanisms for third-party virtual environment creators to "
344360"customize environment creation according to their needs, the :class:"
345361"`EnvBuilder` class."
346362msgstr ""
347363
348- #: ../../library/venv.rst:103
364+ #: ../../library/venv.rst:116
349365msgid ""
350366"The :class:`EnvBuilder` class accepts the following keyword arguments on "
351367"instantiation:"
352368msgstr ""
353369
354- #: ../../library/venv.rst:106
370+ #: ../../library/venv.rst:119
355371msgid ""
356372"``system_site_packages`` -- a Boolean value indicating that the system "
357373"Python site-packages should be available to the environment (defaults to "
358374"``False``)."
359375msgstr ""
360376
361- #: ../../library/venv.rst:109
377+ #: ../../library/venv.rst:122
362378msgid ""
363379"``clear`` -- a Boolean value which, if true, will delete the contents of any "
364380"existing target directory, before creating the environment."
365381msgstr ""
366382
367- #: ../../library/venv.rst:112
383+ #: ../../library/venv.rst:125
368384msgid ""
369385"``symlinks`` -- a Boolean value indicating whether to attempt to symlink the "
370386"Python binary rather than copying."
371387msgstr ""
372388
373- #: ../../library/venv.rst:115
389+ #: ../../library/venv.rst:128
374390msgid ""
375391"``upgrade`` -- a Boolean value which, if true, will upgrade an existing "
376392"environment with the running Python - for use when that Python has been "
377393"upgraded in-place (defaults to ``False``)."
378394msgstr ""
379395
380- #: ../../library/venv.rst:119
396+ #: ../../library/venv.rst:132
381397msgid ""
382398"``with_pip`` -- a Boolean value which, if true, ensures pip is installed in "
383399"the virtual environment. This uses :mod:`ensurepip` with the ``--default-"
384400"pip`` option."
385401msgstr ""
386402
387- #: ../../library/venv.rst:123
403+ #: ../../library/venv.rst:136
388404msgid ""
389405"``prompt`` -- a String to be used after virtual environment is activated "
390406"(defaults to ``None`` which means directory name of the environment would be "
391407"used). If the special string ``\" .\" `` is provided, the basename of the "
392408"current directory is used as the prompt."
393409msgstr ""
394410
395- #: ../../library/venv.rst:128
411+ #: ../../library/venv.rst:141
396412msgid "``upgrade_deps`` -- Update the base venv modules to the latest on PyPI"
397413msgstr ""
398414
399- #: ../../library/venv.rst:130 ../../library/venv.rst:260
415+ #: ../../library/venv.rst:143 ../../library/venv.rst:273
400416msgid "Added the ``with_pip`` parameter"
401417msgstr "新增 ``with_pip`` 參數"
402418
403- #: ../../library/venv.rst:133 ../../library/venv.rst:263
419+ #: ../../library/venv.rst:146 ../../library/venv.rst:276
404420msgid "Added the ``prompt`` parameter"
405421msgstr "新增 ``prompt`` 參數"
406422
407- #: ../../library/venv.rst:136 ../../library/venv.rst:266
423+ #: ../../library/venv.rst:149 ../../library/venv.rst:279
408424msgid "Added the ``upgrade_deps`` parameter"
409425msgstr "新增 ``upgrade_deps`` 參數"
410426
411- #: ../../library/venv.rst:139
427+ #: ../../library/venv.rst:152
412428msgid ""
413429"Creators of third-party virtual environment tools will be free to use the "
414430"provided :class:`EnvBuilder` class as a base class."
415431msgstr ""
416432
417- #: ../../library/venv.rst:142
433+ #: ../../library/venv.rst:155
418434msgid "The returned env-builder is an object which has a method, ``create``:"
419435msgstr ""
420436
421- #: ../../library/venv.rst:146
437+ #: ../../library/venv.rst:159
422438msgid ""
423439"Create a virtual environment by specifying the target directory (absolute or "
424440"relative to the current directory) which is to contain the virtual "
425441"environment. The ``create`` method will either create the environment in "
426442"the specified directory, or raise an appropriate exception."
427443msgstr ""
428444
429- #: ../../library/venv.rst:152
445+ #: ../../library/venv.rst:165
430446msgid ""
431447"The ``create`` method of the :class:`EnvBuilder` class illustrates the hooks "
432448"available for subclass customization::"
433449msgstr ""
434450
435- #: ../../library/venv.rst:167
451+ #: ../../library/venv.rst:180
436452msgid ""
437453"Each of the methods :meth:`ensure_directories`, :meth:"
438454"`create_configuration`, :meth:`setup_python`, :meth:`setup_scripts` and :"
439455"meth:`post_setup` can be overridden."
440456msgstr ""
441457
442- #: ../../library/venv.rst:173
458+ #: ../../library/venv.rst:186
443459msgid ""
444460"Creates the environment directory and all necessary directories, and returns "
445461"a context object. This is just a holder for attributes (such as paths), for "
@@ -448,60 +464,60 @@ msgid ""
448464"an existing environment directory."
449465msgstr ""
450466
451- #: ../../library/venv.rst:181
467+ #: ../../library/venv.rst:194
452468msgid "Creates the ``pyvenv.cfg`` configuration file in the environment."
453469msgstr ""
454470
455- #: ../../library/venv.rst:185
471+ #: ../../library/venv.rst:198
456472msgid ""
457473"Creates a copy or symlink to the Python executable in the environment. On "
458474"POSIX systems, if a specific executable ``python3.x`` was used, symlinks to "
459475"``python`` and ``python3`` will be created pointing to that executable, "
460476"unless files with those names already exist."
461477msgstr ""
462478
463- #: ../../library/venv.rst:192
479+ #: ../../library/venv.rst:205
464480msgid ""
465481"Installs activation scripts appropriate to the platform into the virtual "
466482"environment."
467483msgstr ""
468484
469- #: ../../library/venv.rst:197
485+ #: ../../library/venv.rst:210
470486msgid ""
471487"Upgrades the core venv dependency packages (currently ``pip`` and "
472488"``setuptools``) in the environment. This is done by shelling out to the "
473489"``pip`` executable in the environment."
474490msgstr ""
475491
476- #: ../../library/venv.rst:205
492+ #: ../../library/venv.rst:218
477493msgid ""
478494"A placeholder method which can be overridden in third party implementations "
479495"to pre-install packages in the virtual environment or perform other post-"
480496"creation steps."
481497msgstr ""
482498
483- #: ../../library/venv.rst:209
499+ #: ../../library/venv.rst:222
484500msgid ""
485501"Windows now uses redirector scripts for ``python[w].exe`` instead of copying "
486502"the actual binaries. In 3.7.2 only :meth:`setup_python` does nothing unless "
487503"running from a build in the source tree."
488504msgstr ""
489505
490- #: ../../library/venv.rst:214
506+ #: ../../library/venv.rst:227
491507msgid ""
492508"Windows copies the redirector scripts as part of :meth:`setup_python` "
493509"instead of :meth:`setup_scripts`. This was not the case in 3.7.2. When using "
494510"symlinks, the original executables will be linked."
495511msgstr ""
496512
497- #: ../../library/venv.rst:219
513+ #: ../../library/venv.rst:232
498514msgid ""
499515"In addition, :class:`EnvBuilder` provides this utility method that can be "
500516"called from :meth:`setup_scripts` or :meth:`post_setup` in subclasses to "
501517"assist in installing custom scripts into the virtual environment."
502518msgstr ""
503519
504- #: ../../library/venv.rst:225
520+ #: ../../library/venv.rst:238
505521msgid ""
506522"*path* is the path to a directory that should contain subdirectories\" common"
507523"\" ,\" posix\" ,\" nt\" , each containing scripts destined for the bin "
@@ -510,64 +526,64 @@ msgid ""
510526"placeholders:"
511527msgstr ""
512528
513- #: ../../library/venv.rst:231
529+ #: ../../library/venv.rst:244
514530msgid ""
515531"``__VENV_DIR__`` is replaced with the absolute path of the environment "
516532"directory."
517533msgstr ""
518534
519- #: ../../library/venv.rst:234
535+ #: ../../library/venv.rst:247
520536msgid ""
521537"``__VENV_NAME__`` is replaced with the environment name (final path segment "
522538"of environment directory)."
523539msgstr ""
524540
525- #: ../../library/venv.rst:237
541+ #: ../../library/venv.rst:250
526542msgid ""
527543"``__VENV_PROMPT__`` is replaced with the prompt (the environment name "
528544"surrounded by parentheses and with a following space)"
529545msgstr ""
530546
531- #: ../../library/venv.rst:240
547+ #: ../../library/venv.rst:253
532548msgid ""
533549"``__VENV_BIN_NAME__`` is replaced with the name of the bin directory (either "
534550"``bin`` or ``Scripts``)."
535551msgstr ""
536552
537- #: ../../library/venv.rst:243
553+ #: ../../library/venv.rst:256
538554msgid ""
539555"``__VENV_PYTHON__`` is replaced with the absolute path of the environment's "
540556"executable."
541557msgstr ""
542558
543- #: ../../library/venv.rst:246
559+ #: ../../library/venv.rst:259
544560msgid ""
545561"The directories are allowed to exist (for when an existing environment is "
546562"being upgraded)."
547563msgstr ""
548564
549- #: ../../library/venv.rst:249
565+ #: ../../library/venv.rst:262
550566msgid "There is also a module-level convenience function:"
551567msgstr ""
552568
553- #: ../../library/venv.rst:255
569+ #: ../../library/venv.rst:268
554570msgid ""
555571"Create an :class:`EnvBuilder` with the given keyword arguments, and call "
556572"its :meth:`~EnvBuilder.create` method with the *env_dir* argument."
557573msgstr ""
558574
559- #: ../../library/venv.rst:270
575+ #: ../../library/venv.rst:283
560576msgid "An example of extending ``EnvBuilder``"
561577msgstr ""
562578
563- #: ../../library/venv.rst:272
579+ #: ../../library/venv.rst:285
564580msgid ""
565581"The following script shows how to extend :class:`EnvBuilder` by implementing "
566582"a subclass which installs setuptools and pip into a created virtual "
567583"environment::"
568584msgstr ""
569585
570- #: ../../library/venv.rst:491
586+ #: ../../library/venv.rst:504
571587msgid ""
572588"This script is also available for download `online <https://gist.github.com/"
573589"vsajip/4673395>`_."