在过去的4天里,我一直试图让yuidoc解析我的javascript框架,这真的开始让我发疯了。
这是我的 JSON 配置文件
{ linkNatives: 'true',
attributesEmit: 'true',
paths: [ '..\\layers' ],
outdir: '../docs/',
port: 3000,
nocode: true,
extension: '.js',
project:
{ name: '{NAME}',
description: '{DESCRIPTION}',
version: '1.0.0',
url: 'http://docs.mysite.com/',
logo: 'http://docs.mysite.com/img/logo.png',
themedir: 'yuidoc-bootstrap-theme' } }
它正在解析 json 配置,没有错误。这是输出:
$ yuidoc ../layers
info: (yuidoc): Starting YUIDoc@0.3.46 using YUI@3.9.1 with NodeJS@0.10.24
info: (yuidoc): Scanning for yuidoc.json file.
info: (yuidoc): Loading yuidoc.json data from: C:devtoolsGitHubFrameworktoolsyuidoc.json
info: (yuidoc): Starting YUIDoc with the following options:
info: (yuidoc):
{ linkNatives: 'true',
attributesEmit: 'true',
paths: [ '..\\layers' ],
outdir: '../docs',
port: 3000,
nocode: false,
project:
{ name: '{NAME}',
description: '{DESCRIPTION}',
version: '1.0.0',
url: 'http://docs.mysite.com/',
logo: 'http://docs.mysite.com/img/logo.png',
themedir: 'yuidoc-bootstrap-theme' } }
info: (yuidoc): YUIDoc Starting from: ..\layers
Nlaak@Nlaak-PC /cygdrive/c/devtools/GitHub/Framework/tools
$
我可以使用命令行和输出和主题的默认设置让它工作,但它没有我的项目构建和版本信息。Bootstrap主题在Github上并且确实有效。我在 Windows 64 上使用 Cygwin 7 64 位。
我有。。。- 检查行尾- 复制和粘贴Yuidocs示例,只需最少的编辑- 尝试命令行的每一个方式- 已验证所有路径和目录是否存在
帮助!为什么没有错误,也没有输出。
我认为在应用自定义配置时 YUIDoc 中存在一个错误。
尝试在配置 JSON 中添加带有"outdir"条目的"输出"属性。
例如,像这样:
{
linkNatives: 'true',
attributesEmit: 'true',
paths: ['..\\layers'],
port: 3000,
nocode: true,
extension: '.js',
project: {
name: '{NAME}',
description: '{DESCRIPTION}',
version: '1.0.0',
url: 'http://docs.mysite.com/',
logo: 'http://docs.mysite.com/img/logo.png',
themedir: 'yuidoc-bootstrap-theme',
options: {
outdir: '..out'
}
}
}
创建 yuidoc.json 喜欢
{
"name": "yout title",
"version": "1.0.0",
"options": {
"outdir": "./docs"
}
}
并在您的终端中运行
c://user/test> yuidoc . -c yuidoc.json --server <js filder path ex: ./example>