xcode5 - XCode 5 : Documentation Viewer only shows "What' s New in Xcode"

Question

当我在 XCode 5 中选择“帮助->文档和 API 引用”时，文档查看器窗口中显示的唯一内容是“Xcode 中的新功能”注释。我看不到任何浏览或加载任何实际 API 文档内容的方法。

我检查了 ~/Library/Developer/Shared/Documentation/DocSets 文件夹并验证了 iOS5 - iOS7 的文档集。重新安装 XCode 4.6.3 后，我还验证了可以在旧的 Organizer Help 中看到的文档内容。

我宁愿不保留 XCode 4 只是为了离线阅读文档；如何强制 XCode 5 加载本地文档集？

Answer 1

简短的回答:

似乎搜索文档是唯一的选择。右侧边栏是仅适用于当前文档的索引(在本例中为“Xcode 中的新增内容”)。文档在那里并且对 Xcode 5 可见，但它似乎没有公开直接浏览它们的方法。

长答案:

在我看来，您必须搜索文档而不是能够浏览它。例如，使用默认搜索设置(“自动”上的放大镜)，搜索“Mountain Lion”(不突出显示自动完成条目)将打开一个搜索页面，在 SDK Guides 下将是条目“OS X Mountain狮子 v10.8"。右侧边栏将变成“OS X 中的新功能”类别的浏览器。这似乎是“浏览”文档的唯一方法。即使使用 View->Show Tab Bar 并打开一个新选项卡也只会打开一个空白页面。

Apple Developer 页面 "New Features in Xcode 5" 包含有关新文档查看器的信息。描述听起来类似于在线图书馆的工作方式，如果当前文档有多个部分，它将显示当前打开的文档的目录。例如，我链接的页面是“Xcode 中的新功能”文档的一部分。从链接页面和查看应用程序来看，都没有迹象表明有一种方法可以像 Xcode 4 一样浏览类别。

Xcode 5 release notes 确实说您可以像以前一样将文档存储在 DocSets 文件夹中。

在线开发人员库的导航量仍然很少。在离线文档方面，Apple 提供的 .docset 文件在 Show Package Contents -> Contents/Resources/Documentation/navigation/index.html 中存储了相同的界面。如果您使用 Xcode 文档窗口上的“共享”按钮在网络浏览器中打开页面(我使用 Safari 的运气比使用 Chrome 31 好得多)，您可以单击左上角的 Mac/iOS 开发人员库链接网页的。在 Safari 中，这会打开一个 Finder 窗口，该窗口位于 DocSet 文件夹中的一个 DocSet 中。然后，您可以转到导航文件夹并打开 index.html(Safari 加载了这个，而 Chrome 则在旋转)以获得与在线库相同的界面。

希望旧的类别浏览得到重新实现(或者有人重新发现如何查看它)。与此同时，开始制作和使用书签(文章标题/部分旁边的灰色标志)可能会有所帮助，并使用文档窗口的左侧边栏浏览它们。主项目窗口的右侧边栏还有一个 Quick Help(带有波浪线的框)，可能会有用，Xcode 5 中的 Features 说它可以显示代码中的 Doxygen 或 HeaderDoc 样式的文档注释。