Help Files - Paragraph Id's

[Joel Madero]

On 08/13/2013 04:46 AM, Jan Holesovsky wrote:
> Hi Joel,
>
> Joel Madero píše v Po 12. 08. 2013 v 20:04 -0700:
>
>> 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? Does each new paragraph need one?
> Yes, and yes :-)  The below mentioned docu says:
>
> ----- 8< -----
> The id element contains a unique string used to identify the element for
> localization and referencing purposes. The ID must be unique within a
> help file so that referencing across files and relocating sections and
> paragraphs across files is possible.
>
> id="some_unique_value"
>
> All elements that can be embedded or have to be translated contain a
> mandatory id attribute: image, bookmark, paragraph, section, table,
> title, topic, and variable.
> ----- 8< -----
>
>> Do we have a developer
>> wiki for help files that describes all the weird stuff that happens in
>> these things?
> The
>
> http://www.openoffice.org/documentation/online_help/OOo2HelpAuthoring.pdf
>
> that Regina mentioned is the only documentation I am aware of - with
> Muthu, we based the internal help -> wikihelp conversion tool on that,
> with success :-) - so hopefully it will work for you.
>
> Regards,
> Kendy
>
Thanks :) Hopefully that helps - just going to use a random number 
generator to try to deal with this help file being lackluster.


Best,
Joel