[libreoffice-documentation] Are id attributes needed on paragraphs and headings in .xhp help files?

l10n
#1

Hi Regina,

Regina Henschel píše v St 07. 10. 2015 v 15:33 +0200:

the doctype definition xmlhelp.dtd makes the id attribute of type
REQUIRED in all cases. It is needed surely for sections and variables,
because they are embedded elsewhere and need to be referenced.

But is the id attribute needed for headings and paragraphs too? There
exists already some files having paragraphs without an id attribute, and
the files in the delivered .jar archives have stripped the attribute
too. But I do not know whether processes exists, that need it. What
about translation, or transformation to the Wikihelp, or the help
compiler itself, or while generating the .jar files?

If the id attribute is not needed, then the authoring tools can do
without generating id values.

Sorry for the late answer. From what I know, the paragraph ID's are not
necessary for wikihelp, and I doubt they are necessary for the help
compiler.

Let me add the l10n team to see if they are necessary for the
translations... Are they?

If not - then I'd remove them from the tooling, dtd, and from the help
repository too, to reduce the noise there :slight_smile:

Thank you,
Kendy

#2

Hi Kendy

I think the paragraph ID are necessary to connect 1-to-1 the paragraph
to the string entry in the po file of the translation system.

I once changed all the ID's of a help page I was improving and the
translation of the changed paragraphs in that page turned to fuzzy state.

Regards

Olivier