[发明专利]一种组件示例页面编译方法及装置

权利要求书

1.一种组件示例页面编译方法，其特征在于，所述方法包括：

根据组件示例页面与Markdown格式的组件文档的映射关系文件，获取目标组件示例页面对应的Markdown格式的目标组件文档；

将所述目标组件文档转换成组件文档html片段；

将所述组件文档html片段插入所述目标组件示例页面，完成所述目标组件示例页面的编译。

2.根据权利要求1所述的方法，其特征在于，所述方法还包括：

根据组件示例页面的目录和文件名称获取组件实现代码；

从所述组件实现代码中提取组件文档内容；

根据所述组件文档内容生成Markdown格式的组件文档；

生成所述组件示例页面与所述Markdown格式的组件文档的映射关系文件。

3.根据权利要求2所述的方法，其特征在于，所述从所述组件实现代码中提取组件文档内容，包括：

根据注释数据从所述组件实现代码中提取所述组件文档内容，所述注释数据包括组件的名称、属性、事件、插槽和外部可调用的方法。

4.根据权利要求1所述的方法，其特征在于，所述将所述组件文档html片段插入所述目标组件示例页面，包括：

根据组件实现代码将所述组件文档html片段插入所述目标组件示例页面的预设位置。

5.根据权利要求1所述的方法，其特征在于，若所述目标组件文档为特殊组件文档，所述方法还包括：

手动维护所述特殊组件文档和特殊组件示例页面的特殊映射关系，所述特殊组件文档为无法生成Markdown格式的组件文档。

6.一种组件示例页面编译装置，其特征在于，所述装置包括：

获取模块，用于根据组件示例页面与Markdown格式的组件文档的映射关系文件，获取目标组件示例页面对应的Markdown格式的目标组件文档；

转换模块，用于将所述目标组件文档转换成组件文档html片段；

编译模块，用于将所述组件文档html片段插入所述目标组件示例页面，

完成所述目标组件示例页面的编译。

7.根据权利要求6所述的装置，其特征在于，所述装置还包括：

所述获取模块，还用于根据组件示例页面的目录和文件名称获取组件实现代码；

提取模块，用于从所述组件实现代码中提取组件文档内容；

生成模块，用于根据所述组件文档内容生成Markdown格式的组件文档；

所述生成模块，还用于生成所述组件示例页面与所述Markdown格式的组件文档的映射关系文件。

8.根据权利要求6所述的装置，其特征在于，所述提取模块，具体用于：

根据注释数据从所述组件实现代码中提取所述组件文档内容，所述注释数据包括组件的名称、属性、事件、插槽和外部可调用的方法。

9.根据权利要求6所述的装置，其特征在于，所述编译模块，用于将所述组件文档html片段插入所述目标组件示例页面，包括：

根据组件实现代码将所述组件文档html片段插入所述目标组件示例页面的预设位置。

10.根据权利要求6所述的装置，其特征在于，若所述目标组件文档为特殊组件文档，所述装置还包括：

手动维护模块，用于手动维护所述特殊组件文档和特殊组件示例页面的特殊映射关系，所述特殊组件文档为无法生成Markdown格式的组件文档。