Repository navigation
Expand file tree
/
Copy pathwindows.po
More file actions
2242 lines (1864 loc) · 67.6 KB
/
Copy pathwindows.po
File metadata and controls
2242 lines (1864 loc) · 67.6 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-2024, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.12\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-11-01 00:21+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 with every `release <https://www.python.org/"
"downloads/>`_ 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 ""
"The following options (found by executing the installer with ``/?``) can be "
"passed into the installer:"
msgstr ""
#: using/windows.rst:153 using/windows.rst:1082
msgid "Name"
msgstr ""
#: using/windows.rst:153 using/windows.rst:1082
msgid "Description"
msgstr ""
#: using/windows.rst:135
msgid "/passive"
msgstr ""
#: using/windows.rst:135
msgid "to display progress without requiring user interaction"
msgstr ""
#: using/windows.rst:137
msgid "/quiet"
msgstr ""
#: using/windows.rst:137
msgid "to install/uninstall without displaying any UI"
msgstr ""
#: using/windows.rst:139
msgid "/simple"
msgstr ""
#: using/windows.rst:139
msgid "to prevent user customization"
msgstr ""
#: using/windows.rst:141
msgid "/uninstall"
msgstr ""
#: using/windows.rst:141
msgid "to remove Python (without confirmation)"
msgstr ""
#: using/windows.rst:143
msgid "/layout [directory]"
msgstr ""
#: using/windows.rst:143
msgid "to pre-download all components"
msgstr ""
#: using/windows.rst:145
msgid "/log [filename]"
msgstr ""
#: using/windows.rst:145
msgid "to specify log files location"
msgstr ""
#: using/windows.rst:148
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:153
msgid "Default"
msgstr ""
#: using/windows.rst:155
msgid "InstallAllUsers"
msgstr ""
#: using/windows.rst:155
msgid "Perform a system-wide installation."
msgstr ""
#: using/windows.rst:181 using/windows.rst:188 using/windows.rst:219
#: using/windows.rst:230
msgid "0"
msgstr ""
#: using/windows.rst:157
msgid "TargetDir"
msgstr ""
#: using/windows.rst:157
msgid "The installation directory"
msgstr ""
#: using/windows.rst:157
msgid "Selected based on InstallAllUsers"
msgstr ""
#: using/windows.rst:160
msgid "DefaultAllUsersTargetDir"
msgstr ""
#: using/windows.rst:160
msgid "The default installation directory for all-user installs"
msgstr ""
#: using/windows.rst:160
msgid ""
":file:`%ProgramFiles%\\\\\\ Python X.Y` or :file:`\\ %ProgramFiles(x86)%\\\\"
"\\ Python X.Y`"
msgstr ""
#: using/windows.rst:165
msgid "DefaultJustForMeTargetDir"
msgstr ""
#: using/windows.rst:165
msgid "The default install directory for just-for-me installs"
msgstr ""
#: using/windows.rst:165
msgid ""
":file:`%LocalAppData%\\\\\\ Programs\\\\Python\\\\\\ PythonXY` or :file:"
"`%LocalAppData%\\\\\\ Programs\\\\Python\\\\\\ PythonXY-32` or :file:"
"`%LocalAppData%\\\\\\ Programs\\\\Python\\\\\\ PythonXY-64`"
msgstr ""
#: using/windows.rst:175
msgid "DefaultCustomTargetDir"
msgstr ""
#: using/windows.rst:175
msgid "The default custom install directory displayed in the UI"
msgstr ""
#: using/windows.rst:232
msgid "(empty)"
msgstr ""
#: using/windows.rst:178
msgid "AssociateFiles"
msgstr ""
#: using/windows.rst:178
msgid "Create file associations if the launcher is also installed."
msgstr ""
#: using/windows.rst:192 using/windows.rst:199 using/windows.rst:207
#: using/windows.rst:213 using/windows.rst:221 using/windows.rst:225
msgid "1"
msgstr ""
#: using/windows.rst:181
msgid "CompileAll"
msgstr ""
#: using/windows.rst:181
msgid "Compile all ``.py`` files to ``.pyc``."
msgstr ""
#: using/windows.rst:184
msgid "PrependPath"
msgstr ""
#: using/windows.rst:184
msgid ""
"Prepend install and Scripts directories to :envvar:`PATH` and add ``.PY`` "
"to :envvar:`PATHEXT`"
msgstr ""
#: using/windows.rst:188
msgid "AppendPath"
msgstr ""
#: using/windows.rst:188
msgid ""
"Append install and Scripts directories to :envvar:`PATH` and add ``.PY`` "
"to :envvar:`PATHEXT`"
msgstr ""
#: using/windows.rst:192
msgid "Shortcuts"
msgstr ""
#: using/windows.rst:192
msgid ""
"Create shortcuts for the interpreter, documentation and IDLE if installed."
msgstr ""
#: using/windows.rst:195
msgid "Include_doc"
msgstr ""
#: using/windows.rst:195
msgid "Install Python manual"
msgstr ""
#: using/windows.rst:197
msgid "Include_debug"
msgstr ""
#: using/windows.rst:197
msgid "Install debug binaries"
msgstr ""
#: using/windows.rst:199
msgid "Include_dev"
msgstr ""
#: using/windows.rst:199
msgid ""
"Install developer headers and libraries. Omitting this may lead to an "
"unusable installation."
msgstr ""
#: using/windows.rst:203
msgid "Include_exe"
msgstr ""
#: using/windows.rst:203
msgid ""
"Install :file:`python.exe` and related files. Omitting this may lead to an "
"unusable installation."
msgstr ""
#: using/windows.rst:207
msgid "Include_launcher"
msgstr ""
#: using/windows.rst:207
msgid "Install :ref:`launcher`."
msgstr ""
#: using/windows.rst:209
msgid "InstallLauncherAllUsers"
msgstr ""
#: using/windows.rst:209
msgid ""
"Installs the launcher for all users. Also requires ``Include_launcher`` to "
"be set to 1"
msgstr ""
#: using/windows.rst:213
msgid "Include_lib"
msgstr ""
#: using/windows.rst:213
msgid ""
"Install standard library and extension modules. Omitting this may lead to an "
"unusable installation."
msgstr ""
#: using/windows.rst:217
msgid "Include_pip"
msgstr ""
#: using/windows.rst:217
msgid "Install bundled pip and setuptools"
msgstr ""
#: using/windows.rst:219
msgid "Include_symbols"
msgstr ""
#: using/windows.rst:219
msgid "Install debugging symbols (``*.pdb``)"
msgstr ""
#: using/windows.rst:221
msgid "Include_tcltk"
msgstr ""
#: using/windows.rst:221
msgid "Install Tcl/Tk support and IDLE"
msgstr ""
#: using/windows.rst:223
msgid "Include_test"
msgstr ""
#: using/windows.rst:223
msgid "Install standard library test suite"
msgstr ""
#: using/windows.rst:225
msgid "Include_tools"
msgstr ""
#: using/windows.rst:225
msgid "Install utility scripts"
msgstr ""
#: using/windows.rst:227
msgid "LauncherOnly"
msgstr ""
#: using/windows.rst:227
msgid "Only installs the launcher. This will override most other options."
msgstr ""
#: using/windows.rst:230
msgid "SimpleInstall"
msgstr ""
#: using/windows.rst:230
msgid "Disable most install UI"
msgstr ""
#: using/windows.rst:232
msgid "SimpleInstallDescription"
msgstr ""
#: using/windows.rst:232
msgid "A custom message to display when the simplified install UI is used."
msgstr ""
#: using/windows.rst:236
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:239
msgid "python-3.9.0.exe /quiet InstallAllUsers=1 PrependPath=1 Include_test=0"
msgstr ""
#: using/windows.rst:241
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:245
msgid ""
"python-3.9.0.exe InstallAllUsers=0 Include_launcher=0 Include_test=0\n"
" SimpleInstall=1 SimpleInstallDescription=\"Just for me, no test suite.\""
msgstr ""
#: using/windows.rst:248
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:252
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 ""
"<Options>\n"
" <Option Name=\"InstallAllUsers\" Value=\"no\" />\n"
" <Option Name=\"Include_launcher\" Value=\"0\" />\n"
" <Option Name=\"Include_test\" Value=\"no\" />\n"
" <Option Name=\"SimpleInstall\" Value=\"yes\" />\n"
" <Option Name=\"SimpleInstallDescription\">Just for me, no test suite</"
"Option>\n"
"</Options>"
msgstr ""
#: using/windows.rst:271
msgid "Installing Without Downloading"
msgstr ""
#: using/windows.rst:273
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:281
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:288
msgid "python-3.9.0.exe /layout [optional target directory]"
msgstr ""
#: using/windows.rst:290
msgid ""
"You may also specify the ``/quiet`` option to hide the progress display."
msgstr ""
#: using/windows.rst:293
msgid "Modifying an install"
msgstr ""
#: using/windows.rst:295
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:299
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:304
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:307
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:314
msgid "The Microsoft Store package"
msgstr ""
#: using/windows.rst:318
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:321
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:326
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:329
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:334
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:342
msgid ""
"Virtual environments can be created with ``python -m venv`` and activated "
"and used as normal."
msgstr ""
#: using/windows.rst:345
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:350
msgid ""
"The ``py.exe`` launcher will detect this Python installation, but will "
"prefer installations from the traditional installer."
msgstr ""
#: using/windows.rst:353
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:359
msgid "Known issues"
msgstr ""
#: using/windows.rst:362
msgid "Redirection of local data, registry, and temporary paths"
msgstr ""
#: using/windows.rst:364
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:369
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:374
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:378
msgid ""
"You can find the real path of any existing file using :func:`os.path."
"realpath`:"
msgstr ""
#: using/windows.rst:380
msgid ""
">>> import os\n"
">>> test_file = 'C:\\\\Users\\\\example\\\\AppData\\\\Local\\\\test.txt'\n"
">>> os.path.realpath(test_file)\n"
"'C:\\\\Users\\\\example\\\\AppData\\\\Local\\\\Packages\\"
"\\PythonSoftwareFoundation.Python.3.8_qbz5n2kfra8p0\\\\LocalCache\\\\Local\\"
"\\test.txt'"
msgstr ""
#: using/windows.rst:387
msgid "When writing to the Windows Registry, the following behaviors exist:"
msgstr ""
#: using/windows.rst:389
msgid ""
"Reading from ``HKLM\\\\Software`` is allowed and results are merged with "
"the :file:`registry.dat` file in the package."
msgstr ""
#: using/windows.rst:390
msgid ""
"Writing to ``HKLM\\\\Software`` is not allowed if the corresponding key/"
"value exists, i.e. modifying existing keys."
msgstr ""
#: using/windows.rst:391
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:394
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:403
msgid "The nuget.org packages"
msgstr ""
#: using/windows.rst:407
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:412
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:416
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:421
msgid ""
"nuget.exe install python -ExcludeVersion -OutputDirectory .\n"
"nuget.exe install pythonx86 -ExcludeVersion -OutputDirectory ."
msgstr ""
#: using/windows.rst:424
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:431
msgid ""
"# Without -ExcludeVersion\n"
"> .\\python.3.5.2\\tools\\python.exe -V\n"
"Python 3.5.2\n"
"\n"
"# With -ExcludeVersion\n"
"> .\\python\\tools\\python.exe -V\n"
"Python 3.5.2"
msgstr ""
#: using/windows.rst:441
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:446
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:451
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:460
msgid "The embeddable package"
msgstr ""
#: using/windows.rst:464
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:468
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:477
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:484
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:492
msgid ""
"The two recommended use cases for this distribution are described below."
msgstr ""
#: using/windows.rst:495
msgid "Python Application"
msgstr ""
#: using/windows.rst:497
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:503
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:510
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:516
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:522
msgid "Embedding Python"
msgstr ""
#: using/windows.rst:524
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:531
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 ""