Re: Help implementation - PC lacks GSHelpContentsFile key in Info.plist

Hi Riccardo,
Hello All,

I complete my previous message with 5th step: Help I18N...

On 2026-03-15 16:01:03 +0100 Patrick CARDONA <[email protected]> 
wrote:

> Hello Riccardo,
> Hello All,
> 
> Well, studiing StepSync code, I think I got the steps to get an 
> '.help' 
> bundle to display as expected from the 'Help...' menuItem:
> 
> - (1) Put the 'MyApp.help' bundle into the 'Resources' folder.
> 
> - (2) In ProjectCenter: add 'MyApp.help' into 'Other Resources'
>    This should generate the expected line in GNUmakefile:
>> MyApp_RESOURCES_FILES = \
>> ...
>> Resources/MyApp.help
> 
> - (3) In the interface (let say 'MyApp.gorm'): bind the 'Help...' 
> menuItem to 
> 'NSFirst' instance, and choose action: 'orderFrontHelpPanel' to 
> connect to. 
> Save modified interface.
> 
> - (4) In the Inspector/Properties of the Project, type 'MyApp.help' 
> in the 
> 'help' textField'...
> This should generate the expectedline in 'MyAppInfo.plist':
>> GSHelpContentsFile = "MyApp.help";
> BUT it DOES NOT: I think it is another issue in the Inspector Panel 
> (see our 
> previous talk about Icon path)
> 
> So You must register the project, close PC, and manually edit 
> '...Info.plist' 
> to add  the above line.
> 
> When all 4 steps are done, after You rebuild the app, .help bundle is 
> displayed within HelpViewer (required) as expected from 'Help...' 
> menuItem.
> 
> Well, this offer now perspectives to provide each app a decent Help 
> resource.
> 
> Additional question: what about localized .help bundle? Just a 
> duplicate 
> 'MyApp.help' in each 'Language.lproj' folder? Must test this.

Well, this is the 5th step to provide Help I18N:
- (5) Just create your language folder project:
By Example: 'French.lproj'

Then, put in this folder:
- Translated interface: MyApp.gorm (with French Localizable strings)
- Translated Help: MyApp.help

In GNUmakefile, do not forget to add the needed lines for these 
resources:
> MyApp_RESOURCE_FILES = \
> ... \
> French.lproj/MyApp.gorm \
> French.lproj/MyApp.help

Successfully tested with my app SaveLink.

Cheers,
Patrick

-- 
Patrick Cardona - Pi500 - GNU/Linux aarch64 (Debian 13.4)
Xorg (1:7.7+24) - libcairo2 (1.18.4-1+rpt1 arm64) - Window Maker 
(0.96.0-4)
GWorkspace (1.1.0 - 02 2025) - Theme: AGNOSTEP - Classic - MUA: 
GNUMail (1.4.0 - rev.947)