Hi Patrick,

Foreword:

Standard help system is in RTFD. So any GNUstep application gets by default a simple RTF/RTFD display. Crude but simple: add the RTF. Just configuration of resources, makefile and it works. Secondly, work is ongoing, (actually completed in git) where one can use HelpViewer and help files - looks neat. But HelpViewer still needs work to properly handle chapter/subchapter navigation.

You can check in GWorkspace/Resources/English.lproj

On 2025-06-06 10:05:11 +0000 Patrick Cardona <[email protected]> wrote:

Hello,

Are already people working on this?

I don't know.

Or maybe you are waiting for a volunteer to write the new help?

Personally I am working on getting HelpViewer to a suitable state and transition to it, but it is taking long. I wanted to avoid creating full-help in RTF just to recreate it in HelpViewer later. It might be useful to write short one-two paghe chapters instead of an empty placeholders.



My guess:
Maybe we could use and extend the existent one from:
'GWorkspace User Guide' by Mr. Dennis Leeuw ?
Maybe with new screenshots (and so which theme to use?)

GNUstep of course :) :)

What is the document format wanted: only consistent with HelpViewer (chm, rtfd...)?

As said either RTFD or Help.
Ideally, one could i nthe meanwhile update Dennis' doc and then "translate" it once.

Maybe a single source to convert (with pandoc?) to several desired formats (man, chm, html...)?

well, currently RTF/RTFD and helpviewer format (XML style). So either you write an backend for pandoc for helpviewer or do it manually. I would go for the latter.

How to facilitate future translations ?

Help Resources are fully localizable, but still one for each desired language needs to be created. Right now, only English.

Riccardo


Reply via email to