docs/zh_CN: Add translations for libsas and wd719x

Translate .../scsi/wd719x.rst into Chinese.
Add wd719x into .../scsi/index.rst.

Update the translation through commit 40ee63091a40 ("scsi: docs: convert wd719x.txt to ReST")

Signed-off-by Yujie Zhang <[email protected]>

---
 .../translations/zh_CN/scsi/index.rst         |  2 +-
 .../translations/zh_CN/scsi/wd719x.rst        | 36 +++++++++++++++++++
 2 files changed, 37 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/scsi/wd719x.rst

Documentation/translations/zh_CN/scsi/index.rst +1 -1

index 5eecbef4c9c0..5f1803e2706c 100644
@@ -52,6 +52,7 @@ SCSI主机适配器驱动
 
    libsas
    sd-parameters
+   wd719x
 
 Todolist:
 

@@ -87,6 +88,5 @@ Todolist:
 * sym53c8xx_2
 * tcm_qla2xxx
 * ufs
-* wd719x
 
 * scsi_transport_srp/figures

Documentation/translations/zh_CN/scsi/wd719x.rst new file +6 -0

new file mode 100644
index 000000000000..5f82c9220541
@@ -0,0 +1,36 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/scsi/libsas.rst
+
+:翻译:

Documentation/translations/zh_CN/scsi/wd719x.rst new file +20 -1

+
+该卡需要加载固件。固件可从 Windows NT 驱动中提取，该驱动可在以下
+地址从 WD 官方下载：
+http://support.wdc.com/product/download.asp?groupid=801&sid=27&lang=en
+
+该文件或网页上都未包含任何许可声明，因此该固件可能无法被收录到
+linux-firmware 项目中。
+
+提供的脚本可用于下载并提取固件，生成 wd719x-risc.bin 和
+wd719x-wcs.bin 文件。请将它们放置在 /lib/firmware/ 目录下。
+脚本内容如下：
+
+       #!/bin/sh
+       wget http://support.wdc.com/download/archive/pciscsi.exe
+       lha xi pciscsi.exe pci-scsi.exe
+       lha xi pci-scsi.exe nt/wd7296a.sys
+       rm pci-scsi.exe
+       dd if=wd7296a.sys of=wd719x-risc.bin bs=1 skip=5760 count=14336
+       dd if=wd7296a.sys of=wd719x-wcs.bin bs=1 skip=20096 count=514
+       rm wd7296a.sys
--

2.25.1

Quoted 45 lines · Yujie Zhang <[email protected]> 于2025年11月16日周日 15:16写道：

Translate .../scsi/wd719x.rst into Chinese.
Add wd719x into .../scsi/index.rst.

Update the translation through commit 40ee63091a40 ("scsi: docs: convert wd719x.txt to ReST")

Signed-off-by Yujie Zhang <[email protected]>

---
  .../translations/zh_CN/scsi/index.rst         |  2 +-
  .../translations/zh_CN/scsi/wd719x.rst        | 36 +++++++++++++++++++
  2 files changed, 37 insertions(+), 1 deletion(-)

create mode 100644 Documentation/translations/zh_CN/scsi/wd719x.rst

Documentation/translations/zh_CN/scsi/index.rst +1 -1

index 5eecbef4c9c0..5f1803e2706c 100644
@@ -52,6 +52,7 @@ SCSI主机适配器驱动
 
     libsas
     sd-parameters
+   wd719x
 
  Todolist:
 

@@ -87,6 +88,5 @@ Todolist:
  * sym53c8xx_2
  * tcm_qla2xxx
  * ufs
-* wd719x
 
  * scsi_transport_srp/figures

Documentation/translations/zh_CN/scsi/wd719x.rst new file +6 -0

new file mode 100644
index 000000000000..5f82c9220541
@@ -0,0 +1,36 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/scsi/libsas.rst
+
+:翻译:

Documentation/translations/zh_CN/scsi/wd719x.rst line 16

Quoted 10 lines

Documentation/translations/zh_CN/scsi/wd719x.rst new file +10 -0

+
+ 张钰杰 Yujie Zhang <[email protected]>
+
+:校译:
+
+
+
+===============================================================
+Western Digital WD7193, WD7197 and WD7296 SCSI 卡驱动
+===============================================================

This format looks incorrect for RST rules, did you check your output after do 'make htmldocs'?

Quoted 23 lines

Documentation/translations/zh_CN/scsi/wd719x.rst new file +20 -1

+
+该卡需要加载固件。固件可从 Windows NT 驱动中提取，该驱动可在以下
+地址从 WD 官方下载：
+http://support.wdc.com/product/download.asp?groupid=801&sid=27&lang=en
+
+该文件或网页上都未包含任何许可声明，因此该固件可能无法被收录到
+linux-firmware 项目中。
+
+提供的脚本可用于下载并提取固件，生成 wd719x-risc.bin 和
+wd719x-wcs.bin 文件。请将它们放置在 /lib/firmware/ 目录下。
+脚本内容如下：
+
+       #!/bin/sh
+       wget http://support.wdc.com/download/archive/pciscsi.exe
+       lha xi pciscsi.exe pci-scsi.exe
+       lha xi pci-scsi.exe nt/wd7296a.sys
+       rm pci-scsi.exe
+       dd if=wd7296a.sys of=wd719x-risc.bin bs=1 skip=5760 count=14336
+       dd if=wd7296a.sys of=wd719x-wcs.bin bs=1 skip=20096 count=514
+       rm wd7296a.sys
--

2.25.1

Hi Alex,

Thanks for your review.

I have run make htmldocs locally and the generated HTML output looks correct on my side — I didn’t see rendering issues or warnings related to this header section.

Could you please point out which part of the format violates the RST rules, or what specific issue you observed in the HTML output? I’d like to fix it properly.

Thanks again for your feedback.

Best regards,
Yujie Zhang

在 2025/11/22 22:29, Alex Shi 写道:

Quoted 8 lines · Yujie Zhang

Hi Alex,

Thanks for your review.

I have run make htmldocs locally and the generated HTML output looks correct on my side — I didn’t see rendering issues or warnings related to this header section.

Could you please point out which part of the format violates the RST rules, or what specific issue you observed in the HTML output? I’d like to fix it properly.

https://en.wikipedia.org/wiki/ReStructuredText
https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html

There's plenty docs of the RST syntax online. Please check and follow them.

Quoted 7 lines

Thanks again for your feedback.

Best regards,
Yujie Zhang

在 2025/11/22 22:29, Alex Shi 写道: