Help Files - Paragraph Id's

[Regina Henschel]

Hi Joel,

Joel Madero schrieb:
> Hi All,
>
> Trying to tackle the help issue on the MAB list
> https://bugs.freedesktop.org/show_bug.cgi?id=55618 but the paragraph
> id's are apparently something special that I can't figure out. Are these
> numbers random?

When the code was maintained by SUN a special tool was used to generate 
all these numbers. But I don't know details.

  Does each new paragraph need one?

Yes. From a technical point of view, they only need to be unique inside 
the file. But you can search for these IDs in Pootle. Therefore it would 
be no good idea to use 1, 2, 3 ... in every file.

  Do we have a developer
> wiki for help files that describes all the weird stuff that happens in
> these things?

I don't know such page. But perhaps you start one? A kind of FAQ? You 
write your question whenever you have one and we can then try not only 
to answer it here, but collect these answers in the Wiki?

I have written some help, but I'm no expert in this area.

Do you know already "Understanding and Authoring OpenOffice 2.0 Online 
Help" [1]?

>
> I know the file that needs updated:
> http://opengrok.libreoffice.org/xref/help/source/text/scalc/01/05120000.xhp
>
> and Sophie has been kind enough to translate the awesome French work so
> the text is ready to plant there:
> https://bugs.freedesktop.org/attachment.cgi?id=83380
>
> but I need help as I've never dealt with these help files before.
>
> Any help appreciated - or of course if someone wants to take this off my
> plate, I wouldn't complain ;)

Kind regards
Regina

[1] 
http://www.openoffice.org/documentation/online_help/OOo2HelpAuthoring.pdf