Question

我在一个文件夹中只使用一种语言为我的应用创建了帮助，但它确实有效。我已经尝试过本地化这个内容并且未能添加西班牙语翻译。

我对Apples Guide to creating a help book的理解是我需要创建一个.help包来实现本地化。我已经这样做了，但是我收到一条错误消息“所选主题目前无法使用。”有几次我认为它有效，但它只是展示了我所拥有的预先本地化的内容。 Emptying the help viewer cache似乎停止了这一点，但后来又回到了获取不可用内容错误消息。

在我的应用程序的AppName-Info.plist文件中，我有以下与帮助相关的条目：

<key>CFBundleHelpBookFolder</key>
<string>AppName.help</string>
<key>CFBundleHelpBookName</key>
<string>garsonix.appname.help</string>

我的AppName.help文件具有以下结构：

AppName.help
    Contents
        Info.plist
        Resources
            English.lproj
                index.html
                search.helpindex
            Spanish.lproj
                index.html
                search.helpindex
            shrd
                logo.png

AppName.help中的Info.plist文件具有以下键：

<key>CFBundleDevelopmentRegion</key>
<string>en_GB</string>
<key>CFBundleIdentifier</key>
<string>garsonix.appname.help</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>AppName</string>
<key>CFBundlePackageType</key>
<string>BNDL</string>
<key>CFBundleShortVersionString</key>
<string>1.13</string>
<key>CFBundleSignature</key>
<string>hbwr</string>
<key>CFBundleVersion</key>
<string>1.13</string>
<key>HPDBookAccessPath</key>
<string>index.html</string>
<key>HPDBookIconPath</key>
<string>shrd/logo.png</string>
<key>HPDBookKBProduct</key>
<string>GAppName</string>
<key>HPDBookKBURL</key>
<string>http://www.garsonix.co.uk/</string>
<key>HPDBookRemoteURL</key>
<string>http://www.garsonix.co.uk/</string>
<key>HPDBookTitle</key>
<string>AppName Help</string>
<key>HPDBookType</key>
<string>3</string>
<key>HPDBookIndexPath</key>
<string>search.helpindex</string>

有谁知道我做错了什么，或者知道制作.help文件的好教程？

Answer 1

我终于有了这个工作，但我不得不放弃.help文件格式。

我保留了旧的简单帮助文件夹，我为每种语言复制了该文件夹。然后将每个帮助文件夹与本地化的nib文件一起放入主应用程序包的现有本地化文件夹中。

我发现本文中的说明非常有用： https://web.archive.org/web/20150421040211/https://www.icalamus.net/ioda/howto_applehelpbook.php?lan=en

我仍然想知道如何使.help格式正常工作，但这解决了我的问题并且看起来更简单。唯一的缺点是无法共享资源，如不需要本地化的图像。

Answer 2

在本地化帮助手册资源后，您应该本地化一些Info.plist密钥。

密钥CFBundleName和HPDBookTitle应使用InfoPlist.strings文件进行本地化。

创建本地化的mac帮助手册文件（.help）

2 个答案: