DocCompiler
API
DocCompiler 类
表示一个文档编译器
构造函数
new DocCompiler
初始化新的编译器
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
builder | 所属的构建器 | |
属性
| 属性名 | 说明 | 类型 |
|---|---|---|
options只读 | 获取编译器的选项 展开子属性
| |
builder只读 | 所属的构建器 | |
markdownCompiler只读 | 获取使用的 Markdown 编译器 | |
icons只读 | 所有可用图标 | {[name: string]: string} |
searchKeywords只读 | 每个页面对应的搜索关键字 | {[url: string]: string[]} |
方法
buildDocPage异步
构建指定的文档页
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
content | 要编译的 Markdown 源码 | string |
path | 模块的原始绝对路径 | string |
outPath | 模块的输出绝对路径 | string |
(可选)options | 附加选项 | |
返回值
Promise<{content: stringerrors: LogEntry[]dependencies: (string | DependencyCallback)[]}>buildIndexPage异步
生成一个列表页
addSearchKeyword
添加指定页面对应的搜索关键字
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 页面地址 | string |
keyword | 要添加的关键字 | string |
返回值
voidbuildData异步
生成前端页面需要的数据
getGeneratedDataURLs异步生成器
获取动态生成的所有文件的地址
返回值
AsyncGenerator<string, void, unknown>loadPageIndex异步
获取指定文件夹的索引数据
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
dir | 要扫描的文件夹绝对路径 | string |
返回值
Promise<{autoGenerated: booleanpath: stringdependencies: (string | DependencyCallback)[]header: stringtitle: stringbody: stringitems: MarkdownListItem[]}>generatePageIndex异步
扫描并生成指定文件夹的页面列表
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
dir | 要扫描的文件夹 | string |
(可选)root | 所属的根文件夹 默认值: | string |
(可选)extensions | 扫描的文件扩展名 | string[] |
返回值
Promise<MarkdownListItem[]>loadPageIndexItem异步
解析指定页面对应的列表项
getPageIndexURL
获取指定地址对应的页面索引地址
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 要处理的地址 | string |
返回值
stringgetSearchIndexURL
获取搜索索引地址
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 要处理的地址 | string |
返回值
stringbuildUnitTestPage
构建一个单元测试页
buildHomePage
构建一个首页
buildErrorPage
构建一个错误页面
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
errors | 已解析的错误日志 展开子属性
| |
ext | 文件扩展名 | string |
content | 当前文件内容 | string | |
返回值
stringcompileEmbedJS保护
编译 Markdown 中内嵌的 JS 代码
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
content | 要编译的代码 | string |
lang | 首选的语言 | string |
context | 生成 Markdown 的上下文 展开子属性
| |
返回值
stringcompileEmbedHTML保护
编译 Markdown 中内嵌的 HTML 代码
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
content | 要编译的代码 | string |
script | 首选的脚本语言 | string |
style | 首选的样式语言 | string |
context | 生成 Markdown 的上下文 展开子属性
| |
返回值
stringcompileEmabedCode保护
编译 Markdown 中内嵌的代码,如果不支持该语言则返回 undefined
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
content | 要编译的代码 | string |
language | 语言 | string |
context | 生成 Markdown 的上下文 展开子属性
| |
返回值
{container: stringjs: stringhtml?: undefined} | {container: stringhtml: stringjs?: undefined}renderCodeToolBar保护
渲染代码区块的工具条
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
content | 要编译的代码 | string |
language | 语言 | string |
info | 代码块的信息 | string |
compiledCode | 已编译的代码 展开子属性
| {html?: stringjs?: stringcontainer?: string} |
context | 生成 Markdown 的上下文 展开子属性
| |
返回值
?parseMarkdownMeta保护
解析 Markdown 的元数据
renderTools保护
渲染工具栏
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 当前页面的上下文 展开子属性
| |
返回值
anyrenderToolItems保护
渲染工具栏项
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 页面的上下文 展开子属性
| |
返回值
?renderTitle保护
渲染一个标题
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 页面的上下文 展开子属性
| |
返回值
?renderMetaInfo异步保护
渲染页面头信息
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 页面的上下文 展开子属性
| |
返回值
Promise<?>getMetaInfo异步保护
获取页面的元数据
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 页面的上下文 展开子属性
| |
返回值
renderTOC保护
渲染一个目录
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 页面的上下文 展开子属性
| |
返回值
?renderPageHead保护
渲染页面顶部
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 页面的上下文 展开子属性
| |
返回值
anyrenderPageFoot保护
渲染页面底部
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocPage保护
渲染一个文档页
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 文档的地址 | string |
title | 文档的标题 | string |
content | 文档正文 | any |
返回值
stringrenderHead保护
渲染顶部的 HTML
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 当前页面的地址 | string |
(可选)pageData | 页面的附加数据 | any |
返回值
?renderFoot保护
渲染底部的 HTML
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 当前页面的地址 | string |
返回值
HTMLrenderHeader保护
渲染头部
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 当前页面的地址 | string |
返回值
?renderFooter保护
渲染底部
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 当前页面的地址 | string |
返回值
?renderLink保护
渲染一个链接
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
label | 链接的文案 | any |
href | 链接的地址 | string |
(可选)title | 鼠标悬停的工具提示 | string |
(可选)className | 可选设置 CSS 类名 | string |
返回值
?renderIcon保护
渲染一个图标
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
name | 图标的名称 | string |
(可选)className | 可选设置 CSS 类名 | string |
返回值
HTMLrenderPermalink保护
渲染本节链接
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
anchor | 当前链接的哈希值 | string |
返回值
?renderAPIDoc保护
渲染指定文件的 API 文档
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
sourcePath | JS/TS 文件路径 | string |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocMembers保护
渲染成员列表
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
members | 要渲染的成员 | |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
any[]renderDocMember保护
渲染指定的成员
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocClassOrInterface保护
渲染一个类或接口
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderExtendingHierarchy保护
渲染一个继承链
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
type | 基础类型 | |
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocConstructor保护
渲染一个索引访问器
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
parentMember | 所属的类 | |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocProperty保护
渲染一个属性
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
preferRequested | 是否标记必填项而非可选项 | boolean |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocTypeDetail保护
渲染类型的子属性
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
type | 要渲染的类型 | |
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocIndex保护
渲染一个索引访问器
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocEnum保护
渲染一个枚举类型
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocNamespace保护
渲染一个命名空间
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocModule保护
渲染一个包
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocTypeAlias保护
渲染一个类型别名
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocVariable保护
渲染一个变量
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocFunction保护
渲染一个函数或方法
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocFunctionBody保护
渲染一个函数或方法主体
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 展开子属性
| |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocTypeParameterList保护
渲染类型参数列表
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
typeParameters | 类型列表 | |
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocParameterList保护
渲染参数列表
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
parameters | 展开子属性
| |
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocUnknownMember保护
渲染一个未知成员
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocMemberHeader保护
渲染成员头部
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
icon | 渲染的图标 | string |
postfix | 额外显示的后缀 | string |
preferRequested | 是否标记必填项而非可选项 | boolean |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocMemberToolBar保护
渲染一个工具条
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
context | 页面的上下文 展开子属性
| |
返回值
anygetSourceURL保护
获取指定源码地址的链接
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
sourceLocation | 源码地址 展开子属性
| |
返回值
stringrenderDocMemberLink保护
渲染一个指定成员的链接
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
context | 页面的上下文 展开子属性
| |
(可选)anchorMember | 附加设置描点的成员 默认值: | |
返回值
?getDocURL保护
获取指定成员文档的链接
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
sourceLocation | 源码地址 展开子属性
| |
返回值
stringrenderDocMemberName保护
渲染一个成员名
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
postfix | 额外显示的后缀 | string |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocMemberTags保护
渲染成员的标签
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
preferRequested | 是否标记必填项而非可选项 | boolean |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocMemberSummary保护
渲染成员的概述
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocDeprecatedMessage保护
渲染已废弃提示
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocMemberDetail保护
渲染成员的详情描述
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
member | 要渲染的成员 | |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocExample保护
渲染一个示例
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
example | 示例的内容 | string |
context | 页面的上下文 展开子属性
| |
返回值
anyrenderDocSeeAlso保护
渲染一个参考链接
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
seeAlso | 链接的内容 | string |
context | 页面的上下文 展开子属性
| |
返回值
?parseHref保护
解析一个链接地址
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
href | 要解析的地址 | string |
context | 页面的上下文 展开子属性
| |
返回值
{href: stringlabel: string}renderDocType保护
渲染一个类型
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
type | 要渲染的类型 | |
context | 页面的上下文 展开子属性
| |
返回值
?renderDocTypeWorker保护
渲染类型
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
type | 要渲染的类型 | |
context | 页面的上下文 展开子属性
| |
depth | 遍历的深度 | number |
rendered | 已渲染的类型 | |
返回值
anyrenderDocParameters保护
渲染类型中的参数列表
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
parameters | 展开子属性
| |
context | 展开子属性
| |
depth | number | |
rendered | |
返回值
anyrenderDocObjectType保护
渲染一个对象类型
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
type | 要渲染的类型 | |
context | 页面的上下文 展开子属性
| |
depth | 遍历的深度 | number |
rendered | 已渲染的类型 | |
返回值
anyrenderDocExpression保护
渲染文档中的表达式
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
expression | 要渲染的表达式 | string | number | |
context | 生成 Markdown 的上下文 展开子属性
| |
返回值
?renderDocMarkdown保护
渲染文档中的 markdown 内容
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
content | 要渲染的内容 | string |
context | 生成 Markdown 的上下文 展开子属性
| |
返回值
HTMLrenderWaterfallList保护
渲染多个瀑布流
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
items | 要渲染的数据 展开子属性
| |
baseURL | 每个目录项的根地址 | string |
返回值
[HTML, number]renderWaterFall保护
渲染一个瀑布流
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
items | 要渲染的数据 展开子属性
| |
baseURL | 每个目录项的根地址 | string |
返回值
[HTML, number]renderWaterFallSection保护
渲染瀑布流的一个区块
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
items | 要渲染的数据 展开子属性
| |
baseURL | 每个目录项的根地址 | string |
返回值
[HTML, number]renderUnitTestPage保护
渲染一个单元测试页
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 当前页面的地址 | string |
返回值
stringrenderHomePage保护
渲染一个首页
参数
| 参数名 | 说明 | 类型 |
|---|---|---|
url | 当前页面的地址 | string |
返回值
stringDocCompilerOptions 接口
表示文档编译器的选项
属性
| 属性名 | 说明 | 类型 |
|---|---|---|
baseURL | 生成的页面中引用资源的根地址 | string |
logo | 项目 LOGO,可以是一段 | string |
displayName | 项目展示名,用于网站标题栏及左上角 LOGO 文案 | string |
version | 项目版本 | string |
versions | 其它版本链接 展开子属性
| |
navbar | 顶部导航条链接 展开子属性
| ( |
footer | 底部链接 展开子属性
| |
copyright | 底部版权声明 | string |
injectHead | 生成的文档头部插入的 HTML 代码,比如 SEO 标记 | string |
injectFoot | 生成的文档末尾插入的 HTML 代码,比如放入一些统计代码 | string |
maxTOCLevel | 自动生成索引的最大标题等级(1-6)(默认 4) | number |
counter | 定制为每个标题生成序号 | false | true | (function(counts: number[], item: |
backToTop | 是否插入返回顶部链接 | boolean |
introDescription | 项目描述 | string |
introButtons | 项目描述后的按钮 展开子属性
| |
features | 项目优势说明链接 展开子属性
| ( |
links | 友情链接 展开子属性
| ( |
support | 支持/赞助链接 展开子属性
| |
packageName | 发布的包名 | string |
repository | 项目仓库地址(HTTPS 协议) | string |
repositoryPath | 项目根目录在仓库中的路径 | string |
branch | 项目仓库分支 | string |
readCommits | 读取指定文件的修改记录 | (files: string[]) => |
Link 接口
表示一个链接配置
属性
| 属性名 | 说明 | 类型 |
|---|---|---|
label | 链接文案 | string |
href(可选) | 链接地址 | string |
title(可选) | 鼠标悬停时的工具提示 | string |
CommitInfo 接口
表示提交信息
属性
| 属性名 | 说明 | 类型 |
|---|---|---|
authorName | 作者名 | string |
authorEmail | 作者邮箱 | string |
date | 提交时间 | string |
DocPageContext 接口
表示一个生成一个文档页的上下文
属性
| 属性名 | 说明 | 类型 |
|---|---|---|
url | 当前页面的最终访问地址 | string |
sourceURL | 生成当前页面的源地址 | string |
errors | 构建当前页面时产生的错误 展开子属性
| |
dependencies | 构建当前页面时读取的依赖路径 | (string | |
tocManager | 目录管理器 | |
demoCount | 演示计数器 | number |
demoForTestCount | 自测用演示计数器 | number |
scriptCount | 内联脚本计数器 | number |
meta | 当前页面的信息 展开子属性
| |
title | 当前页面的标题 | string |
maxTOCLevel(可选) | 自动生成索引的最大标题等级(1-6)(默认 4) | number |
narrow(可选) | 是否渲染为窄页面,窄页面适合文字多的页面 | boolean |
pager(可选) | 是否生成分页器 | boolean |
activeURL(可选) | 导航高亮的当前页地址 | string |
prevPage(可选) | 上一页地址 展开子属性
| |
nextPage(可选) | 下一页地址 展开子属性
| |
codeURL(可选) | 当前页面对应的 TS/JS 源码地址(如果有) | string |
unitTestURL(可选) | 当前页面对应的单元测试源码地址(如果有) | string |
docParser(可选) | API 文档解析器(如果有) | |
subtitle(可选) | 当前页面的副标题 | any |
state(可选) | 当前页面的状态 | string |
tags(可选) | 所有标签 | string[] |
authors(可选) | 所有维护者 展开子属性
| |
changeLogs(可选) | 所有修改历史 展开子属性
| |
DocPageMeta 接口
表示文档页面的元数据
MarkdownMeta属性
| 属性名 | 说明 | 类型 |
|---|---|---|
toc(可选) | 是否生成目录,如果是数字则表示生成目录的最低标题等级(1-4) | number | false | true |
injectHead(可选) | 额外插入的文件头部内容 | any |
injectFoot(可选) | 额外插入的文件底部内容 | any |
pager(可选) | 是否插入翻页器 | boolean |
counter(可选) | 是否插入标题计数器 | false | true | (function(counts: number[], item: |
narrow(可选) | 是否生成窄页面风格 | boolean |
api(可选) | 是否自动生成关联的 API 文档 | boolean |
meta(可选) | 是否显示当前文件的元信息 | boolean |
继承自 MarkdownMeta 接口的属性
| 属性名 | 说明 | 类型 |
|---|---|---|
header | 头部内容 | string |
body | 正文内容 | string |
title(可选) | 页面标题 | string |
subtitle(可选) | 页面副标题 | string |
name(可选) | 页面名称 | string |
description(可选) | 页面描述 | string |
state(可选) | 页面状态 | string |
tags(可选) | 所有标签 | string[] |
keywords(可选) | 所有关键字 | string[] |
authors(可选) | 所有作者 展开子属性
| {name: string // 作者的名字email?: string // 作者的邮箱href?: string // 作者的首页}[] |
changeLogs(可选) | 所有修订记录 | string[] |