Re: HelpAuthoring.oxt: An easy way to edit help files

Hi Kendy

Le 3 juil. 2015 20:16, "Jan Holesovsky" <kendy@collabora.com> a écrit :
> Hi Sophie,
>
> Sophie Gautier píše v Pá 03. 07. 2015 v 18:57 +0200:
>
> > Maybe we should merge the page you asked me to write some times ago
> > https://wiki.documentfoundation.org/HelpContent

So what should I do with that page? Delete or merge?
> > I've begin to write a simplified guide more complete than what I wrote
> > on the wiki
>
> Ah great - thanks! :-)

I'll work on it in August if there is some interest
> > There is also the two extra files that will help to locate the help
> > files to modify that we should decide where to put.
>
> No idea what they are for, can you explain?  The extension seems to work
> for me even without them, but I probably don't understand correctly how
> exactly are they supposed to be used.

The extensions doesn't need them. They were used by the help authors anb
have been available for l10n purpose.  As written in the wiki, one adds an
index of the help files named as they appear in the sources. The second one
add the tag IDs of the strings. These two files allow you to quickly locate
the files you want to work on as the help page displays the full path of
the file.
The ID let you know if it's an embedded paragraph, a link or a full text
and its type (section, text, title...), so the tag and the style you have
to use when writing with the .oxt/template
> > Also is the modified template on git?
>
> There is some template in the .oxt itself that Olivier modified I think,
> but best if you talk the details with him, he's done all the heavy
> lifting there :-)

Ok, the template I use works too, but I'll check with him.

Cheers
Sophie