---
title: "ethereum.org 翻譯風格指南"
metaTitle: "譯者指南"
lang: zh-tw
description: "給 ethereum.org 譯者的指示與提示"
---

ethereum.org 翻譯風格指南包含了一些對譯者來說最重要的準則、指示與提示，協助我們在地化這個網站。

本文件作為一般指南，並不針對任何特定語言。

如果你有任何問題、建議或回饋，歡迎透過 translations@ethereum.org 聯絡我們、在 Crowdin 上傳送訊息給 @ethdotorg，或是[加入我們的 Discord](https://discord.gg/ethereum-org)，你可以在 #translations 頻道中傳送訊息給我們，或聯絡任何團隊成員。

## 使用 Crowdin {#using-crowdin}

ethereum.org 的 Crowdin 專案即將關閉，不再接受新的貢獻（請參閱[翻譯計畫狀態](/contributing/translation-program/#program-status)）。以下指南保留作為使用 Crowdin 進行自有專案的翻譯社群之參考。

如果你想進一步了解 Crowdin 以及如何使用其進階功能，[Crowdin 知識庫](https://support.crowdin.com/online-editor/)包含了許多深入的指南與所有 Crowdin 功能的總覽。

## 掌握訊息的精髓 {#capturing-the-essence}

翻譯 ethereum.org 內容時，請避免直譯。

翻譯必須掌握訊息的精髓，這非常重要。這可能意味著需要改寫某些片語，或使用描述性翻譯，而不是逐字翻譯內容。

不同的語言有不同的文法規則、慣用語和詞序。翻譯時，請留意目標語言的句子結構，並避免直譯英文原文，因為這會導致句子結構不佳且難以閱讀。

建議你閱讀完整的句子，並根據目標語言的慣用語進行調整，而不是逐字翻譯原文。

## 正式與非正式 {#formal-vs-informal}

我們使用正式的稱呼方式，這對所有訪客來說都是禮貌且合適的。

使用正式稱呼可以避免讓人覺得不夠正式或具有冒犯性，而且無論訪客的年齡和性別為何都適用。

大多數印歐語系和亞非語系語言使用區分性別的第二人稱代名詞。在稱呼使用者或使用所有格代名詞時，我們可以避免預設訪客的性別，因為正式的稱呼方式通常適用且一致，無論他們的性別認同為何。

## 簡單明瞭的詞彙與含義 {#simple-vocabulary}

我們的目標是讓網站上的內容能被盡可能多的人理解。

在大多數情況下，使用簡短、簡單且易於理解的詞彙就能輕鬆達成這個目標。如果在你的語言中，某個詞彙有多種含義相同的可能翻譯，最好的選擇通常是能清楚表達含義的最短詞彙。

## 書寫系統 {#writing-system}

Ethereum.org 提供多種語言版本，使用拉丁字母以外的書寫系統（或文字）。

所有內容都應使用適合你語言的正確書寫系統進行翻譯，且不應包含任何使用拉丁字元書寫的單字。

翻譯內容時，你應確保翻譯的一致性，且不包含任何拉丁字元。

一個常見的誤解是 Ethereum 應該始終以拉丁字母書寫。這通常是不正確的，請使用你語言中原生的 Ethereum 拼寫方式（例如：中文的「以太坊」、阿拉伯文的「إيثيريوم」等）。

**上述規定不適用於原則上不翻譯專有名詞的語言。**

## 翻譯頁面中繼資料 {#translating-metadata}

某些頁面包含頁面上的中繼資料，例如 'title'、'lang'、'description'、'sidebar' 等。

當我們上傳新頁面到 Crowdin 時，會隱藏譯者絕對不應翻譯的內容，這意味著在 Crowdin 中譯者可見的所有中繼資料都應該被翻譯。

翻譯任何原文為 'en' 的字串時請特別留意。這代表該頁面提供的語言，應翻譯為[你語言的 ISO 語言代碼](https://www.andiamo.co.uk/resources/iso-language-codes/)。這些字串應始終使用拉丁字元翻譯，而不是目標語言原生的書寫文字。

如果你不確定要使用哪個語言代碼，可以查看 Crowdin 中的翻譯記憶庫，或在 Crowdin 線上編輯器的頁面 URL 中找到你語言的語言代碼。

一些最廣泛使用語言的語言代碼範例：

- 阿拉伯文 - ar
- 簡體中文 - zh
- 法文 - fr
- 印地文 - hi
- 西班牙文 - es

## 外部文章標題 {#external-articles}

某些字串包含外部文章的標題。我們的大多數開發者文件頁面都包含供進一步閱讀的外部文章連結。包含文章標題的字串需要被翻譯，無論該文章的語言為何，以確保以其語言瀏覽頁面的訪客能有更一致的使用者體驗。

你可以在下方找到這些字串對譯者來說是什麼樣子，以及如何識別它們的範例（文章連結通常可以在這些頁面的底部，「延伸閱讀」段落中找到）：

![Article titles in sidebar.png](./article-titles-in-sidebar.png)
![Article titles in editor.png](./article-titles-in-editor.png)

## Crowdin 警告 {#crowdin-warnings}

Crowdin 內建了一項功能，會在譯者即將犯錯時發出警告。如果你忘記包含原文中的標籤、翻譯了不應翻譯的元素、加入了多個連續空格、忘記句末標點符號等，Crowdin 會在儲存你的翻譯前自動警告你。
如果你看到這樣的警告，請返回並仔細檢查建議的翻譯。

**絕對不要忽略這些警告，因為它們通常意味著有地方出錯了，或者翻譯遺漏了原文的關鍵部分。**

當你忘記在翻譯中加入標籤時的 Crowdin 警告範例：
![Example of a Crowdin warning](./crowdin-warning-example.png)

## 處理標籤與程式碼片段 {#dealing-with-tags}

許多原文內容包含標籤和變數，這些在 Crowdin 編輯器中會以黃色反白顯示。它們具有不同的功能，應以正確的方式處理。

**Crowdin 設定**

為了更容易管理標籤並直接從原文複製它們，我們建議在 Crowdin 編輯器中更改你的設定。

1. 開啟設定
   ![How to open settings in the editor](./editor-settings.png)

2. 向下捲動至「HTML tags displaying」段落

3. 選擇「Hide」
   ![Please select 'Hide'](./hide-tags.png)

4. 點擊「Save」

選擇此選項後，將不再顯示完整的標籤文字，而是以數字取代。
翻譯時，點擊此標籤將自動把完全相同的標籤複製到翻譯欄位中。

**連結**

你可能會注意到指向 ethereum.org 或其他網站頁面的完整連結。

這些連結應與原文完全相同，不應更改或翻譯。如果你翻譯了連結或以任何方式更改它，即使只是刪除其中的一部分，例如斜線 (/)，也會導致連結損壞且無法使用。

處理連結的最佳方式是直接從原文複製它們，可以透過點擊它們或使用「Copy Source」按鈕 (`Alt+C`)。

![Example of link.png](./example-of-link.png)

連結也會以標籤的形式出現在原文中（例如 `<0>` `</0>`）。如果你將游標懸停在標籤上，編輯器將顯示其完整內容——有時這些標籤會代表連結。

從原文複製連結且不改變它們的順序非常重要。

如果更改了標籤的順序，它們所代表的連結將會損壞。

![Example of links inside tags.png](./example-of-links-inside-tags.png)

**標籤與變數**

原文包含許多不同類型的標籤，這些標籤應始終從原文複製且絕不更改。與上述類似，這些標籤在翻譯中的順序也應與原文保持一致。

標籤總是包含一個起始標籤和一個結束標籤。在大多數情況下，起始標籤和結束標籤之間的文字應該被翻譯。

範例：`<strong x-id="1">`去中心化的`</strong>`

`<strong x-id="1">` - _使文字變粗體的起始標籤_

去中心化的 - _可翻譯文字_

`</strong>` - _結束標籤_

![Example of 'strong' tags.png](./example-of-strong-tags.png)

程式碼片段的處理方式應與其他標籤略有不同，因為它們包含不應翻譯的程式碼。

範例：`<code>`nonce`</code>`

`<code>` - _包含程式碼片段的起始標籤_

nonce - _不可翻譯文字_

`</code>` - _結束標籤_

![Example of code snippets.png](./example-of-code-snippets.png)

原文還包含縮短的標籤，這些標籤僅包含數字，這意味著它們的功能並非一目了然。你可以將游標懸停在這些標籤上，以確切查看它們的功能。

在下方的範例中，你可以看到將游標懸停在 `<0>` 標籤上會顯示它代表 `<code>` 並包含一個程式碼片段，因此這些標籤內的內容不應被翻譯。

![Example of ambiguous tags.png](./example-of-ambiguous-tags.png)

## 縮寫與全稱/簡稱 {#short-vs-full-forms}

網站上使用了許多縮寫，例如 dapps、NFT、DAO、DeFi 等。這些縮寫在英文中很常用，且大多數網站訪客都對它們很熟悉。

由於它們通常在其他語言中沒有既定的翻譯，處理這些及類似術語的最佳方式是提供全稱的描述性翻譯，並在括號中加上英文縮寫。

請勿翻譯這些縮寫本身，因為大多數人對翻譯後的縮寫並不熟悉，且在地化版本對大多數訪客來說意義不大。

如何翻譯 dapps 的範例：

- 去中心化應用程式 (dapps) → _翻譯後的全稱（括號內為英文縮寫）_

## 沒有既定翻譯的術語 {#terms-without-established-translations}

某些術語在其他語言中可能沒有既定的翻譯，而是以原始的英文術語廣為人知。這類術語主要包含較新的概念，例如工作量證明 (proof-of-work)、權益證明 (proof-of-stake)、信標鏈 (Beacon Chain)、質押 (staking) 等。

雖然翻譯這些術語聽起來可能不太自然，因為英文版本在其他語言中也很常用，但我們強烈建議將它們翻譯出來。

翻譯它們時，請隨意發揮創意、使用描述性翻譯，或者直接字面直譯。

**大多數術語應該被翻譯，而不是保留英文的原因在於，隨著越來越多人開始使用以太坊及相關技術，這些新術語在未來將變得更加普及。如果我們希望引導世界各地更多的人進入這個領域，我們需要在盡可能多的語言中提供易於理解的術語，即使我們需要自己創造它們。**

## 按鈕與行動呼籲 (CTAs) {#buttons-and-ctas}

網站包含許多按鈕，其翻譯方式應與其他內容不同。

透過查看與大多數字串連結的上下文螢幕截圖，或檢查編輯器中包含「button」一詞的上下文，可以識別出按鈕文字。

按鈕的翻譯應盡可能簡短，以防止格式不符。此外，按鈕翻譯應使用祈使句，即表達命令或請求。

![How to find a button.png](./how-to-find-a-button.png)

## 具包容性的翻譯 {#translating-for-inclusivity}

Ethereum.org 的訪客來自世界各地且擁有不同的背景。因此，網站上的語言應該是中立的、歡迎所有人的，且不具排他性。

其中一個重要方面是性別中立。這可以透過使用正式的稱呼方式，並在翻譯中避免任何特定性別的詞彙來輕鬆達成。

另一種包容性的形式是嘗試為全球受眾進行翻譯，而不針對任何特定國家、種族或地區。

最後，語言應適合所有受眾和年齡層。

## 特定語言的翻譯 {#language-specific-translations}

翻譯時，遵循你語言中使用的文法規則、慣用語和格式非常重要，而不是照抄原文。原文遵循英文的文法規則和慣用語，這並不適用於許多其他語言。

你應該了解你語言的規則並據此進行翻譯。如果你需要協助，請聯絡我們，我們將協助你尋找關於如何在你的語言中使用這些元素的資源。

一些需要特別留意的範例：

### 標點符號與格式 {#punctuation-and-formatting}

**大小寫**

- 不同語言在大小寫方面存在巨大差異。
- 在英文中，通常會將標題和名稱、月份和日期、語言名稱、假日等的所有單字首字母大寫。在許多其他語言中，這在文法上是不正確的，因為它們有不同的大小寫規則。
- 某些語言也有關於人稱代名詞、名詞和某些形容詞大寫的規則，而這些在英文中是不大寫的。

**空格**

- 正字法規則定義了每種語言中空格的使用。因為空格無處不在，這些規則是最顯著的差異之一，而空格也是最常被誤譯的元素之一。
- 英文與其他語言在空格方面的一些常見差異：
  - 測量單位和貨幣前的空格（例如：USD、EUR、kB、MB）
  - 度數符號前的空格（例如：°C、℉）
  - 某些標點符號前的空格，特別是省略號 (…)
  - 斜線 (/) 前後的空格

**清單**

- 每種語言都有一套多樣且複雜的清單書寫規則。這些規則可能與英文有顯著差異。
- 在某些語言中，每個新行的第一個單字需要大寫，而在其他語言中，新行應以小寫字母開頭。許多語言對於清單中的大小寫也有不同的規則，這取決於每行的長度。
- 這同樣適用於清單項目的標點符號。清單中的句末標點符號可以是句號 (**.**)、逗號 (**,**) 或分號 (**;**)，具體取決於語言。

**引號**

- 各種語言使用許多不同的引號。直接從原文複製英文引號通常是不正確的。
- 一些最常見的引號類型包括：
  - „example text“
  - ‚example text’
  - »example text«
  - “example text”
  - ‘example text’
  - «example text»

**連字號與破折號**

- 在英文中，連字號 (-) 用於連接單字或單字的不同部分，而破折號 (–) 則用於表示範圍或停頓。
- 許多語言對於連字號和破折號的使用有不同的規則，應予以遵守。

### 格式 {#formats}

**數字**

- 不同語言在書寫數字時的主要差異在於小數和千位數所使用的分隔符號。對於千位數，這可以是句號、逗號或空格。同樣地，有些語言使用小數點，而有些則使用小數逗號。
  - 一些大數字的範例：
    - 英文 – **1,000.50**
    - 西班牙文 – **1.000,50**
    - 法文 – **1 000,50**
- 翻譯數字時另一個重要的考量是百分比符號。它可以用不同的方式書寫：**100%**、**100 %** 或 **%100**。
- 最後，負數的顯示方式也可能因語言而異：-100、100-、(100) 或 [100]。

**日期**

- 翻譯日期時，根據語言的不同，有許多需要考量和差異之處。這些包括日期格式、分隔符號、大小寫和前導零。完整長度和純數字日期之間也存在差異。
  - 一些不同日期格式的範例：
    - 英文（英國）(dd/mm/yyyy) – 1st January, 2022
    - 英文（美國）(mm/dd/yyyy) – January 1st, 2022
    - 中文 (yyyy-mm-dd) – 2022 年 1 月 1 日
    - 法文 (dd/mm/yyyy) – 1er janvier 2022
    - 義大利文 (dd/mm/yyyy) – 1º gennaio 2022
    - 德文 (dd/mm/yyyy) – 1. Januar 2022

**貨幣**

- 由於格式、慣用語和換算的不同，翻譯貨幣可能具有挑戰性。作為一般規則，請保持貨幣與原文相同。為了方便讀者，你可以在括號中加入當地貨幣和換算金額。
- 不同語言在書寫貨幣時的主要差異包括符號位置、小數逗號與小數點、空格，以及縮寫與符號。
  - 符號位置：$100 或 100$
  - 小數逗號與小數點：100,50$ 或 100.50$
  - 空格：100$ 或 100 $
  - 縮寫與符號：100 $ 或 100 USD

**測量單位**

- 作為一般規則，請保持測量單位與原文一致。如果你的國家使用不同的系統，你可以在括號中包含換算結果。
- 除了測量單位的在地化之外，還需要注意不同語言處理這些單位的方式差異。主要差異在於數字和單位之間的空格，這可能因語言而異。這方面的範例包括 100kB 與 100 kB，或 50ºF 與 50 ºF。

## 結論 {#conclusion}

翻譯 ethereum.org 是了解以太坊各個層面的絕佳機會。

翻譯時，請盡量不要著急。放輕鬆，享受其中的樂趣！

感謝你參與翻譯計畫，並協助我們讓更廣泛的受眾能夠使用這個網站。以太坊社群是全球性的，我們很高興你能成為其中的一員！