Skip to content

Commit 1dbb182

Browse files
authored
Merge pull request #391 from Peefy/doc-add-doc-gen-escape-html-flag
docs: add doc gen escape html flag docs
2 parents e9c48ce + 37ccc35 commit 1dbb182

File tree

6 files changed

+26
-2
lines changed

6 files changed

+26
-2
lines changed

docs/tools/cli/kcl/docgen.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,12 @@ Generate Markdown document for specific package to a `<target directory>`
7878
kcl doc generate --file-path <package path> --target <target directory>
7979
```
8080

81+
If you encounter output format issues such as HTML or Markdown, such as symbol display errors such as `|`, `\n`, etc., you can add the `--escape-html` flag.
82+
83+
```shell
84+
kcl doc generate --escape-html
85+
```
86+
8187
## Appendix
8288

8389
### Concept of reST

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/kcl/docgen.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,12 @@ kcl doc generate --file-path <package path>
7878
kcl doc generate --file-path <package path> --target <target directory>
7979
```
8080

81+
如果您遇到了 HTML 或者 Markdown 等输出格式问题,比如 `|`, `\n` 等符号显示错误,您可以添加 `--escape-html` 标志
82+
83+
```shell
84+
kcl doc generate --escape-html
85+
```
86+
8187
## 文档工具附录
8288

8389
### 常见的 reST 概念

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.9/tools/cli/kcl/docgen.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,12 @@ kcl doc generate --file-path <package path>
7878
kcl doc generate --file-path <package path> --target <target directory>
7979
```
8080

81+
如果您遇到了 HTML 或者 Markdown 等输出格式问题,比如 `|`, `\n` 等符号显示错误,您可以添加 `--escape-html` 标志
82+
83+
```shell
84+
kcl doc generate --escape-html
85+
```
86+
8187
## 文档工具附录
8288

8389
### 常见的 reST 概念

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.9/user_docs/support/faq-kcl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2642,4 +2642,4 @@ another_module = "0.1.1"
26422642
import another_module
26432643
```
26442644

2645-
`another-module = "0.1.1"` 和 `another_module = "0.1.1"` 是等价的, 如果同时在 `kcl.mod` 中使用这两种写法会得到一个错误。
2645+
`another-module = "0.1.1"` 和 `another_module = "0.1.1"` 是等价的, 如果同时在 `kcl.mod` 中使用这两种写法会得到一个错误。

versioned_docs/version-0.9/tools/cli/kcl/docgen.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,12 @@ Generate Markdown document for specific package to a `<target directory>`
7878
kcl doc generate --file-path <package path> --target <target directory>
7979
```
8080

81+
If you encounter output format issues such as HTML or Markdown, such as symbol display errors such as `|`, `\n`, etc., you can add the `--escape-html` flag.
82+
83+
```shell
84+
kcl doc generate --escape-html
85+
```
86+
8187
## Appendix
8288

8389
### Concept of reST

versioned_docs/version-0.9/user_docs/getting-started/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Getting Started
22

3-
Get started include a quick overview of the KCL programming language.
3+
Getting Started include a quick overview of the KCL programming language.
44

55
import DocCardList from '@theme/DocCardList';
66

0 commit comments

Comments
 (0)