[UPDATE] Translate library/os.path
#492
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
cschan1828
reviewed
Jul 19, 2023
library/os.path.po
Outdated
|
|
||
| #: ../../library/os.path.rst:280 | ||
| msgid "" | ||
| "Return ``True`` if *path* refers to an :func:`existing <exists>` directory " | ||
| "entry that is a symbolic link. Always ``False`` if symbolic links are not " | ||
| "supported by the Python runtime." | ||
| msgstr "" | ||
| "如果 *path* 是指向\\ :func:`已存在的 <exists>`\\ 目錄項目且為符號連結，則回" | ||
| "傳 ``True``。如果 Python 執行時不支持符號連結，則始終回傳 ``False``。" |
library/os.path.po
Outdated
| @@ -348,10 +375,17 @@ msgid "" | |||
| "UNC are always mount points, and for any other path ``GetVolumePathName`` is " | |||
| "called to see if it is different from the input path." | |||
| msgstr "" | |||
| "如果路徑名 *path* 是一個掛載點 （:dfn:`mount point`），則回傳 ``True``。在 " | |||
There was a problem hiding this comment.
"A point in a file system ..." 這句似乎沒有翻譯到。
library/os.path.po
Outdated
| @@ -361,6 +395,9 @@ msgid "" | |||
| "temporary build directories, package caches, and other IO-intensive " | |||
| "operations." | |||
| msgstr "" | |||
| "如果路徑名 *path* 位於 Windows Dev 驅動機上，則回傳 ``True``。Dev 驅動機針對" | |||
| "開發人員場景進行了優化，提供更快的讀寫檔案性能。建議將其用於原始程式碼、臨時" | |||
| "建置目錄、封包緩存和其他 I/O 密集型操作。" | |||
There was a problem hiding this comment.
cache 繁體中文一般譯為 「快取」，或者不翻譯。
library/os.path.po
Outdated
Comment on lines
410
to
411
| "碟機的平台上返回 ``False``。請參閱 `Windows 文檔 <https://learn.microsoft." | ||
| "com/windows/dev-drive/>`_\\ 以了解有關啟用和建立 Dev 驅動機的信息。" |
There was a problem hiding this comment.
document 繁體中文翻譯為「文件」
information 繁體中文翻譯為「資訊」
library/os.path.po
Outdated
| @@ -424,13 +479,20 @@ msgid "" | |||
| "interpreted in an implementation-defined manner, although more than two " | |||
| "leading characters shall be treated as a single character." | |||
| msgstr "" | |||
| "在 POSIX 系統中，根據 `IEEE Std 1003.1 2013 版; 4.13 Pathname Resolution " | |||
| "<https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04." | |||
| "html#tag_04_13>`_ 標準，如果一個路徑名以確切的兩個斜線開頭，則在前導字元後的" | |||
library/os.path.po
Outdated
| @@ -414,6 +465,10 @@ msgid "" | |||
| "that contains symbolic links. On Windows, it converts forward slashes to " | |||
| "backward slashes. To normalize case, use :func:`normcase`." | |||
| msgstr "" | |||
| "通過合併多餘的分隔符號和上層引用來規範化路徑名，使得 ``A//B``、``A/B/``、" | |||
| "``A/./B`` 和 ``A/foo/../B`` 都變成 ``A/B``。這種字串操作可能會改變包含符號連" | |||
| "結的路徑的含義。在 Windows 上，它將正斜線轉換為反斜線。要規範化大小寫，請使" | |||
There was a problem hiding this comment.
Suggested change
| "結的路徑的含義。在 Windows 上，它將正斜線轉換為反斜線。要規範化大小寫，請使" | |
| "結的路徑的含義。在 Windows 上，它將正斜線轉換為反斜線。要標準化大小寫，請使" |
library/os.path.po
Outdated
|
|
||
| #: ../../library/os.path.rst:499 | ||
| msgid "" | ||
| "If the path contains a UNC path, drive will contain the host name and share::" | ||
| msgstr "" | ||
| "如果路徑包含 UNC 路徑，則驅動機將包含主機名和共享名，不包括第四個分隔符：" |
There was a problem hiding this comment.
原文沒有「不包括第四個分隔符」這句。
:: 是特殊符號，表示接下來會有 code block.
Suggested change
| "如果路徑包含 UNC 路徑，則驅動機將包含主機名和共享名，不包括第四個分隔符：" | |
| "如果路徑包含 UNC 路徑，則驅動機將包含主機名和共享名：\n" | |
| "\n" | |
| "::" |
library/os.path.po
Outdated
|
|
||
| #: ../../library/os.path.rst:530 | ||
| msgid "" | ||
| "On Windows, *drive* may be empty, a drive-letter name, a UNC share, or a " | ||
| "device name. The *root* may be empty, a forward slash, or a backward slash. " | ||
| "For example::" | ||
| msgstr "" | ||
| "在 Windows 上，*drive* 可能為空，是驅動機名稱，UNC 共享或設備名稱。*root* 可" |
There was a problem hiding this comment.
Suggested change
| "在 Windows 上，*drive* 可能為空，是驅動機名稱，UNC 共享或設備名稱。*root* 可" | |
| "在 Windows 上，*drive* 可能為空、驅動機名稱、UNC 共享或是設備名稱。*root* 可" |
library/os.path.po
Outdated
| "在 POSIX 系統上，*drive* 始終為空。*root* 可能為空（如果 *path* 是相對路" | ||
| "徑），一個斜線（如果 *path* 是絕對路徑），或者兩個斜線（根據 `IEEE Std " | ||
| "1003.1-2017; 4.13 Pathname Resolution <https://pubs.opengroup.org/" | ||
| "onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_13>`_ 的實現定義）。例" |
There was a problem hiding this comment.
Suggested change
| "onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_13>`_ 的實現定義）。例" | |
| "onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_13>`_ 的實作定義）。例" |
library/os.path.po
Outdated
|
|
||
| #: ../../library/os.path.rst:544 | ||
| msgid "" | ||
| "Split the pathname *path* into a pair ``(root, ext)`` such that ``root + " | ||
| "ext == path``, and the extension, *ext*, is empty or begins with a period " | ||
| "and contains at most one period." | ||
| msgstr "" | ||
| "將路徑名 *path* 拆分為一對 ``(root, ext)``，使得 ``root + ext == path``，且副" | ||
| "檔名 *ext* 為空或以點開頭且最多包含一個點。" |
There was a problem hiding this comment.
Suggested change
| "檔名 *ext* 為空或以點開頭且最多包含一個點。" | |
| "檔名 *ext* 為空或以點開頭且最多包含一個點 (period)。" |
「點」在中文上語意很多，建議附上原文讓讀者知道是指英文句子結尾的那個 "."。
|
@cschan1828 Thanks. I have modified. |
cschan1828
reviewed
Jul 20, 2023
Co-authored-by: cschan <[email protected]>
cschan1828
reviewed
Jul 20, 2023
cschan1828
reviewed
Jul 20, 2023
cschan1828
requested changes
Jul 20, 2023
Co-authored-by: cschan <[email protected]>
Co-authored-by: cschan <[email protected]>
cschan1828
reviewed
Jul 20, 2023
cschan1828
reviewed
Jul 20, 2023
| @@ -558,42 +651,55 @@ msgid "" | |||
| "Pathname Resolution <https://pubs.opengroup.org/onlinepubs/9699919799/" | |||
| "basedefs/V1_chap04.html#tag_04_13>`_.) For example::" | |||
There was a problem hiding this comment.
ditto.
你可以在這個 repo 中找到許多類似範例，基本上就是
"：\n"
"\n"
"::"
這樣的模式。後續有 :: 的部份我就不一一列出了，請自行找出並修正。
Co-authored-by: cschan <[email protected]>
|
@cschan1828 I have modified. Please check. |
cschan1828
reviewed
Jul 22, 2023
cschan1828
reviewed
Jul 22, 2023
cschan1828
requested changes
Jul 22, 2023
|
另外一個建議是，遇到 Python 內建的資料結構如 sequence, list, tuple 等，可以不必翻譯，直接比照原文即可。 |
Co-authored-by: cschan <[email protected]>
Co-authored-by: cschan <[email protected]>
|
@cschan1828 OK. Thanks for your review. |
cschan1828
approved these changes
Jul 22, 2023
beccalzh
pushed a commit
to beccalzh/python-docs-zh-tw
that referenced
this pull request
Sep 4, 2024
* [UPDATE] Translate `library/os.path`
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
#480
有針對上次 review 做更改，包括：
目前維持原先「適用」的翻譯。Drive 目前暫翻驅動機，因為 drive letter (drive name) 在術語列表翻譯為驅動機字母 (驅動機名)