当您构建和运行 YUIDoc 时，它会从http://yui.yahooapis.com/.... 这些资源包括样式表和yui.min.js.
如何离线下载和使用这些资源？
这样做的原因是因为我们在 HTTPS 服务器上运行我们的文档。YUIDoc 总是通过 HTTP 协议提供他的文件。
问问题
398 次
1 回答
5
我有同样的问题，我真的不明白为什么没有有效的证书yui.yahooapis.com。这对我有用（使用 YUIDoc 0.5.0）：
创建自定义主题
首先，您需要创建一个新主题来覆盖默认主题的某些部分。
创建以下文件夹结构：
my_theme
├── assets
│ ├── css
│ └── yui
└── layouts
修改主布局
为避免加载远程 CSS 和脚本，您需要更改主布局。
main.handlebars将从原始主题调用的文件复制到您的my_theme/layouts/文件夹。如果您通过节点安装 YUIDoc，则原始文件位于node_modules/yuidocjs/themes/default/layouts/. 或者，您可以从yuidoc GitHub 存储库中获取它。
在该文件中进行以下更改：
1.) 替换link引用远程样式表的标签：
<link rel="stylesheet" href="{{yuiGridsUrl}}">
<link rel="stylesheet" href="{{projectAssets}}/css/cssgrids-min.css">
2.) 替换script引用远程 YUI 库的标签：
<script src="{{yuiSeedUrl}}"></script>
<script src="{{projectAssets}}/yui/build/yui-base/yui-base-min.js"></script>
添加远程资产的本地副本
1.) 从 Yahoo 的 CDN 获取 CSS
从 Yahoo CDN下载cssgrids-min.css并将其放在您的my_theme/assets/css文件夹中。
2.) 下载 YUI 3.9.1 库
从http://yui.zenfs.com/releases/yui3/yui_3.9.1.zip（发行说明）下载 YUI 3.9.1并将build文件夹从存档文件放到my_theme/assets/yui.
构建您的文档
构建文档时，请确保指定自定义主题：
$ yuidoc my_js_folder --themedir my_theme
可能的改进
由于这会在您的项目中添加一堆文件，因此深入了解 YUIDoc 并查看实际需要哪些 YUI 模块并删除其他所有内容可能是有意义的。此外，合并这些文件是可取的（雅虎 CDN 提供的库会这样做，并且应该可以在本地工作）。
于 2015-01-22T10:16:23.993 回答