From 89a011613986b0bc001b44aae68ab184fd1b02f8 Mon Sep 17 00:00:00 2001 From: Irvin Date: Sat, 15 May 2021 03:35:13 +0800 Subject: update zh-tw translated guide, link to Mozilla L10n Style Guide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit also modify space rule between Latin chars and 「」（） --- docs/zh-tw/translation-guide.md | 37 +++++++++++++++++++------------------ 1 file changed, 19 insertions(+), 18 deletions(-) (limited to 'docs') diff --git a/docs/zh-tw/translation-guide.md b/docs/zh-tw/translation-guide.md index 0d44be67ac..4e2d6cfbee 100644 --- a/docs/zh-tw/translation-guide.md +++ b/docs/zh-tw/translation-guide.md @@ -1,6 +1,6 @@ # 針對 MDN 翻譯內容的一般指導原則 -本文是針對正體中文（ zh-TW ）地區的翻譯指南。如果你所在的地區尚未有文件指南而你又想新建的話，歡迎你開始建立或聯絡[我們負責該地區的翻譯團隊](https://github.com/mdn/translated-content/blob/docs-readme/README.md)。 +本文是針對正體中文（zh-TW）地區的翻譯指南。如果你所在的地區尚未有文件指南，而你又想新建的話，歡迎你開始建立或聯絡[我們負責該地區的翻譯團隊](https://github.com/mdn/translated-content/blob/docs-readme/README.md)。 同樣的，如果你對一般指導原則有一些不錯的想法想要補充，不用客氣，去發起問題（ issue ）來跟我們談談吧。以下進入正體中文翻譯指導原則的主要內容。 @@ -30,7 +30,7 @@ 然而，不要對實際的程式碼術語進行翻譯，好比語法。你要確保範例在翻譯後仍可正常執行。 -當試圖翻譯範例時，請記得有些範例會連向實際的版本或獨立的原始碼倉庫。你可以考慮建立對應的翻譯版本然後在翻譯頁面中連向這些經翻譯的外部程式碼。 +當試圖翻譯範例時，請記得有些範例會連向實際的版本或獨立的原始碼倉庫。你可以考慮建立對應的翻譯版本，然後在翻譯頁面中連向這些經翻譯的外部程式碼。 ## HTML 原始碼的換行 @@ -76,14 +76,14 @@ 在翻譯文章時，應使用全形中文標點符號（除非在引述外文的文字中），例如： -- 正確：雖然「 Java 」和「 JavaScript 」都是 Oracle 公司 +- 正確：雖然「Java」和「JavaScript」都是 Oracle 公司 - 不正確：雖然 "Java" 和 "JavaScript" 都是 Oracle 公司 - 正確：請前往 JavaScrip ——動態的用戶端指令。 - 不正確：請前往 JavaScrip-動態的用戶端指令。 當引述的內容為外文時，應保留其原有的標點符號： -- 正確：我們將變數 myHeading 中 innerHTML 特性的值設為「 Hello world! 」。 +- 正確：我們將變數 myHeading 中 innerHTML 特性的值設為「Hello world!」。 - 不正確：我們將變數 myHeading 中 innerHTML 特性的值設為「Hello world！」。 @@ -109,23 +109,20 @@ ### 中文及拉丁語系文字交界之修飾 -基於閱讀及選取操作（連點游標可選取該詞組—— word ）上的便利，在翻譯時，中外文（拉丁語系）交界處使用一個半形空格進行修飾是常見的作法。但譯者往往發生風格不一致、過度修飾等問題。 - -應修飾中英文交界處。 +基於閱讀及選取操作（連點游標可選取該詞組 —— word）上的便利，在翻譯時，中文字、標點符號與半形英數、符號字元間，需用半形空格隔開。 - 正確：使用 Git 作為版本控制。 - 不正確：使用Git作為版本控制。 風格不一致。部分有修飾但部分沒有。 -- 正確：JavaScript 是一個成熟的動態程式語言，應用於 HTML 文件（ document ）上時， +- 正確：JavaScript 是一個成熟的動態程式語言，應用於 HTML 文件（document）上時， - 不正確：JavaScript是一個成熟的動態程式語言，應用於 HTML 文件（document）上時， +英數字與全形符號（如 `「」（），`）間不需空格 -過度修飾。在中文字與中文標點符號之間也進行修飾，要知道中文標點符號既中文字。 - -- 正確：版本控制系統—— Git 。 -- 不正確：版本控制系統 —— Git。 +- 正確：「JavaScript」之文件（document）應用，HTML +- 不正確：「 JavaScript 」之文件（ document ）應用， HTML ### 慣用語及術語 @@ -151,7 +148,7 @@ | array | 陣列 | 數組 | | object | 物件 | 對象 | -當台灣譯者在翻譯時應盡可能地使用台灣的慣用翻譯或詞彙，若碰到不確定的情況，可以參考下列的資源，請不要參考線上翻譯服務（譬如， Google 翻譯）。 +當台灣譯者在翻譯時，應盡可能地使用台灣的慣用翻譯或詞彙。若碰到不確定的情況，可以參考下列的資源，請不要參考線上翻譯服務（譬如， Google 翻譯）。 ### 台灣慣用詞彙參考資源 @@ -174,13 +171,13 @@ ### 中文相關文法 -中文和英文分屬兩種不同的語系，彼此之間並不一定存在對方語文中的某些概念，但在國際化的今天，中文讀者往往也容易被英文所影響。 +中文和英文分屬兩種不同的語系，彼此之間並不一定存在對方語文中的某些概念。但在國際化的今天，中文讀者往往也容易被英文所影響。 以下是一些在翻譯中文時常碰到的問題，包含但不限於中英文之間的差異。 #### 語態 -英文有主動語態（active voice）及被動語態（passive voice）。中文雖然也具有主被動語態的觀念，但以主動語態為主。因此在翻譯時應盡可能的使用主動語態以避免造成閱讀與理解上的困難，最典型的就是「被」的濫用以及照搬英文的倒裝句。 +英文有主動語態（active voice）及被動語態（passive voice）。中文雖然也具有主被動語態的觀念，但以主動語態為主。因此在翻譯時，應盡可能的使用主動語態，以避免造成閱讀與理解上的困難，最典型的就是「被」的濫用以及照搬英文的倒裝句。 - 原文： Publishing a website is a complex topic because there are many ways to go about it. - 宜：因為有太多方法能夠發佈網站，所以這不是一個幾句話就能說完的課題。 @@ -188,7 +185,7 @@ #### 敬語 -英文的代名詞並無敬語的觀念，然而某些中文譯者往往習慣性地在翻譯時把代名詞譯為敬語，這是不需要的。文件敘述的語氣毋須刻意展現謙卑的態度，使用貼近口語的說法即可，不需要太過正式（嚴肅）。 +英文的代名詞並無敬語的觀念，然而某些中文譯者，往往習慣性地在翻譯時把代名詞譯為敬語，這是不需要的。文件敘述的語氣毋須刻意展現謙卑的態度，使用貼近口語的說法即可，不需要太過正式（嚴肅）。 - 原文： FTP programs vary widely, but generally, you have to connect to your web server using details provided by your hosting company - 宜：FTP 程式很廣泛，但一般來說，你可以用你公司提供的資訊登入你的網頁伺服器。 @@ -196,7 +193,7 @@ #### 代名詞 -在英文文章中，通常會在敘述中充斥大量的第二或第三人代名詞。但在翻譯為中文時這種過度出現的代名詞實際上會使得閱讀變得不通順。適度地減少代名詞的出現並不為過，甚至能夠讓中文的閱讀更加順暢。 +在英文文章中，通常會在敘述中充斥大量的第二或第三人代名詞。但在翻譯為中文時，這種過度出現的代名詞，實際上會使得閱讀變得不通順。適度地減少代名詞的出現並不為過，甚至能夠讓中文的閱讀更加順暢。 - 原文： After you have finished your instructions, follow the numbered list with a brief closing summary or explanation about the expected outcome upon completion. - 宜：在完成操作指南後，接續著有序清單給予結語或說明有哪些在完成操作指南後應期待出現的結果。 @@ -210,10 +207,14 @@ - 宜：內建在瀏覽器內的應用程式介面（ Application Programming Interface ， API ） - 不宜：內建在瀏覽器內的應用程式介面（Application Programming Interfaces，APIs） +## Mozilla 正體中文在地化規範 + +Mozilla 各專案一致性的在地化規範與翻譯原則，請參閱 [Mozilla L10n Style Guide](https://mozilla-l10n.github.io/styleguides/zh-TW/) + ## 結語 我們很難對翻譯這項工作訂定絕對的準則，語言的正確使用與否也難有絕對的標準。因此，在面對上述的指導原則及問題時，希望你不會感到太大的壓力，如果你有任何疑問，請隨時與負責你所關注地區的翻譯團隊進行聯絡，向他們提出你的問題。 儘管嘗試送出你的翻譯吧，審核人員會協助你進行除錯，找出你可能大意的地方。一旦問題都解決了，他們就會合併你的翻譯內容。 -如果你還沒有做好直接貢獻翻譯的準備也沒有關係，你可以嘗試協助我們找出 MDN 上有瑕疵的翻譯，並透過問題（ issue ）回報給我們。又或是找到那些不太難且尚未解決的問題，並嘗試修正這些問題。這是相對簡單的方式邁出翻譯貢獻的第一步。我們衷心期待你的貢獻。 \ No newline at end of file +如果你還沒有做好直接貢獻翻譯的準備也沒有關係，你可以嘗試協助我們找出 MDN 上有瑕疵的翻譯，並透過問題（ issue ）回報給我們。又或是找到那些不太難且尚未解決的問題，並嘗試修正這些問題。這是相對簡單的方式邁出翻譯貢獻的第一步。我們衷心期待你的貢獻。 -- cgit v1.2.3-54-g00ecf