@@ -3,51 +3,15 @@ markdown-react-code-preview-loader
3
3
4
4
当前包是 ` webpack ` 的 ` loader ` ,通过配置当前 ` loader ` 加载 ` markdown ` 文档,返回一个 ` JS ` 对象,包含 ` markdown ` 文本,` markdown ` 文本中的示例索引。
5
5
6
- ## 安装使用
6
+ ## 安装 Loader
7
7
8
8
``` bash
9
9
npm i markdown-react-code-preview-loader -D
10
10
```
11
11
12
- 添加 ` loader ` 之后,在项目工程中加载 ` markdown ` 文本使用方法:
12
+ ## 配置 Loader
13
13
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 ` 。
51
15
52
16
** 第 ① 种方法,使用 mdCodeModulesLoader 方法**
53
17
@@ -99,9 +63,47 @@ export default (conf: Configuration, env: 'development' | 'production', options:
99
63
100
64
- lang: 需要解析代码块的语言,默认: ` ["jsx","tsx"] `
101
65
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 标识
103
105
104
- 需要在代码块示例中添加特殊的 ` meta ` 标识,` loader ` 才会去索引对于的 ` react ` 示例,进行代码转换。
106
+ 注意: 需要在代码块示例中添加特殊的 ` meta ` 标识,` loader ` 才会去索引对于的 ` react ` 示例,进行代码转换。
105
107
106
108
1 . ` mdx: ` 特殊标识前缀
107
109
2 . ` mdx:preview ` 控制是否进行进行示例索引,通过对应所在行号,获取需要的示例对象。
0 commit comments