html - Apple 帮助手册 – 链接样式和脚本，例如

Question

我想知道是否有一些 Apple 帮助书的模板开始。

但是，由于我不是专业程序员，所以我偶然发现了制作苹果帮助书。首先，我对苹果帮助文档的质量感到惊讶。Jekyll Apple Help的作者称之为拜占庭，这正是我的第一印象。但是，我能够学习基本概念。

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

所以问题是：

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

如果我必须处理 JS 和 CSS - 该怎么做？它是必须在 x 代码中编程的东西吗？或者最终，有人可以为我们提供文档化的帮助手册模板吗？

Answer 1

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

话虽如此，除非您希望 HelpViewer 窗口上的 TOC 按钮正常工作，否则您实际上并不需要使用 javascript。如果你这样做了，那么你提到的Jekyll Apple Help项目已经拥有完成这项工作所需的 javascript。

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