Skip to content

Commit d38c18a

Browse files
committed
doc: Update README.md
1 parent 4e4afc1 commit d38c18a

File tree

1 file changed

+43
-41
lines changed

1 file changed

+43
-41
lines changed

core/README.md

Lines changed: 43 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -3,51 +3,15 @@ markdown-react-code-preview-loader
33

44
当前包是 `webpack``loader`,通过配置当前 `loader` 加载 `markdown` 文档,返回一个 `JS` 对象,包含 `markdown` 文本,`markdown` 文本中的示例索引。
55

6-
## 安装使用
6+
## 安装 Loader
77

88
```bash
99
npm i markdown-react-code-preview-loader -D
1010
```
1111

12-
添加 `loader` 之后,在项目工程中加载 `markdown` 文本使用方法:
12+
## 配置 Loader
1313

14-
```jsx
15-
import mdObj from 'markdown-react-code-preview-loader/README.md';
16-
17-
mdObj.source // => `README.md` 原始字符串文本
18-
mdObj.components // => 组件索引对象,从 markdown 索引到的示例转换成的 React 组件。(需要配置 meta)
19-
mdObj.codeBlock // => 组件源码索引对象,从 markdown 索引到的示例源码。(需要配置 meta)
20-
```
21-
22-
```js
23-
{
24-
codeBlock: {
25-
17: 'import React from ...',
26-
77: 'import React from ...',
27-
base23: 'import React from ...'
28-
},
29-
components: { 17: ƒ, 77: ƒ, base23: ƒ },
30-
languages: { 17: 'jsx', 77: 'jsx', base23: 'jsx'},
31-
source: "# Alert 确认对话框...."
32-
}
33-
```
34-
35-
```ts
36-
export type CodeBlockData = {
37-
source: string;
38-
components: Record<string | number, React.FC>;
39-
codeBlock: Record<string | number, string>;
40-
languages: Record<string | number, string>;
41-
};
42-
```
43-
44-
## getCodeBlockString
45-
46-
传递 `markdown` 文件内容字符串,返回转换好的需要预览的代码块解析数据。
47-
48-
## mdCodeModulesLoader
49-
50-
当前方法是 `webpack``loader`,通过在 kkt 中两种配置方法,了解如何使用配置 loader。
14+
安装依赖(loader)之后,我们需要将 `loader` 配置到 `webpack` 配置中,通过在 `kkt` 中两种配置方法,了解如何使用配置 `loader`
5115

5216
**第 ① 种方法,使用 mdCodeModulesLoader 方法**
5317

@@ -99,9 +63,47 @@ export default (conf: Configuration, env: 'development' | 'production', options:
9963

10064
- lang: 需要解析代码块的语言,默认: `["jsx","tsx"]`
10165

102-
## Markdown 设置 meta 值
66+
## 使用
67+
68+
添加 `loader` 之后,在项目工程中加载 `markdown` 文本使用方法:
69+
70+
```jsx
71+
import mdObj from 'markdown-react-code-preview-loader/README.md';
72+
73+
mdObj.source // => `README.md` 原始字符串文本
74+
mdObj.components // => 组件索引对象,从 markdown 索引到的示例转换成的 React 组件。(需要配置 meta)
75+
mdObj.codeBlock // => 组件源码索引对象,从 markdown 索引到的示例源码。(需要配置 meta)
76+
```
77+
78+
```js
79+
{
80+
codeBlock: {
81+
17: 'import React from ...',
82+
77: 'import React from ...',
83+
base23: 'import React from ...'
84+
},
85+
components: { 17: ƒ, 77: ƒ, base23: ƒ },
86+
languages: { 17: 'jsx', 77: 'jsx', base23: 'jsx'},
87+
source: "# Alert 确认对话框...."
88+
}
89+
```
90+
91+
```ts
92+
export type CodeBlockData = {
93+
source: string;
94+
components: Record<string | number, React.FC>;
95+
codeBlock: Record<string | number, string>;
96+
languages: Record<string | number, string>;
97+
};
98+
```
99+
100+
## getCodeBlockString
101+
102+
传递 `markdown` 文件内容字符串,返回转换好的需要预览的代码块解析数据。
103+
104+
## 配置 meta 标识
103105

104-
需要在代码块示例中添加特殊的 `meta` 标识,`loader` 才会去索引对于的 `react` 示例,进行代码转换。
106+
注意:需要在代码块示例中添加特殊的 `meta` 标识,`loader` 才会去索引对于的 `react` 示例,进行代码转换。
105107

106108
1. `mdx:` 特殊标识前缀
107109
2. `mdx:preview` 控制是否进行进行示例索引,通过对应所在行号,获取需要的示例对象。

0 commit comments

Comments
 (0)