@@ -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
99npm 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
1061081 . ` mdx: ` 特殊标识前缀
1071092 . ` mdx:preview ` 控制是否进行进行示例索引,通过对应所在行号,获取需要的示例对象。
0 commit comments