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)
