如何本地化 Apple 帮助手册答案

【问题标题】：How to localise an Apple help book如何本地化 Apple 帮助手册
【发布时间】：2015-12-21 10:18:41
【问题描述】：

我为我的 cocoa 应用程序构建了一本帮助手册，并将其注册到我的 Info.plist 文件中。

这本书打开了，但我无法打开本地化版本。

这些是我的目录的内容：

Contents/
    Info.plist
    PkfInfo
    Resources/
        en.lproj/
            index.html
            InfoPlist.strings
            locale-info.json
        index.html
        shrd/
    version.plist

当我打开帮助手册时，资源文件夹中的索引已加载，而不是 en.lproj 中的索引。当我删除“全局”索引时，我得到一个“所选主题当前不可用”。错误。

如何正确本地化帮助手册？

更新：我发现一种方法是将 .help 包复制到我的应用程序的语言文件夹中，但是我有 8 个不同的 .help 包。这是正确的方法吗？我必须复制所有共享的图像，并且试图维护帮助手册会很糟糕。

【问题讨论】：

标签： macos cocoa localization

【解决方案1】：

根据Mac Developer Libary：

对于您支持的每种语言，您必须在帮助包的 Resources 目录内的其自己的资源子目录中提供完整的本地化帮助手册（请参阅组织帮助手册包）。

帮助手册的每个本地化版本都必须在帮助包的 InfoPlist.strings 文件中有一个本地化的书名。

关于共享图片，你可以把它们放在 Resources/shrd 目录下，这样引用：

HTML 标记中对 shrd/ 文件夹中艺术品的文件路径引用应如下所示：

在 .html 页面上：
../shrd/artworkname.jpg
在 pgs/ 或其他文件夹中的内容页面上：
../../shrd/artworkname.jpg

【讨论】：

【解决方案2】：

你解决了吗？

有一个可用的应用程序可让您以多种语言创作内容，然后如果您不想搞砸，可以为您生成捆绑包：http://www.putercraft.com。

但是，要回答这个问题，您不需要复制您的帮助包。也许您的帮助包的 Info.plist 缺少一个键？例如，您是否设置了 CFBundleDevelopmentRegion？我发现某些版本的帮助查看器对 plist 很挑剔 - 您应该查看另一个应用程序中的有效帮助包，并确保您设置了所有相同的键。

我的（工作）帮助包具有以下一般结构：

Contents
    Resources
    Info.plist
    images
    en.lproj
        help.helpindex (for english)
        <html content>
        InfoPlist.strings (english title)
    fr.lproj
        help.helpindex (for french)
        <html content>
        InfoPlist.strings (french title)

【讨论】：

我按照这个文件夹结构，但是非英文内容没有显示。