Skip to contentSkip to conversation

docs: add traditional Chinese translation for kernel Documentation

PATCH In review Hu Haowen 2 participants 4 messages Jul 29, 2021 – Jul 30, 2021

Subsystems (2)
lore
Share & tools
lore

Hu Haowen

author
#0 lore raw

PATCH v7 1/3 docs: add traditional Chinese translation for kernel Documentation

Add traditional Chinese translation (zh_TW) for the Linux Kernel documentation with a series of translated files.

---
v2:
* Added more translations for zh_TW.

v3:
* Fixed building errors.
* Added SPDX identifiers for each file.

v4:
* Reorganised patch format and compressed patch content.

v5:
* Added Reviewed-by tag.

v6:
* Fixed "duplicate label zh_contact" issue.
* Added information in MAINTAINERS.

v7:
* Updated the mailing list address in MAINTAINERS.

 Documentation/translations/index.rst          |    1 +
 Documentation/translations/zh_TW/IRQ.txt      |   41 +
 .../translations/zh_TW/admin-guide/README.rst |  351 +++++
 .../zh_TW/admin-guide/bug-bisect.rst          |   85 ++
 .../zh_TW/admin-guide/bug-hunting.rst         |  344 +++++
 .../zh_TW/admin-guide/clearing-warn-once.rst  |   16 +
 .../zh_TW/admin-guide/cpu-load.rst            |  112 ++
 .../translations/zh_TW/admin-guide/index.rst  |  135 ++
 .../translations/zh_TW/admin-guide/init.rst   |   58 +
 .../zh_TW/admin-guide/reporting-issues.rst    | 1337 +++++++++++++++++
 .../zh_TW/admin-guide/security-bugs.rst       |   78 +
 .../zh_TW/admin-guide/tainted-kernels.rst     |  161 ++
 .../zh_TW/admin-guide/unicode.rst             |  174 +++
 .../translations/zh_TW/disclaimer-zh_TW.rst   |   11 +
 Documentation/translations/zh_TW/gpio.txt     |  651 ++++++++
 Documentation/translations/zh_TW/index.rst    |  162 ++
 .../translations/zh_TW/io_ordering.txt        |   68 +
 .../translations/zh_TW/oops-tracing.txt       |  212 +++
 Documentation/translations/zh_TW/sparse.txt   |   91 ++
 19 files changed, 4088 insertions(+)
 create mode 100644 Documentation/translations/zh_TW/IRQ.txt
 create mode 100644 Documentation/translations/zh_TW/admin-guide/README.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/bug-bisect.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/bug-hunting.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/clearing-warn-once.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/cpu-load.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/index.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/init.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/reporting-issues.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/security-bugs.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/tainted-kernels.rst
 create mode 100644 Documentation/translations/zh_TW/admin-guide/unicode.rst
 create mode 100644 Documentation/translations/zh_TW/disclaimer-zh_TW.rst
 create mode 100644 Documentation/translations/zh_TW/gpio.txt
 create mode 100644 Documentation/translations/zh_TW/index.rst
 create mode 100644 Documentation/translations/zh_TW/io_ordering.txt
 create mode 100644 Documentation/translations/zh_TW/oops-tracing.txt
 create mode 100644 Documentation/translations/zh_TW/sparse.txt
Documentation/translations/index.rst +1 -0
index 556b050884fc..1175a47d07f0 100644
@@ -8,6 +8,7 @@ Translations
    :maxdepth: 1
 
    zh_CN/index
+   zh_TW/index
    it_IT/index
    ko_KR/index
    ja_JP/index
Documentation/translations/zh_TW/IRQ.txt new file +41 -0

41 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/README.rst new file +351 -0

351 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/bug-bisect.rst new file +85 -0

85 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/bug-hunting.rst new file +344 -0

344 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/clearing-warn-once.rst new file +16 -0
new file mode 100644
index 000000000000..bdc1a22046cf
@@ -0,0 +1,16 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_TW.rst
+
+:Translator: 胡皓文 Hu Haowen <[email protected]>
+
+清除 WARN_ONCE
+--------------
+
+WARN_ONCE / WARN_ON_ONCE / printk_once 僅僅列印一次消息.
+
+echo 1 > /sys/kernel/debug/clear_warn_once
+
+可以清除這種狀態並且再次允許列印一次告警信息,這對於運行測試集後重現問題
+很有用。
+
Documentation/translations/zh_TW/admin-guide/cpu-load.rst new file +112 -0

112 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/index.rst new file +135 -0

135 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/init.rst new file +58 -0

58 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/reporting-issues.rst new file +1337 -0

1,337 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/security-bugs.rst new file +78 -0

78 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/tainted-kernels.rst new file +161 -0

161 lines not on this page · raw message

Documentation/translations/zh_TW/admin-guide/unicode.rst new file +174 -0

174 lines not on this page · raw message

Documentation/translations/zh_TW/disclaimer-zh_TW.rst new file +11 -0
new file mode 100644
index 000000000000..f4cf87d03dc5
@@ -0,0 +1,11 @@
+:orphan:
+
+.. warning::
+     此文件的目的是爲讓中文讀者更容易閱讀和理解,而不是作爲一個分支。因此,
+     如果您對此文件有任何意見或改動,請先嘗試更新原始英文文件。如果要更改或
+     修正某處翻譯文件,請將意見或補丁發送給維護者(聯繫方式見下)。
+
+.. note::
+     如果您發現本文檔與原始文件有任何不同或者有翻譯問題,請聯繫該文件的譯者,
+     或者發送電子郵件給胡皓文以獲取幫助:<[email protected]>。
+
Documentation/translations/zh_TW/gpio.txt new file +651 -0

90 lines not on this page · raw message

Documentation/translations/zh_TW/index.rst new file +162 -0

162 lines not on this page · raw message

Documentation/translations/zh_TW/io_ordering.txt new file +68 -0

68 lines not on this page · raw message

Documentation/translations/zh_TW/oops-tracing.txt new file +212 -0

212 lines not on this page · raw message

Documentation/translations/zh_TW/sparse.txt new file +91 -0

91 lines not on this page · raw message

The rest of this diff is not shown. View the raw message.

Signature · 1 line
2.25.1

Part of the diff is not shown here. View the raw message.

author
#1 lore raw

PATCH v7 2/3 docs/zh_TW: add translations for zh_TW/process

Create new translations for zh_TW/process and link them to index.

---
 Documentation/translations/zh_TW/index.rst    |  10 +-
 .../translations/zh_TW/process/1.Intro.rst    | 199 ++++
 .../translations/zh_TW/process/2.Process.rst  | 369 +++++++
 .../zh_TW/process/3.Early-stage.rst           | 172 ++++
 .../translations/zh_TW/process/4.Coding.rst   | 297 ++++++
 .../translations/zh_TW/process/5.Posting.rst  | 251 +++++
 .../zh_TW/process/6.Followthrough.rst         | 156 +++
 .../zh_TW/process/7.AdvancedTopics.rst        | 137 +++
 .../zh_TW/process/8.Conclusion.rst            |  74 ++
 .../code-of-conduct-interpretation.rst        | 112 ++
 .../zh_TW/process/code-of-conduct.rst         |  76 ++
 .../zh_TW/process/coding-style.rst            | 958 ++++++++++++++++++
 .../zh_TW/process/development-process.rst     |  30 +
 .../zh_TW/process/email-clients.rst           | 252 +++++
 .../process/embargoed-hardware-issues.rst     | 232 +++++
 .../translations/zh_TW/process/howto.rst      | 500 +++++++++
 .../translations/zh_TW/process/index.rst      |  67 ++
 .../zh_TW/process/kernel-driver-statement.rst | 203 ++++
 .../process/kernel-enforcement-statement.rst  | 155 +++
 .../zh_TW/process/license-rules.rst           | 374 +++++++
 .../zh_TW/process/magic-number.rst            | 148 +++
 .../zh_TW/process/management-style.rst        | 211 ++++
 .../zh_TW/process/programming-language.rst    |  76 ++
 .../zh_TW/process/stable-api-nonsense.rst     | 159 +++
 .../zh_TW/process/stable-kernel-rules.rst     |  68 ++
 .../zh_TW/process/submit-checklist.rst        | 109 ++
 .../zh_TW/process/submitting-drivers.rst      | 164 +++
 .../zh_TW/process/submitting-patches.rst      | 686 +++++++++++++
 .../process/volatile-considered-harmful.rst   | 110 ++
 29 files changed, 6351 insertions(+), 4 deletions(-)
 create mode 100644 Documentation/translations/zh_TW/process/1.Intro.rst
 create mode 100644 Documentation/translations/zh_TW/process/2.Process.rst
 create mode 100644 Documentation/translations/zh_TW/process/3.Early-stage.rst
 create mode 100644 Documentation/translations/zh_TW/process/4.Coding.rst
 create mode 100644 Documentation/translations/zh_TW/process/5.Posting.rst
 create mode 100644 Documentation/translations/zh_TW/process/6.Followthrough.rst
 create mode 100644 Documentation/translations/zh_TW/process/7.AdvancedTopics.rst
 create mode 100644 Documentation/translations/zh_TW/process/8.Conclusion.rst
 create mode 100644 Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst
 create mode 100644 Documentation/translations/zh_TW/process/code-of-conduct.rst
 create mode 100644 Documentation/translations/zh_TW/process/coding-style.rst
 create mode 100644 Documentation/translations/zh_TW/process/development-process.rst
 create mode 100644 Documentation/translations/zh_TW/process/email-clients.rst
 create mode 100644 Documentation/translations/zh_TW/process/embargoed-hardware-issues.rst
 create mode 100644 Documentation/translations/zh_TW/process/howto.rst
 create mode 100644 Documentation/translations/zh_TW/process/index.rst
 create mode 100644 Documentation/translations/zh_TW/process/kernel-driver-statement.rst
 create mode 100644 Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst
 create mode 100644 Documentation/translations/zh_TW/process/license-rules.rst
 create mode 100644 Documentation/translations/zh_TW/process/magic-number.rst
 create mode 100644 Documentation/translations/zh_TW/process/management-style.rst
 create mode 100644 Documentation/translations/zh_TW/process/programming-language.rst
 create mode 100644 Documentation/translations/zh_TW/process/stable-api-nonsense.rst
 create mode 100644 Documentation/translations/zh_TW/process/stable-kernel-rules.rst
 create mode 100644 Documentation/translations/zh_TW/process/submit-checklist.rst
 create mode 100644 Documentation/translations/zh_TW/process/submitting-drivers.rst
 create mode 100644 Documentation/translations/zh_TW/process/submitting-patches.rst
 create mode 100644 Documentation/translations/zh_TW/process/volatile-considered-harmful.rst
Documentation/translations/zh_TW/index.rst +6 -4
index cab58e428825..76981b2111f6 100644
@@ -22,9 +22,7 @@
 下面的文檔介紹了Linux內核原始碼的許可證(GPLv2)、如何在原始碼樹中正確標記
 單個文件的許可證、以及指向完整許可證文本的連結。
 
-TODOList:
-
-* Documentation/translations/zh_TW/process/license-rules.rst
+Documentation/translations/zh_TW/process/license-rules.rst
 
 用戶文檔
 --------
@@ -67,9 +65,13 @@ TODOlist:
 開發人員做出貢獻。與任何大型社區一樣,知道如何完成任務將使得更改合併的過程
 變得更加容易。
 
+.. toctree::
+   :maxdepth: 2
+
+   process/index
+
 TODOList:
 
-* process/index
 * dev-tools/index
 * doc-guide/index
 * kernel-hacking/index
Documentation/translations/zh_TW/process/1.Intro.rst new file +199 -0

199 lines not on this page · raw message

Documentation/translations/zh_TW/process/2.Process.rst new file +369 -0

369 lines not on this page · raw message

Documentation/translations/zh_TW/process/3.Early-stage.rst new file +172 -0

172 lines not on this page · raw message

Documentation/translations/zh_TW/process/4.Coding.rst new file +297 -0

297 lines not on this page · raw message

Documentation/translations/zh_TW/process/5.Posting.rst new file +251 -0

251 lines not on this page · raw message

Documentation/translations/zh_TW/process/6.Followthrough.rst new file +156 -0

156 lines not on this page · raw message

Documentation/translations/zh_TW/process/7.AdvancedTopics.rst new file +137 -0

137 lines not on this page · raw message

Documentation/translations/zh_TW/process/8.Conclusion.rst new file +74 -0

74 lines not on this page · raw message

Documentation/translations/zh_TW/process/code-of-conduct-interpretation.rst new file +112 -0

112 lines not on this page · raw message

Documentation/translations/zh_TW/process/code-of-conduct.rst new file +76 -0

76 lines not on this page · raw message

Documentation/translations/zh_TW/process/coding-style.rst new file +958 -0

958 lines not on this page · raw message

Documentation/translations/zh_TW/process/development-process.rst new file +30 -0
new file mode 100644
index 000000000000..45e6385647cd
@@ -0,0 +1,30 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_TW.rst
+
+:Original: :ref:`Documentation/process/development-process.rst <development_process_main>`
+:Translator: Alex Shi <[email protected]>
+             Hu Haowen <[email protected]>
+
+.. _tw_development_process_main:
+
+內核開發過程指南
+================
+
+內容:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 2
+
+   1.Intro
+   2.Process
+   3.Early-stage
+   4.Coding
+   5.Posting
+   6.Followthrough
+   7.AdvancedTopics
+   8.Conclusion
+
+本文檔的目的是幫助開發人員(及其經理)以最小的挫折感與開發社區合作。它試圖記錄這個社區如何以一種不熟悉Linux內核開發(或者實際上是自由軟體開發)的人可以訪問的方式工作。雖然這裡有一些技術資料,但這是一個面向過程的討論,不需要深入了解內核編程就可以理解。
+
Documentation/translations/zh_TW/process/email-clients.rst new file +252 -0

145 lines not on this page · raw message

Documentation/translations/zh_TW/process/embargoed-hardware-issues.rst new file +232 -0

232 lines not on this page · raw message

Documentation/translations/zh_TW/process/howto.rst new file +500 -0

500 lines not on this page · raw message

Documentation/translations/zh_TW/process/index.rst new file +67 -0

67 lines not on this page · raw message

Documentation/translations/zh_TW/process/kernel-driver-statement.rst new file +203 -0

203 lines not on this page · raw message

Documentation/translations/zh_TW/process/kernel-enforcement-statement.rst new file +155 -0

155 lines not on this page · raw message

Documentation/translations/zh_TW/process/license-rules.rst new file +374 -0

374 lines not on this page · raw message

Documentation/translations/zh_TW/process/magic-number.rst new file +148 -0

148 lines not on this page · raw message

Documentation/translations/zh_TW/process/management-style.rst new file +211 -0

211 lines not on this page · raw message

Documentation/translations/zh_TW/process/programming-language.rst new file +76 -0

76 lines not on this page · raw message

Documentation/translations/zh_TW/process/stable-api-nonsense.rst new file +159 -0

159 lines not on this page · raw message

Documentation/translations/zh_TW/process/stable-kernel-rules.rst new file +68 -0

68 lines not on this page · raw message

Documentation/translations/zh_TW/process/submit-checklist.rst new file +109 -0

109 lines not on this page · raw message

Documentation/translations/zh_TW/process/submitting-drivers.rst new file +164 -0

164 lines not on this page · raw message

Documentation/translations/zh_TW/process/submitting-patches.rst new file +686 -0

686 lines not on this page · raw message

Documentation/translations/zh_TW/process/volatile-considered-harmful.rst new file +110 -0

110 lines not on this page · raw message

The rest of this diff is not shown. View the raw message.

Signature · 1 line
2.25.1

Part of the diff is not shown here. View the raw message.

author
#2 lore raw

PATCH v7 3/3 MAINTAINERS: add entry for traditional Chinese documentation

In reply to Hu Haowen

Add maintainer information for traditional Chinese documentation.

---
 MAINTAINERS | 8 ++++++++
 1 file changed, 8 insertions(+)
MAINTAINERS +8 -0
index 66d047dc6880..22d8ca2d5616 100644
@@ -18829,6 +18829,14 @@ F:	arch/x86/mm/testmmiotrace.c
 F:	include/linux/mmiotrace.h
 F:	kernel/trace/trace_mmiotrace.c
 
+TRADITIONAL CHINESE DOCUMENTATION
+M:	Hu Haowen <[email protected]>
+L:	[email protected]
+S:	Maintained
+W:	https://github.com/srcres258/linux-doc
+T:	git git://github.com/srcres258/linux-doc.git doc-zh-tw
+F:	Documentation/translations/zh_TW/
+
 TRIVIAL PATCHES
 M:	Jiri Kosina <[email protected]>
 S:	Maintained
Signature · 1 line
2.25.1