Apple Help Book – 链接样式和脚本,例如

Apple Help Book – Linking styles and Scripts like

不知道有没有苹果帮助书的启动模板

由于我不是专业的程序员,但是,我遇到了制作苹果帮助书的过程。首先,我很惊讶 the apple help documentation quality. The author of Jekyll Apple Help 称它为拜占庭,这正是我的第一印象。但是,我能够学习基本概念。

当我检查了 Apple 如何为他们的应用程序制作教程时,我意识到他们只使用简单的 HTML 文件,没有任何 JS 和 CSS。

所以问题是:

如何做到像苹果一样? 这是苹果帮助查看器中神奇发生的事情吗? 是否有一些隐藏的方式将样式和脚本链接到其他地方? 如果这是必须手动制作的东西

如果我必须照顾 JS 和 CSS – 怎么办?它是必须用 x 代码编程的东西吗? 或者最终,有人可以为我们提供文档化的帮助手册模板吗?

Apple 确实使用 Javascript。还有很多。例如,如果您查看他们的 Pages.app 帮助包,您会发现至少 3 个 javascript 文件。这些 javascript 文件似乎负责加载和显示 HTML 文件。所以你不会在里面找到任何 javascript。

话虽如此,您实际上并不需要使用 javascript,除非您希望 HelpViewer window 上的 TOC 按钮起作用。如果这样做,您提到的 Jekyll Apple Help 项目已经具有完成这项工作所需的 javascript。

您应该提交一份雷达,要求更新文档和示例代码。当我构建我的应用程序的帮助手册时,我确实这样做了。