[zh-tw]: add translation of "Code Style Guide" #25791

weixiang0815 · 2025-02-08T19:51:14Z

更新內容描述

基於 #25341 反映的翻譯文件同步需求，新增【Code Style Guide】文件及其目錄下的子文件翻譯。

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/css/index.md

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/html/index.md

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

github-actions · 2025-02-08T19:53:03Z

Preview URLs

External URLs (17)

URL: /zh-TW/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide
Title: 程式碼範例寫作指南

https://prettier.io/ (1 time) (Note! This may be a new URL 👀)
https://prettier.io/docs/index.html (1 time) (Note! This may be a new URL 👀)

URL: /zh-TW/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/Shell
Title: Shell 提示字程式碼範例寫作指南

https://prettier.io/ (1 time) (Note! This may be a new URL 👀)
https://prettier.io/docs/index.html (1 time) (Note! This may be a new URL 👀)

URL: /zh-TW/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/HTML
Title: HTML 程式碼範例寫作指南

https://prettier.io/ (1 time) (Note! This may be a new URL 👀)
https://prettier.io/docs/index.html (1 time) (Note! This may be a new URL 👀)

URL: /zh-TW/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/JavaScript
Title: JavaScript 程式碼範例寫作指南

https://prettier.io/ (1 time) (Note! This may be a new URL 👀)
https://prettier.io/docs/index.html (1 time) (Note! This may be a new URL 👀)
https://zh.wikipedia.org/wiki/匈牙利命名法 (1 time) (Note! This may be a new URL 👀)

URL: /zh-TW/docs/MDN/Writing_guidelines/Writing_style_guide/Code_style_guide/CSS
Title: CSS 程式碼範例寫作指南

https://getbem.com/naming/ (1 time) (Note! This may be a new URL 👀)
https://lesscss.org/ (1 time) (Note! This may be a new URL 👀)
https://necolas.github.io/normalize.css/ (1 time) (Note! This may be a new URL 👀)
https://prettier.io/ (1 time) (Note! This may be a new URL 👀)
https://prettier.io/docs/index.html (1 time) (Note! This may be a new URL 👀)
https://sass-lang.com/ (1 time) (Note! This may be a new URL 👀)
https://smacss.com/ (1 time) (Note! This may be a new URL 👀)
https://stylus-lang.com/ (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-02-14 09:04:45)

yin1999

请先按 #25774 提出的一些建议更新这些文档，后面会由 @jasonren0403 来审核当前 PR。

weixiang0815 · 2025-02-12T07:09:39Z

@yin1999 已根據您的建議修正好了。

jasonren0403

一些修改建议

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/index.md

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

jasonren0403 · 2025-02-14T07:04:11Z

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

+
+### 函式名稱
+
+函式名稱應使用 {{Glossary("camel_case", "駝峰命名法")}}，首個字母須為小寫。請選擇簡潔、易讀且具語意性的名稱，以提升可讀性。


Suggested change

函式名稱應使用 {{Glossary("camel_case", "駝峰命名法")}}，首個字母須為小寫。請選擇簡潔、易讀且具語意性的名稱，以提升可讀性。

函式名稱應使用{{Glossary("camel_case", "駝峰命名法")}}，首個字母須為小寫。請選擇簡潔、易讀且具語意性的名稱，以提升可讀性。

已修正。

jasonren0403 · 2025-02-14T07:06:24Z

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

+
+當需要用[迴圈](/zh-TW/docs/Learn_web_development/Core/Scripting/Loops)時，請根據需求選擇適當的迴圈類型，例如 [`for(;;)`](/zh-TW/docs/Web/JavaScript/Reference/Statements/for)、[`for-of`](/zh-TW/docs/Web/JavaScript/Reference/Statements/for-of)、[`while`](/zh-TW/docs/Web/JavaScript/Reference/Statements/while) 等等。
+
+- 在遍歷集合元素時，請避免使用傳統 `for (;;)` 迴圈，建議使用 `for-of` 或 `forEach()`。請注意，若使用的集合並非 `陣列（Array）`，則須確認 `for-of` 是否支援（它要求變數可迭代），或確保 `forEach()` 方法是否存在。


Suggested change

- 在遍歷集合元素時，請避免使用傳統 `for (;;)` 迴圈，建議使用 `for-of` 或 `forEach()`。請注意，若使用的集合並非 `陣列（Array）`，則須確認 `for-of` 是否支援（它要求變數可迭代），或確保 `forEach()` 方法是否存在。

- 在遍歷集合元素時，請避免使用傳統 `for (;;)` 迴圈，建議使用 `for-of` 或 `forEach()`。請注意，若使用的集合並非 `Array`（陣列），則須確認 `for-of` 是否支援（它要求變數可迭代），或確保 `forEach()` 方法是否存在。

已修正。

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

jasonren0403 · 2025-02-14T07:12:12Z

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

+}
+```
+
+The conditional operator is helpful when creating strings to log information. In such cases, using a regular `if...else` statement leads to long blocks of code for a side operation like logging, obfuscating the central point of the example.


这里遗漏了

了解，已補上翻譯。

jasonren0403 · 2025-02-18T08:14:58Z

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

+
+### 條件運算子
+
+當你需要根據條件將某個字面值存入變數時，請使用[三元運算子](/zh-TW/docs/Web/JavaScript/Reference/Operators/Conditional_operator) 來取代 `if-else` 陳述式。此規則同樣適用於回傳值的情境。請這樣撰寫：


Suggested change

當你需要根據條件將某個字面值存入變數時，請使用[三元運算子](/zh-TW/docs/Web/JavaScript/Reference/Operators/Conditional_operator) 來取代 `if-else` 陳述式。此規則同樣適用於回傳值的情境。請這樣撰寫：

當你需要根據條件將某個字面值存入變數時，請使用[三元運算子](/zh-TW/docs/Web/JavaScript/Reference/Operators/Conditional_operator)來取代 `if-else` 陳述式。此規則同樣適用於回傳值的情境。請這樣撰寫：

jasonren0403 · 2025-02-18T08:15:36Z

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/css/index.md

+
+### 使用彈性/相對單位
+
+為了在最廣裝置範圍內提供最大靈活性，建議使用相對單位來設定容器（container）、內距（padding）等大小，例如 `em`、`rem`，或使用百分比與視口單位（viewport units），以根據視口寬度動態調整。你可以在我們的 [CSS 值與單位指南](/zh-TW/docs/Learn_web_development/Core/Styling_basics/Values_and_units#relative_length_units)中閱讀更多相關資訊。


Suggested change

為了在最廣裝置範圍內提供最大靈活性，建議使用相對單位來設定容器（container）、內距（padding）等大小，例如 `em`、`rem`，或使用百分比與視口單位（viewport units），以根據視口寬度動態調整。你可以在我們的 [CSS 值與單位指南](/zh-TW/docs/Learn_web_development/Core/Styling_basics/Values_and_units#relative_length_units)中閱讀更多相關資訊。

為了在最廣裝置範圍內提供最大靈活性，建議使用相對單位來設定容器（container）、內距（padding）等大小，例如 `em`、`rem`，或使用百分比與視口單位（viewport unit），以根據視口寬度動態調整。你可以在我們的 [CSS 值與單位指南](/zh-TW/docs/Learn_web_development/Core/Styling_basics/Values_and_units#relative_length_units)中閱讀更多相關資訊。

jasonren0403 · 2025-02-18T08:20:37Z

files/zh-tw/mdn/writing_guidelines/writing_style_guide/code_style_guide/javascript/index.md

+在 `if-else` 控制陳述中，有一個需要特別注意的情況。如果 `if` 陳述以 `return` 結束，就不用再寫 `else` 陳述。
+
+請在 `if` 陳述後直接繼續撰寫程式碼。請這樣撰寫：


Suggested change

在 `if-else` 控制陳述中，有一個需要特別注意的情況。如果 `if` 陳述以 `return` 結束，就不用再寫 `else` 陳述。

請在 `if` 陳述後直接繼續撰寫程式碼。請這樣撰寫：

在 `if-else` 控制陳述式中，有一個需要特別注意的情況。如果 `if` 陳述以 `return` 結束，就不用再寫 `else` 陳述。

請在 `if` 陳述式後直接繼續撰寫程式碼。請這樣撰寫：

jasonren0403

还有部分空格、复数和名词统一问题，可以看一下

如 https://github.com/mdn/translated-content/pull/25791/files#r1959255829

weixiang0815 requested a review from a team as a code owner February 8, 2025 19:51

weixiang0815 requested review from jasonren0403 and removed request for a team February 8, 2025 19:51

github-actions bot added the l10n-zh Issues related to Chinese content. label Feb 8, 2025

github-actions bot reviewed Feb 8, 2025

View reviewed changes

Dr-XYZ mentioned this pull request Feb 9, 2025

zh-tw: Synchronize with latest updates to MDN writing guidelines #25341

Open

54 tasks

weixiang0815 requested review from a team as code owners February 11, 2025 15:29

weixiang0815 requested review from hochan222, JuanVqz, saionaro, kenji-yamasaki, cw118 and josielrocha and removed request for a team February 11, 2025 15:29

github-actions bot added l10n-ja Issues related to Japanese content. l10n-fr Issues related to French content. l10n-es Issues related to Spanish content. l10n-ru Issues related to Russian content. labels Feb 11, 2025

github-actions bot added l10n-pt-br Issues related to Brazilian Portuguese system Infrastructure and configuration for the project labels Feb 11, 2025

weixiang0815 marked this pull request as draft February 11, 2025 15:33

weixiang0815 force-pushed the code_style_guide_20250208 branch from b463a7f to 5ba8d10 Compare February 11, 2025 16:19

weixiang0815 marked this pull request as ready for review February 11, 2025 16:23

cw118 removed request for a team, hochan222, JuanVqz, saionaro, kenji-yamasaki, cw118 and josielrocha February 11, 2025 18:43

yin1999 reviewed Feb 12, 2025

View reviewed changes

weixiang0815 added 2 commits February 12, 2025 15:20

[zh-tw]: add translation of "Code Style Guide"

ef2efa6

[zh-tw]: removed unnecessary short-title front-matters

02db967

weixiang0815 force-pushed the code_style_guide_20250208 branch from 9d0d9e0 to 02db967 Compare February 12, 2025 07:21

jasonren0403 requested changes Feb 14, 2025

View reviewed changes

[zh-tw]: fixed as code review suggested

e76098a

jasonren0403 reviewed Feb 18, 2025

View reviewed changes

jasonren0403 requested changes Feb 19, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[zh-tw]: add translation of "Code Style Guide" #25791

[zh-tw]: add translation of "Code Style Guide" #25791

weixiang0815 commented Feb 8, 2025

github-actions bot commented Feb 8, 2025 •

edited

Loading

yin1999 left a comment

weixiang0815 commented Feb 12, 2025

jasonren0403 left a comment

jasonren0403 Feb 14, 2025

weixiang0815 Feb 14, 2025

jasonren0403 Feb 14, 2025

weixiang0815 Feb 14, 2025

jasonren0403 Feb 14, 2025

weixiang0815 Feb 14, 2025 •

edited

Loading

jasonren0403 Feb 18, 2025

jasonren0403 Feb 18, 2025

jasonren0403 Feb 18, 2025

jasonren0403 left a comment •

edited

Loading


		### 函式名稱

		函式名稱應使用 {{Glossary("camel_case", "駝峰命名法")}}，首個字母須為小寫。請選擇簡潔、易讀且具語意性的名稱，以提升可讀性。

	函式名稱應使用 {{Glossary("camel_case", "駝峰命名法")}}，首個字母須為小寫。請選擇簡潔、易讀且具語意性的名稱，以提升可讀性。
	函式名稱應使用{{Glossary("camel_case", "駝峰命名法")}}，首個字母須為小寫。請選擇簡潔、易讀且具語意性的名稱，以提升可讀性。


		當需要用[迴圈](/zh-TW/docs/Learn_web_development/Core/Scripting/Loops)時，請根據需求選擇適當的迴圈類型，例如 [`for(;;)`](/zh-TW/docs/Web/JavaScript/Reference/Statements/for)、[`for-of`](/zh-TW/docs/Web/JavaScript/Reference/Statements/for-of)、[`while`](/zh-TW/docs/Web/JavaScript/Reference/Statements/while) 等等。

		- 在遍歷集合元素時，請避免使用傳統 `for (;;)` 迴圈，建議使用 `for-of` 或 `forEach()`。請注意，若使用的集合並非 `陣列（Array）`，則須確認 `for-of` 是否支援（它要求變數可迭代），或確保 `forEach()` 方法是否存在。


		### 條件運算子

		當你需要根據條件將某個字面值存入變數時，請使用[三元運算子](/zh-TW/docs/Web/JavaScript/Reference/Operators/Conditional_operator) 來取代 `if-else` 陳述式。此規則同樣適用於回傳值的情境。請這樣撰寫：


		### 使用彈性/相對單位

		為了在最廣裝置範圍內提供最大靈活性，建議使用相對單位來設定容器（container）、內距（padding）等大小，例如 `em`、`rem`，或使用百分比與視口單位（viewport units），以根據視口寬度動態調整。你可以在我們的 [CSS 值與單位指南](/zh-TW/docs/Learn_web_development/Core/Styling_basics/Values_and_units#relative_length_units)中閱讀更多相關資訊。

		在 `if-else` 控制陳述中，有一個需要特別注意的情況。如果 `if` 陳述以 `return` 結束，就不用再寫 `else` 陳述。

		請在 `if` 陳述後直接繼續撰寫程式碼。請這樣撰寫：

[zh-tw]: add translation of "Code Style Guide" #25791

Are you sure you want to change the base?

[zh-tw]: add translation of "Code Style Guide" #25791

Conversation

weixiang0815 commented Feb 8, 2025

更新內容描述

github-actions bot commented Feb 8, 2025 • edited Loading

yin1999 left a comment

Choose a reason for hiding this comment

weixiang0815 commented Feb 12, 2025

jasonren0403 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

weixiang0815 Feb 14, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

jasonren0403 left a comment • edited Loading

Choose a reason for hiding this comment

github-actions bot commented Feb 8, 2025 •

edited

Loading

weixiang0815 Feb 14, 2025 •

edited

Loading

jasonren0403 left a comment •

edited

Loading