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 |
返回值
void
buildData
异步
生成前端页面需要的数据
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 |
返回值
string
getSearchIndexURL
获取搜索索引地址
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 要处理的地址 | string |
返回值
string
buildUnitTestPage
构建一个单元测试页
buildHomePage
构建一个首页
buildErrorPage
构建一个错误页面
参数
参数名 | 说明 | 类型 |
---|---|---|
errors | 已解析的错误日志 展开子属性
|
|
ext | 文件扩展名 | string |
content | 当前文件内容 | string | |
返回值
string
compileEmbedJS
保护
编译 Markdown 中内嵌的 JS 代码
参数
参数名 | 说明 | 类型 |
---|---|---|
content | 要编译的代码 | string |
lang | 首选的语言 | string |
context | 生成 Markdown 的上下文 展开子属性
|
|
返回值
string
compileEmbedHTML
保护
编译 Markdown 中内嵌的 HTML 代码
参数
参数名 | 说明 | 类型 |
---|---|---|
content | 要编译的代码 | string |
script | 首选的脚本语言 | string |
style | 首选的样式语言 | string |
context | 生成 Markdown 的上下文 展开子属性
|
|
返回值
string
compileEmabedCode
保护
编译 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 | 当前页面的上下文 展开子属性
|
|
返回值
any
renderToolItems
保护
渲染工具栏项
参数
参数名 | 说明 | 类型 |
---|---|---|
context | 页面的上下文 展开子属性
|
|
返回值
?
renderTitle
保护
渲染一个标题
参数
参数名 | 说明 | 类型 |
---|---|---|
context | 页面的上下文 展开子属性
|
|
返回值
?
renderMetaInfo
异步保护
渲染页面头信息
参数
参数名 | 说明 | 类型 |
---|---|---|
context | 页面的上下文 展开子属性
|
|
返回值
Promise
<?>
getMetaInfo
异步保护
获取页面的元数据
参数
参数名 | 说明 | 类型 |
---|---|---|
context | 页面的上下文 展开子属性
|
|
返回值
renderTOC
保护
渲染一个目录
参数
参数名 | 说明 | 类型 |
---|---|---|
context | 页面的上下文 展开子属性
|
|
返回值
?
renderPageHead
保护
渲染页面顶部
参数
参数名 | 说明 | 类型 |
---|---|---|
context | 页面的上下文 展开子属性
|
|
返回值
any
renderPageFoot
保护
渲染页面底部
参数
参数名 | 说明 | 类型 |
---|---|---|
context | 页面的上下文 展开子属性
|
|
返回值
any
renderDocPage
保护
渲染一个文档页
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 文档的地址 | string |
title | 文档的标题 | string |
content | 文档正文 | any |
返回值
string
renderHead
保护
渲染顶部的 HTML
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 当前页面的地址 | string |
(可选)pageData | 页面的附加数据 | any |
返回值
?
renderFoot
保护
渲染底部的 HTML
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 当前页面的地址 | string |
返回值
HTML
renderHeader
保护
渲染头部
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 当前页面的地址 | string |
返回值
?
renderFooter
保护
渲染底部
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 当前页面的地址 | string |
返回值
?
renderLink
保护
渲染一个链接
参数
参数名 | 说明 | 类型 |
---|---|---|
label | 链接的文案 | any |
href | 链接的地址 | string |
(可选)title | 鼠标悬停的工具提示 | string |
(可选)className | 可选设置 CSS 类名 | string |
返回值
?
renderIcon
保护
渲染一个图标
参数
参数名 | 说明 | 类型 |
---|---|---|
name | 图标的名称 | string |
(可选)className | 可选设置 CSS 类名 | string |
返回值
HTML
renderPermalink
保护
渲染本节链接
参数
参数名 | 说明 | 类型 |
---|---|---|
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 | 页面的上下文 展开子属性
|
|
返回值
any
renderDocConstructor
保护
渲染一个索引访问器
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 展开子属性
|
|
parentMember | 所属的类 |
|
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocProperty
保护
渲染一个属性
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 展开子属性
|
|
preferRequested | 是否标记必填项而非可选项 | boolean |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocTypeDetail
保护
渲染类型的子属性
参数
参数名 | 说明 | 类型 |
---|---|---|
type | 要渲染的类型 |
|
context | 页面的上下文 展开子属性
|
|
返回值
any
renderDocIndex
保护
渲染一个索引访问器
参数
参数名 | 说明 | 类型 |
---|---|---|
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 | 页面的上下文 展开子属性
|
|
返回值
any
renderDocParameterList
保护
渲染参数列表
参数
参数名 | 说明 | 类型 |
---|---|---|
parameters | 展开子属性
|
|
context | 页面的上下文 展开子属性
|
|
返回值
any
renderDocUnknownMember
保护
渲染一个未知成员
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocMemberHeader
保护
渲染成员头部
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
icon | 渲染的图标 | string |
postfix | 额外显示的后缀 | string |
preferRequested | 是否标记必填项而非可选项 | boolean |
tocLevel | 添加到目录的等级,如果为 -1 则不添加目录 | number |
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocMemberToolBar
保护
渲染一个工具条
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
context | 页面的上下文 展开子属性
|
|
返回值
any
getSourceURL
保护
获取指定源码地址的链接
参数
参数名 | 说明 | 类型 |
---|---|---|
sourceLocation | 源码地址 展开子属性
|
|
返回值
string
renderDocMemberLink
保护
渲染一个指定成员的链接
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
context | 页面的上下文 展开子属性
|
|
(可选)anchorMember | 附加设置描点的成员 默认值: |
|
返回值
?
getDocURL
保护
获取指定成员文档的链接
参数
参数名 | 说明 | 类型 |
---|---|---|
sourceLocation | 源码地址 展开子属性
|
|
返回值
string
renderDocMemberName
保护
渲染一个成员名
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
postfix | 额外显示的后缀 | string |
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocMemberTags
保护
渲染成员的标签
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
preferRequested | 是否标记必填项而非可选项 | boolean |
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocMemberSummary
保护
渲染成员的概述
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
context | 页面的上下文 展开子属性
|
|
返回值
any
renderDocDeprecatedMessage
保护
渲染已废弃提示
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
context | 页面的上下文 展开子属性
|
|
返回值
any
renderDocMemberDetail
保护
渲染成员的详情描述
参数
参数名 | 说明 | 类型 |
---|---|---|
member | 要渲染的成员 |
|
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocExample
保护
渲染一个示例
参数
参数名 | 说明 | 类型 |
---|---|---|
example | 示例的内容 | string |
context | 页面的上下文 展开子属性
|
|
返回值
any
renderDocSeeAlso
保护
渲染一个参考链接
参数
参数名 | 说明 | 类型 |
---|---|---|
seeAlso | 链接的内容 | string |
context | 页面的上下文 展开子属性
|
|
返回值
?
parseHref
保护
解析一个链接地址
参数
参数名 | 说明 | 类型 |
---|---|---|
href | 要解析的地址 | string |
context | 页面的上下文 展开子属性
|
|
返回值
{href: stringlabel: string}
renderDocType
保护
渲染一个类型
参数
参数名 | 说明 | 类型 |
---|---|---|
type | 要渲染的类型 |
|
context | 页面的上下文 展开子属性
|
|
返回值
?
renderDocTypeWorker
保护
渲染类型
参数
参数名 | 说明 | 类型 |
---|---|---|
type | 要渲染的类型 |
|
context | 页面的上下文 展开子属性
|
|
depth | 遍历的深度 | number |
rendered | 已渲染的类型 |
|
返回值
any
renderDocParameters
保护
渲染类型中的参数列表
参数
参数名 | 说明 | 类型 |
---|---|---|
parameters | 展开子属性
|
|
context | 展开子属性
|
|
depth | number | |
rendered |
|
返回值
any
renderDocObjectType
保护
渲染一个对象类型
参数
参数名 | 说明 | 类型 |
---|---|---|
type | 要渲染的类型 |
|
context | 页面的上下文 展开子属性
|
|
depth | 遍历的深度 | number |
rendered | 已渲染的类型 |
|
返回值
any
renderDocExpression
保护
渲染文档中的表达式
参数
参数名 | 说明 | 类型 |
---|---|---|
expression | 要渲染的表达式 | string | number | |
context | 生成 Markdown 的上下文 展开子属性
|
|
返回值
?
renderDocMarkdown
保护
渲染文档中的 markdown 内容
参数
参数名 | 说明 | 类型 |
---|---|---|
content | 要渲染的内容 | string |
context | 生成 Markdown 的上下文 展开子属性
|
|
返回值
HTML
renderWaterfallList
保护
渲染多个瀑布流
参数
参数名 | 说明 | 类型 |
---|---|---|
items | 要渲染的数据 展开子属性
|
|
baseURL | 每个目录项的根地址 | string |
返回值
[HTML
, number]
renderWaterFall
保护
渲染一个瀑布流
参数
参数名 | 说明 | 类型 |
---|---|---|
items | 要渲染的数据 展开子属性
|
|
baseURL | 每个目录项的根地址 | string |
返回值
[HTML
, number]
renderWaterFallSection
保护
渲染瀑布流的一个区块
参数
参数名 | 说明 | 类型 |
---|---|---|
items | 要渲染的数据 展开子属性
|
|
baseURL | 每个目录项的根地址 | string |
返回值
[HTML
, number]
renderUnitTestPage
保护
渲染一个单元测试页
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 当前页面的地址 | string |
返回值
string
renderHomePage
保护
渲染一个首页
参数
参数名 | 说明 | 类型 |
---|---|---|
url | 当前页面的地址 | string |
返回值
string
DocCompilerOptions 接口
表示文档编译器的选项
属性
属性名 | 说明 | 类型 |
---|---|---|
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[] |