[zh-tw]: add and update translation of documents under "writing_guidelines\howto"

[weixiang0815]

更新內容描述

基於 #25341 反映的翻譯文件同步需求，更新以下內容：

1. 新增「mdn/writing_guidelines/howto」目錄下所有文件的翻譯
2. 更新【編輯以及新增頁面】的翻譯，以符合原文最新內容

[github-actions]

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

mdn-linter

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/index.md

Line 189 in 4fafbc1

清單中的每個介面都應該有獨立頁面，作為 `https://developer.mozilla.org/zh-TW/docs/Web/API` 的子頁面。

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/index.md

Lines 222 to 225 in 4fafbc1

	- *此介面未實作任何專屬屬性，但自 `\\{{domxref("XYZ")}}` 和 `\\{{domxref("XYZ2")}}` 繼承屬性。*
	- *此介面也自 `\\{{domxref("XYZ")}}` 和 `\\{{domxref("XYZ2")}}` 繼承屬性。*
	- *此介面未實作任何專屬方法，但自 `\\{{domxref("XYZ")}}` 和 `\\{{domxref("XYZ2")}}` 繼承方法。*
	- *此介面也自 `\\{{domxref("XYZ")}}` 和 `\\{{domxref("XYZ2")}}` 繼承方法。*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/index.md

Line 227 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 10 in 4fafbc1

IDL 代表**_介面定義語言_**（Interface Definition Language），其設計目的是用來描述 API。在更廣泛的計算領域中，有多種類型的 IDL，而瀏覽器所使用的 IDL 稱為 *WebIDL*。WebIDL 主要有兩種版本：一種來自 WebIDL 規範，另一種則是瀏覽器實作的版本。規範版本是正式的參考標準，而瀏覽器實作的 WebIDL 則描述特定瀏覽器實際支援的內容，並可能包含額外註解、非標準元素資訊，以及針對 IDL 規範的瀏覽器專屬擴充套件。

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 31 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 164 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 180 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 222 in 4fafbc1

*當設為 `null` 值時，該 `null` 會被轉換為空字串 `""`，因此 `elt.innerHTML = null` 等同於 `elt.innerHTML = ""`。*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 235 in 4fafbc1

- 在該屬性的專屬頁面中，描述開頭應為：*唯讀的 **`HTMLMediaElement.error`** 屬性…*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 238 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 278 in 4fafbc1

*儘管此屬性為唯讀，修改它並不會拋出錯誤（即使在嚴格模式下）；Setter 無效，並會被忽略。*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 288 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 300 in 4fafbc1

*唯讀屬性 **`HTMLMediaElement.buffered`** 會回傳一個新的 \\{{domxref("TimeRanges")}} 物件…*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Lines 304 to 305 in 4fafbc1

	- *\\{{domxref("HTMLMediaElement.buffered")}}\\{{ReadOnlyInline}}*
	- : *回傳一個新的 \\{{domxref("TimeRanges")}} 物件…*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 312 in 4fafbc1

- : *回傳一個動態的 \\{{domxref("HTMLFormControlsCollection")}}，包含…*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 322 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 334 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 362 in 4fafbc1

- : 在參數描述的結尾新增以下句子：*[`null`](/zh-TW/docs/Web/JavaScript/Reference/Operators/null) 值會被視為與空字串 `""` 相同。*

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 395 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 409 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 435 in 4fafbc1

> [!NOTE]

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 463 in 4fafbc1

- 在 WebIDL 檔案外，於規範文件內的說明段落中定義。這些說明通常以「*[要迭代的值](https://webidl.spec.whatwg.org/#dfn-value-iterator)…*」開頭。

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 483 in 4fafbc1

- 在 WebIDL 檔案外，於規範文件內的說明段落中定義。這些說明通常以「*[要迭代的鍵值對](https://webidl.spec.whatwg.org/#dfn-value-pairs-to-iterate-over)…*」開頭。

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/information_contained_in_a_webidl_file/index.md

Line 555 in 4fafbc1

使用 `Constructor` 註解定義建構子，可以帶有參數（或不帶參數，如上例）。我們會將所有匿名建構子記錄在其子頁面，例如上例的建構子會對應至 *Web/API/MessageChannel/MessageChannel*，標題為 `MessageChannel()`。

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md

Lines 81 to 82 in 4fafbc1

	> [!NOTE]
	> MDN 正逐步減少使用獨立字典文件。

---

[mdn-linter] _{reported by reviewdog 🐶}

translated-content/files/zh-tw/mdn/writing_guidelines/howto/write_an_api_reference/sidebars/index.md

Lines 87 to 88 in 4fafbc1

	> [!NOTE]
	> MDN 正在逐步減少使用獨立 `typedefs` 文件。

[github-actions]

Preview URLs (10 pages)

• /zh-TW/docs/MDN/Writing_guidelines/Howto/Creating_moving_deleting
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Document_a_CSS_property
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Document_an_HTTP_header
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Document_web_errors
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Images_media
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_a_new_entry_in_the_glossary
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference/Information_contained_in_a_WebIDL_file
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference/Sidebars
• /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference
• /zh-TW/docs/MDN/Writing_guidelines/Howto

Flaws (1)

Note! 9 documents with no flaws that don't need to be listed. 🎉

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Images_media
Title: 如何新增圖片與多媒體
Flaw count: 1

• macros:
  • Can't resolve /zh-TW/docs/Glossary/長寬比

External URLs (32)

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Images_media
Title: 如何新增圖片與多媒體

• https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request (1 time) (Note! This may be a new URL 👀)
• https://firefox-source-docs.mozilla.org/devtools-user/page_inspector/how_to/work_with_animations/index.html (1 time) (Note! This may be a new URL 👀)
• https://firefox-source-docs.mozilla.org/devtools-user/rulers/index.html (1 time) (Note! This may be a new URL 👀)
• https://github.github.com/gfm/ (1 time) (Note! This may be a new URL 👀)
• https://photography.tutsplus.com/tutorials/how-to-add-custom-callouts-to-screencast-videos-in-screenflow--cms-27122 (1 time) (Note! This may be a new URL 👀)
• https://www.w3.org/WAI/tutorials/images/decision-tree/ (1 time) (Note! This may be a new URL 👀)
• https://www.youtube.com/user/mozhacks/videos (1 time) (Note! This may be a new URL 👀)

---

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_a_new_entry_in_the_glossary
Title: 如何建立術語表條目

• https://zh.wikipedia.org/ (1 time) (Note! This may be a new URL 👀)

---

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Document_a_CSS_property
Title: 如何撰寫 CSS 屬性文件

• https://www.w3.org/Style/CSS/ (1 time) (Note! This may be a new URL 👀)

---

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference
Title: 如何撰寫 API 參考

• https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site (3 times) (Note! This may be a new URL 👀)
• https://github.com/ (3 times) (Note! This may be a new URL 👀)
• https://groups.google.com/a/mozilla.org/g/dev-platform/ (1 time) (Note! This may be a new URL 👀)
• https://lists.w3.org/Archives/Public/public-webapps/ (1 time) (Note! This may be a new URL 👀)
• https://webaudio.github.io/web-audio-api/ (1 time) (Note! This may be a new URL 👀)
• https://www.google.com/intl/en/chrome/canary/ (1 time) (Note! This may be a new URL 👀)
• https://www.mozilla.org/zh-TW/firefox/channel/desktop/ (1 time) (Note! This may be a new URL 👀)

---

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference/Sidebars
Title: API 參考側邊欄

• https://github.com/ (1 time) (Note! This may be a new URL 👀)

---

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Write_an_api_reference/Information_contained_in_a_WebIDL_file
Title: WebIDL 文件包含的資訊

• https://firefox-source-docs.mozilla.org/dom/webIdlBindings/index.html (2 times) (Note! This may be a new URL 👀)
• https://html.spec.whatwg.org/multipage/links.html (1 time) (Note! This may be a new URL 👀)
• https://html.spec.whatwg.org/multipage/text-level-semantics.html (1 time) (Note! This may be a new URL 👀)
• https://searchfox.org/mozilla-central/source/dom/webidl/ (1 time) (Note! This may be a new URL 👀)
• https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/ (1 time) (Note! This may be a new URL 👀)
• https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/core/ (1 time) (Note! This may be a new URL 👀)
• https://source.chromium.org/chromium/chromium/src/+/main:third_party/blink/renderer/modules/ (1 time) (Note! This may be a new URL 👀)
• https://trac.webkit.org/wiki/WebKitIDL (1 time) (Note! This may be a new URL 👀)
• https://webidl.spec.whatwg.org/ (5 times) (Note! This may be a new URL 👀)
• https://www.chromium.org/blink/webidl/ (1 time) (Note! This may be a new URL 👀)

---

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Document_web_errors
Title: 如何撰寫網路錯誤文件

• https://chromium.googlesource.com/v8/v8.git/+/refs/heads/main/src/execution/messages.h (1 time) (Note! This may be a new URL 👀)
• https://firefox-source-docs.mozilla.org/devtools-user/web_console/index.html (1 time) (Note! This may be a new URL 👀)
• https://github.com/mozilla/gecko-dev/blob/master/js/src/jsshell.msg (1 time) (Note! This may be a new URL 👀)

---

URL: /zh-TW/docs/MDN/Writing_guidelines/Howto/Document_an_HTTP_header
Title: 如何撰寫 HTTP 訊息檔頭文件

• https://www.iana.org/assignments/http-fields/http-fields.xhtml (1 time) (Note! This may be a new URL 👀)
• https://zh.wikipedia.org/wiki/HTTP头字段 (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-02-16 15:57:12)