如何使用离线资源构建YUIDoc？

Question

当你构建并运行YUIDoc时,它会从中获取一些资源http://yui.yahooapis.com/....这些资源包括样式表和yui.min.js.
如何离线下载和使用这些资源？

原因是我们在HTTPS服务器上运行我们的文档.YUIDoc始终通过HTTP协议提供文件.

Answer 1

我有同样的问题,我真的不明白为什么没有有效的证书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.)从雅虎的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服务的图书馆这样做,并且应该可以让它在本地工作).