-
-
Notifications
You must be signed in to change notification settings - Fork 46
Expand file tree
/
Copy pathwindows.po
More file actions
2057 lines (1714 loc) · 64 KB
/
windows.po
File metadata and controls
2057 lines (1714 loc) · 64 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
# Python Documentation Turkish Translation
# Copyright (C) 2001-2023, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.11\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-09-18 19:05+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: \n"
"Language-Team: TURKISH <python.docs.tr@gmail.com>\n"
"Language: tr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: using/windows.rst:7
msgid "Using Python on Windows"
msgstr ""
#: using/windows.rst:12
msgid ""
"This document aims to give an overview of Windows-specific behaviour you "
"should know about when using Python on Microsoft Windows."
msgstr ""
#: using/windows.rst:15
msgid ""
"Unlike most Unix systems and services, Windows does not include a system "
"supported installation of Python. To make Python available, the CPython team "
"has compiled Windows installers (MSI packages) with every `release <https://"
"www.python.org/download/releases/>`_ for many years. These installers are "
"primarily intended to add a per-user installation of Python, with the core "
"interpreter and library being used by a single user. The installer is also "
"able to install for all users of a single machine, and a separate ZIP file "
"is available for application-local distributions."
msgstr ""
#: using/windows.rst:24
msgid ""
"As specified in :pep:`11`, a Python release only supports a Windows platform "
"while Microsoft considers the platform under extended support. This means "
"that Python |version| supports Windows 8.1 and newer. If you require Windows "
"7 support, please install Python 3.8."
msgstr ""
#: using/windows.rst:29
msgid ""
"There are a number of different installers available for Windows, each with "
"certain benefits and downsides."
msgstr ""
#: using/windows.rst:32
msgid ""
":ref:`windows-full` contains all components and is the best option for "
"developers using Python for any kind of project."
msgstr ""
#: using/windows.rst:35
msgid ""
":ref:`windows-store` is a simple installation of Python that is suitable for "
"running scripts and packages, and using IDLE or other development "
"environments. It requires Windows 10 and above, but can be safely installed "
"without corrupting other programs. It also provides many convenient commands "
"for launching Python and its tools."
msgstr ""
#: using/windows.rst:41
msgid ""
":ref:`windows-nuget` are lightweight installations intended for continuous "
"integration systems. It can be used to build Python packages or run scripts, "
"but is not updateable and has no user interface tools."
msgstr ""
#: using/windows.rst:45
msgid ""
":ref:`windows-embeddable` is a minimal package of Python suitable for "
"embedding into a larger application."
msgstr ""
#: using/windows.rst:52
msgid "The full installer"
msgstr ""
#: using/windows.rst:55
msgid "Installation steps"
msgstr ""
#: using/windows.rst:57
msgid ""
"Four Python |version| installers are available for download - two each for "
"the 32-bit and 64-bit versions of the interpreter. The *web installer* is a "
"small initial download, and it will automatically download the required "
"components as necessary. The *offline installer* includes the components "
"necessary for a default installation and only requires an internet "
"connection for optional features. See :ref:`install-layout-option` for other "
"ways to avoid downloading during installation."
msgstr ""
#: using/windows.rst:65
msgid "After starting the installer, one of two options may be selected:"
msgstr ""
#: using/windows.rst:69
msgid "If you select \"Install Now\":"
msgstr ""
#: using/windows.rst:71
msgid ""
"You will *not* need to be an administrator (unless a system update for the C "
"Runtime Library is required or you install the :ref:`launcher` for all users)"
msgstr ""
#: using/windows.rst:74
msgid "Python will be installed into your user directory"
msgstr ""
#: using/windows.rst:75
msgid ""
"The :ref:`launcher` will be installed according to the option at the bottom "
"of the first page"
msgstr ""
#: using/windows.rst:77
msgid "The standard library, test suite, launcher and pip will be installed"
msgstr ""
#: using/windows.rst:78
msgid "If selected, the install directory will be added to your :envvar:`PATH`"
msgstr ""
#: using/windows.rst:79
msgid "Shortcuts will only be visible for the current user"
msgstr ""
#: using/windows.rst:81
msgid ""
"Selecting \"Customize installation\" will allow you to select the features "
"to install, the installation location and other options or post-install "
"actions. To install debugging symbols or binaries, you will need to use this "
"option."
msgstr ""
#: using/windows.rst:85
msgid ""
"To perform an all-users installation, you should select \"Customize "
"installation\". In this case:"
msgstr ""
#: using/windows.rst:88
msgid "You may be required to provide administrative credentials or approval"
msgstr ""
#: using/windows.rst:89
msgid "Python will be installed into the Program Files directory"
msgstr ""
#: using/windows.rst:90
msgid "The :ref:`launcher` will be installed into the Windows directory"
msgstr ""
#: using/windows.rst:91
msgid "Optional features may be selected during installation"
msgstr ""
#: using/windows.rst:92
msgid "The standard library can be pre-compiled to bytecode"
msgstr ""
#: using/windows.rst:93
msgid ""
"If selected, the install directory will be added to the system :envvar:`PATH`"
msgstr ""
#: using/windows.rst:94
msgid "Shortcuts are available for all users"
msgstr ""
#: using/windows.rst:99
msgid "Removing the MAX_PATH Limitation"
msgstr ""
#: using/windows.rst:101
msgid ""
"Windows historically has limited path lengths to 260 characters. This meant "
"that paths longer than this would not resolve and errors would result."
msgstr ""
#: using/windows.rst:104
msgid ""
"In the latest versions of Windows, this limitation can be expanded to "
"approximately 32,000 characters. Your administrator will need to activate "
"the \"Enable Win32 long paths\" group policy, or set ``LongPathsEnabled`` to "
"``1`` in the registry key "
"``HKEY_LOCAL_MACHINE\\SYSTEM\\CurrentControlSet\\Control\\FileSystem``."
msgstr ""
#: using/windows.rst:110
msgid ""
"This allows the :func:`open` function, the :mod:`os` module and most other "
"path functionality to accept and return paths longer than 260 characters."
msgstr ""
#: using/windows.rst:113
msgid "After changing the above option, no further configuration is required."
msgstr ""
#: using/windows.rst:117
msgid "Support for long paths was enabled in Python."
msgstr ""
#: using/windows.rst:122
msgid "Installing Without UI"
msgstr ""
#: using/windows.rst:124
msgid ""
"All of the options available in the installer UI can also be specified from "
"the command line, allowing scripted installers to replicate an installation "
"on many machines without user interaction. These options may also be set "
"without suppressing the UI in order to change some of the defaults."
msgstr ""
#: using/windows.rst:129
msgid ""
"To completely hide the installer UI and install Python silently, pass the ``/"
"quiet`` option. To skip past the user interaction but still display progress "
"and errors, pass the ``/passive`` option. The ``/uninstall`` option may be "
"passed to immediately begin removing Python - no confirmation prompt will be "
"displayed."
msgstr ""
#: using/windows.rst:135
msgid ""
"All other options are passed as ``name=value``, where the value is usually "
"``0`` to disable a feature, ``1`` to enable a feature, or a path. The full "
"list of available options is shown below."
msgstr ""
#: using/windows.rst:1069
msgid "Name"
msgstr ""
#: using/windows.rst:1069
msgid "Description"
msgstr ""
#: using/windows.rst:140
msgid "Default"
msgstr ""
#: using/windows.rst:142
msgid "InstallAllUsers"
msgstr ""
#: using/windows.rst:142
msgid "Perform a system-wide installation."
msgstr ""
#: using/windows.rst:168 using/windows.rst:175 using/windows.rst:206
#: using/windows.rst:217
msgid "0"
msgstr ""
#: using/windows.rst:144
msgid "TargetDir"
msgstr ""
#: using/windows.rst:144
msgid "The installation directory"
msgstr ""
#: using/windows.rst:144
msgid "Selected based on InstallAllUsers"
msgstr ""
#: using/windows.rst:147
msgid "DefaultAllUsersTargetDir"
msgstr ""
#: using/windows.rst:147
msgid "The default installation directory for all-user installs"
msgstr ""
#: using/windows.rst:147
msgid ""
":file:`%ProgramFiles%\\\\\\ Python X.Y` or :file:`\\ %ProgramFiles(x86)%\\\\"
"\\ Python X.Y`"
msgstr ""
#: using/windows.rst:152
msgid "DefaultJustForMeTargetDir"
msgstr ""
#: using/windows.rst:152
msgid "The default install directory for just-for-me installs"
msgstr ""
#: using/windows.rst:152
msgid ""
":file:`%LocalAppData%\\\\\\ Programs\\\\Python\\\\\\ PythonXY` or :file:"
"`%LocalAppData%\\\\\\ Programs\\\\Python\\\\\\ PythonXY-32` or :file:"
"`%LocalAppData%\\\\\\ Programs\\\\Python\\\\\\ PythonXY-64`"
msgstr ""
#: using/windows.rst:162
msgid "DefaultCustomTargetDir"
msgstr ""
#: using/windows.rst:162
msgid "The default custom install directory displayed in the UI"
msgstr ""
#: using/windows.rst:219
msgid "(empty)"
msgstr ""
#: using/windows.rst:165
msgid "AssociateFiles"
msgstr ""
#: using/windows.rst:165
msgid "Create file associations if the launcher is also installed."
msgstr ""
#: using/windows.rst:179 using/windows.rst:186 using/windows.rst:194
#: using/windows.rst:200 using/windows.rst:208 using/windows.rst:212
msgid "1"
msgstr ""
#: using/windows.rst:168
msgid "CompileAll"
msgstr ""
#: using/windows.rst:168
msgid "Compile all ``.py`` files to ``.pyc``."
msgstr ""
#: using/windows.rst:171
msgid "PrependPath"
msgstr ""
#: using/windows.rst:171
msgid ""
"Prepend install and Scripts directories to :envvar:`PATH` and add ``.PY`` "
"to :envvar:`PATHEXT`"
msgstr ""
#: using/windows.rst:175
msgid "AppendPath"
msgstr ""
#: using/windows.rst:175
msgid ""
"Append install and Scripts directories to :envvar:`PATH` and add ``.PY`` "
"to :envvar:`PATHEXT`"
msgstr ""
#: using/windows.rst:179
msgid "Shortcuts"
msgstr ""
#: using/windows.rst:179
msgid ""
"Create shortcuts for the interpreter, documentation and IDLE if installed."
msgstr ""
#: using/windows.rst:182
msgid "Include_doc"
msgstr ""
#: using/windows.rst:182
msgid "Install Python manual"
msgstr ""
#: using/windows.rst:184
msgid "Include_debug"
msgstr ""
#: using/windows.rst:184
msgid "Install debug binaries"
msgstr ""
#: using/windows.rst:186
msgid "Include_dev"
msgstr ""
#: using/windows.rst:186
msgid ""
"Install developer headers and libraries. Omitting this may lead to an "
"unusable installation."
msgstr ""
#: using/windows.rst:190
msgid "Include_exe"
msgstr ""
#: using/windows.rst:190
msgid ""
"Install :file:`python.exe` and related files. Omitting this may lead to an "
"unusable installation."
msgstr ""
#: using/windows.rst:194
msgid "Include_launcher"
msgstr ""
#: using/windows.rst:194
msgid "Install :ref:`launcher`."
msgstr ""
#: using/windows.rst:196
msgid "InstallLauncherAllUsers"
msgstr ""
#: using/windows.rst:196
msgid ""
"Installs the launcher for all users. Also requires ``Include_launcher`` to "
"be set to 1"
msgstr ""
#: using/windows.rst:200
msgid "Include_lib"
msgstr ""
#: using/windows.rst:200
msgid ""
"Install standard library and extension modules. Omitting this may lead to an "
"unusable installation."
msgstr ""
#: using/windows.rst:204
msgid "Include_pip"
msgstr ""
#: using/windows.rst:204
msgid "Install bundled pip and setuptools"
msgstr ""
#: using/windows.rst:206
msgid "Include_symbols"
msgstr ""
#: using/windows.rst:206
msgid "Install debugging symbols (``*.pdb``)"
msgstr ""
#: using/windows.rst:208
msgid "Include_tcltk"
msgstr ""
#: using/windows.rst:208
msgid "Install Tcl/Tk support and IDLE"
msgstr ""
#: using/windows.rst:210
msgid "Include_test"
msgstr ""
#: using/windows.rst:210
msgid "Install standard library test suite"
msgstr ""
#: using/windows.rst:212
msgid "Include_tools"
msgstr ""
#: using/windows.rst:212
msgid "Install utility scripts"
msgstr ""
#: using/windows.rst:214
msgid "LauncherOnly"
msgstr ""
#: using/windows.rst:214
msgid "Only installs the launcher. This will override most other options."
msgstr ""
#: using/windows.rst:217
msgid "SimpleInstall"
msgstr ""
#: using/windows.rst:217
msgid "Disable most install UI"
msgstr ""
#: using/windows.rst:219
msgid "SimpleInstallDescription"
msgstr ""
#: using/windows.rst:219
msgid "A custom message to display when the simplified install UI is used."
msgstr ""
#: using/windows.rst:223
msgid ""
"For example, to silently install a default, system-wide Python installation, "
"you could use the following command (from an elevated command prompt)::"
msgstr ""
#: using/windows.rst:228
msgid ""
"To allow users to easily install a personal copy of Python without the test "
"suite, you could provide a shortcut with the following command. This will "
"display a simplified initial page and disallow customization::"
msgstr ""
#: using/windows.rst:235
msgid ""
"(Note that omitting the launcher also omits file associations, and is only "
"recommended for per-user installs when there is also a system-wide "
"installation that included the launcher.)"
msgstr ""
#: using/windows.rst:239
msgid ""
"The options listed above can also be provided in a file named ``unattend."
"xml`` alongside the executable. This file specifies a list of options and "
"values. When a value is provided as an attribute, it will be converted to a "
"number if possible. Values provided as element text are always left as "
"strings. This example file sets the same options as the previous example:"
msgstr ""
#: using/windows.rst:258
msgid "Installing Without Downloading"
msgstr ""
#: using/windows.rst:260
msgid ""
"As some features of Python are not included in the initial installer "
"download, selecting those features may require an internet connection. To "
"avoid this need, all possible components may be downloaded on-demand to "
"create a complete *layout* that will no longer require an internet "
"connection regardless of the selected features. Note that this download may "
"be bigger than required, but where a large number of installations are going "
"to be performed it is very useful to have a locally cached copy."
msgstr ""
#: using/windows.rst:268
msgid ""
"Execute the following command from Command Prompt to download all possible "
"required files. Remember to substitute ``python-3.9.0.exe`` for the actual "
"name of your installer, and to create layouts in their own directories to "
"avoid collisions between files with the same name."
msgstr ""
#: using/windows.rst:277
msgid ""
"You may also specify the ``/quiet`` option to hide the progress display."
msgstr ""
#: using/windows.rst:280
msgid "Modifying an install"
msgstr ""
#: using/windows.rst:282
msgid ""
"Once Python has been installed, you can add or remove features through the "
"Programs and Features tool that is part of Windows. Select the Python entry "
"and choose \"Uninstall/Change\" to open the installer in maintenance mode."
msgstr ""
#: using/windows.rst:286
msgid ""
"\"Modify\" allows you to add or remove features by modifying the checkboxes "
"- unchanged checkboxes will not install or remove anything. Some options "
"cannot be changed in this mode, such as the install directory; to modify "
"these, you will need to remove and then reinstall Python completely."
msgstr ""
#: using/windows.rst:291
msgid ""
"\"Repair\" will verify all the files that should be installed using the "
"current settings and replace any that have been removed or modified."
msgstr ""
#: using/windows.rst:294
msgid ""
"\"Uninstall\" will remove Python entirely, with the exception of the :ref:"
"`launcher`, which has its own entry in Programs and Features."
msgstr ""
#: using/windows.rst:301
msgid "The Microsoft Store package"
msgstr ""
#: using/windows.rst:305
msgid ""
"The Microsoft Store package is an easily installable Python interpreter that "
"is intended mainly for interactive use, for example, by students."
msgstr ""
#: using/windows.rst:308
msgid ""
"To install the package, ensure you have the latest Windows 10 updates and "
"search the Microsoft Store app for \"Python |version|\". Ensure that the app "
"you select is published by the Python Software Foundation, and install it."
msgstr ""
#: using/windows.rst:313
msgid ""
"Python will always be available for free on the Microsoft Store. If you are "
"asked to pay for it, you have not selected the correct package."
msgstr ""
#: using/windows.rst:316
msgid ""
"After installation, Python may be launched by finding it in Start. "
"Alternatively, it will be available from any Command Prompt or PowerShell "
"session by typing ``python``. Further, pip and IDLE may be used by typing "
"``pip`` or ``idle``. IDLE can also be found in Start."
msgstr ""
#: using/windows.rst:321
msgid ""
"All three commands are also available with version number suffixes, for "
"example, as ``python3.exe`` and ``python3.x.exe`` as well as ``python.exe`` "
"(where ``3.x`` is the specific version you want to launch, such as |"
"version|). Open \"Manage App Execution Aliases\" through Start to select "
"which version of Python is associated with each command. It is recommended "
"to make sure that ``pip`` and ``idle`` are consistent with whichever version "
"of ``python`` is selected."
msgstr ""
#: using/windows.rst:329
msgid ""
"Virtual environments can be created with ``python -m venv`` and activated "
"and used as normal."
msgstr ""
#: using/windows.rst:332
msgid ""
"If you have installed another version of Python and added it to your "
"``PATH`` variable, it will be available as ``python.exe`` rather than the "
"one from the Microsoft Store. To access the new installation, use ``python3."
"exe`` or ``python3.x.exe``."
msgstr ""
#: using/windows.rst:337
msgid ""
"The ``py.exe`` launcher will detect this Python installation, but will "
"prefer installations from the traditional installer."
msgstr ""
#: using/windows.rst:340
msgid ""
"To remove Python, open Settings and use Apps and Features, or else find "
"Python in Start and right-click to select Uninstall. Uninstalling will "
"remove all packages you installed directly into this Python installation, "
"but will not remove any virtual environments"
msgstr ""
#: using/windows.rst:346
msgid "Known issues"
msgstr ""
#: using/windows.rst:349
msgid "Redirection of local data, registry, and temporary paths"
msgstr ""
#: using/windows.rst:351
msgid ""
"Because of restrictions on Microsoft Store apps, Python scripts may not have "
"full write access to shared locations such as :envvar:`TEMP` and the "
"registry. Instead, it will write to a private copy. If your scripts must "
"modify the shared locations, you will need to install the full installer."
msgstr ""
#: using/windows.rst:356
msgid ""
"At runtime, Python will use a private copy of well-known Windows folders and "
"the registry. For example, if the environment variable :envvar:`%APPDATA%` "
"is :file:`c:\\\\Users\\\\<user>\\\\AppData\\\\`, then when writing to :file:"
"`C:\\\\Users\\\\<user>\\\\AppData\\\\Local` will write to :file:`C:\\"
"\\Users\\\\<user>\\\\AppData\\\\Local\\\\Packages\\"
"\\PythonSoftwareFoundation.Python.3.8_qbz5n2kfra8p0\\\\LocalCache\\\\Local\\"
"\\`."
msgstr ""
#: using/windows.rst:361
msgid ""
"When reading files, Windows will return the file from the private folder, or "
"if that does not exist, the real Windows directory. For example reading :"
"file:`C:\\\\Windows\\\\System32` returns the contents of :file:`C:\\"
"\\Windows\\\\System32` plus the contents of :file:`C:\\\\Program Files\\"
"\\WindowsApps\\\\package_name\\\\VFS\\\\SystemX86`."
msgstr ""
#: using/windows.rst:365
msgid ""
"You can find the real path of any existing file using :func:`os.path."
"realpath`:"
msgstr ""
#: using/windows.rst:374
msgid "When writing to the Windows Registry, the following behaviors exist:"
msgstr ""
#: using/windows.rst:376
msgid ""
"Reading from ``HKLM\\\\Software`` is allowed and results are merged with "
"the :file:`registry.dat` file in the package."
msgstr ""
#: using/windows.rst:377
msgid ""
"Writing to ``HKLM\\\\Software`` is not allowed if the corresponding key/"
"value exists, i.e. modifying existing keys."
msgstr ""
#: using/windows.rst:378
msgid ""
"Writing to ``HKLM\\\\Software`` is allowed as long as a corresponding key/"
"value does not exist in the package and the user has the correct access "
"permissions."
msgstr ""
#: using/windows.rst:381
msgid ""
"For more detail on the technical basis for these limitations, please consult "
"Microsoft's documentation on packaged full-trust apps, currently available "
"at `docs.microsoft.com/en-us/windows/msix/desktop/desktop-to-uwp-behind-the-"
"scenes <https://docs.microsoft.com/en-us/windows/msix/desktop/desktop-to-uwp-"
"behind-the-scenes>`_"
msgstr ""
#: using/windows.rst:390
msgid "The nuget.org packages"
msgstr ""
#: using/windows.rst:394
msgid ""
"The nuget.org package is a reduced size Python environment intended for use "
"on continuous integration and build systems that do not have a system-wide "
"install of Python. While nuget is \"the package manager for .NET\", it also "
"works perfectly fine for packages containing build-time tools."
msgstr ""
#: using/windows.rst:399
msgid ""
"Visit `nuget.org <https://www.nuget.org/>`_ for the most up-to-date "
"information on using nuget. What follows is a summary that is sufficient for "
"Python developers."
msgstr ""
#: using/windows.rst:403
msgid ""
"The ``nuget.exe`` command line tool may be downloaded directly from "
"``https://aka.ms/nugetclidl``, for example, using curl or PowerShell. With "
"the tool, the latest version of Python for 64-bit or 32-bit machines is "
"installed using::"
msgstr ""
#: using/windows.rst:411
msgid ""
"To select a particular version, add a ``-Version 3.x.y``. The output "
"directory may be changed from ``.``, and the package will be installed into "
"a subdirectory. By default, the subdirectory is named the same as the "
"package, and without the ``-ExcludeVersion`` option this name will include "
"the specific version installed. Inside the subdirectory is a ``tools`` "
"directory that contains the Python installation:"
msgstr ""
#: using/windows.rst:428
msgid ""
"In general, nuget packages are not upgradeable, and newer versions should be "
"installed side-by-side and referenced using the full path. Alternatively, "
"delete the package directory manually and install it again. Many CI systems "
"will do this automatically if they do not preserve files between builds."
msgstr ""
#: using/windows.rst:433
msgid ""
"Alongside the ``tools`` directory is a ``build\\native`` directory. This "
"contains a MSBuild properties file ``python.props`` that can be used in a C+"
"+ project to reference the Python install. Including the settings will "
"automatically use the headers and import libraries in your build."
msgstr ""
#: using/windows.rst:438
msgid ""
"The package information pages on nuget.org are `www.nuget.org/packages/"
"python <https://www.nuget.org/packages/python>`_ for the 64-bit version and "
"`www.nuget.org/packages/pythonx86 <https://www.nuget.org/packages/"
"pythonx86>`_ for the 32-bit version."
msgstr ""
#: using/windows.rst:447
msgid "The embeddable package"
msgstr ""
#: using/windows.rst:451
msgid ""
"The embedded distribution is a ZIP file containing a minimal Python "
"environment. It is intended for acting as part of another application, "
"rather than being directly accessed by end-users."
msgstr ""
#: using/windows.rst:455
msgid ""
"When extracted, the embedded distribution is (almost) fully isolated from "
"the user's system, including environment variables, system registry "
"settings, and installed packages. The standard library is included as pre-"
"compiled and optimized ``.pyc`` files in a ZIP, and ``python3.dll``, "
"``python37.dll``, ``python.exe`` and ``pythonw.exe`` are all provided. Tcl/"
"tk (including all dependents, such as Idle), pip and the Python "
"documentation are not included."
msgstr ""
#: using/windows.rst:464
msgid ""
"The embedded distribution does not include the `Microsoft C Runtime <https://"
"docs.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist#visual-"
"studio-2015-2017-2019-and-2022>`_ and it is the responsibility of the "
"application installer to provide this. The runtime may have already been "
"installed on a user's system previously or automatically via Windows Update, "
"and can be detected by finding ``ucrtbase.dll`` in the system directory."
msgstr ""
#: using/windows.rst:471
msgid ""
"Third-party packages should be installed by the application installer "
"alongside the embedded distribution. Using pip to manage dependencies as for "
"a regular Python installation is not supported with this distribution, "
"though with some care it may be possible to include and use pip for "
"automatic updates. In general, third-party packages should be treated as "
"part of the application (\"vendoring\") so that the developer can ensure "
"compatibility with newer versions before providing updates to users."
msgstr ""
#: using/windows.rst:479
msgid ""
"The two recommended use cases for this distribution are described below."
msgstr ""
#: using/windows.rst:482
msgid "Python Application"
msgstr ""
#: using/windows.rst:484
msgid ""
"An application written in Python does not necessarily require users to be "
"aware of that fact. The embedded distribution may be used in this case to "
"include a private version of Python in an install package. Depending on how "
"transparent it should be (or conversely, how professional it should appear), "
"there are two options."
msgstr ""
#: using/windows.rst:490
msgid ""
"Using a specialized executable as a launcher requires some coding, but "
"provides the most transparent experience for users. With a customized "
"launcher, there are no obvious indications that the program is running on "
"Python: icons can be customized, company and version information can be "
"specified, and file associations behave properly. In most cases, a custom "
"launcher should simply be able to call ``Py_Main`` with a hard-coded command "
"line."
msgstr ""
#: using/windows.rst:497
msgid ""
"The simpler approach is to provide a batch file or generated shortcut that "
"directly calls the ``python.exe`` or ``pythonw.exe`` with the required "
"command-line arguments. In this case, the application will appear to be "
"Python and not its actual name, and users may have trouble distinguishing it "
"from other running Python processes or file associations."
msgstr ""
#: using/windows.rst:503
msgid ""
"With the latter approach, packages should be installed as directories "
"alongside the Python executable to ensure they are available on the path. "
"With the specialized launcher, packages can be located in other locations as "
"there is an opportunity to specify the search path before launching the "
"application."
msgstr ""
#: using/windows.rst:509
msgid "Embedding Python"
msgstr ""
#: using/windows.rst:511
msgid ""
"Applications written in native code often require some form of scripting "
"language, and the embedded Python distribution can be used for this purpose. "
"In general, the majority of the application is in native code, and some part "
"will either invoke ``python.exe`` or directly use ``python3.dll``. For "
"either case, extracting the embedded distribution to a subdirectory of the "
"application installation is sufficient to provide a loadable Python "
"interpreter."
msgstr ""
#: using/windows.rst:518
msgid ""
"As with the application use, packages can be installed to any location as "
"there is an opportunity to specify search paths before initializing the "
"interpreter. Otherwise, there is no fundamental differences between using "
"the embedded distribution and a regular installation."
msgstr ""
#: using/windows.rst:525
msgid "Alternative bundles"
msgstr ""
#: using/windows.rst:527
msgid ""
"Besides the standard CPython distribution, there are modified packages "
"including additional functionality. The following is a list of popular "
"versions and their key features:"
msgstr ""
#: using/windows.rst:532
msgid "`ActivePython <https://www.activestate.com/products/python/>`_"
msgstr ""
#: using/windows.rst:532
msgid "Installer with multi-platform compatibility, documentation, PyWin32"
msgstr ""
#: using/windows.rst:536
msgid "`Anaconda <https://www.anaconda.com/download/>`_"
msgstr ""
#: using/windows.rst:535
msgid ""
"Popular scientific modules (such as numpy, scipy and pandas) and the "
"``conda`` package manager."
msgstr ""
#: using/windows.rst:542
msgid "`Enthought Deployment Manager <https://www.enthought.com/edm/>`_"
msgstr ""
#: using/windows.rst:539
msgid "\"The Next Generation Python Environment and Package Manager\"."
msgstr ""
#: using/windows.rst:541
msgid ""
"Previously Enthought provided Canopy, but it `reached end of life in 2016 "
"<https://support.enthought.com/hc/en-us/articles/360038600051-Canopy-GUI-end-"
"of-life-transition-to-the-Enthought-Deployment-Manager-EDM-and-Visual-Studio-"
"Code>`_."
msgstr ""
#: using/windows.rst:546
msgid "`WinPython <https://winpython.github.io/>`_"
msgstr ""
#: using/windows.rst:545
msgid ""
"Windows-specific distribution with prebuilt scientific packages and tools "
"for building packages."
msgstr ""
#: using/windows.rst:548
msgid ""
"Note that these packages may not include the latest versions of Python or "
"other libraries, and are not maintained or supported by the core Python team."
msgstr ""
#: using/windows.rst:554
msgid "Configuring Python"
msgstr ""
#: using/windows.rst:556
msgid ""
"To run Python conveniently from a command prompt, you might consider "
"changing some default environment variables in Windows. While the installer "
"provides an option to configure the PATH and PATHEXT variables for you, this "
"is only reliable for a single, system-wide installation. If you regularly "
"use multiple versions of Python, consider using the :ref:`launcher`."
msgstr ""
#: using/windows.rst:566
msgid "Excursus: Setting environment variables"
msgstr ""
#: using/windows.rst:568
msgid ""
"Windows allows environment variables to be configured permanently at both "
"the User level and the System level, or temporarily in a command prompt."
msgstr ""
#: using/windows.rst:571
msgid ""
"To temporarily set environment variables, open Command Prompt and use the :"
"command:`set` command:"
msgstr ""
#: using/windows.rst:580
msgid ""
"These changes will apply to any further commands executed in that console, "
"and will be inherited by any applications started from the console."
msgstr ""
#: using/windows.rst:583