[Po4a-devel] Problems with Docbook/Xml module

[Nicolas François]

On Sat, Oct 22, 2005 at 01:30:02PM +0200, thomas.huriaux at kti.ae.poznan.pl wrote:
> Nicolas François <nicolas.francois at centraliens.net> (21/10/2005):
> > On Fri, Oct 21, 2005 at 12:06:06PM +0200, thomas.huriaux at kti.ae.poznan.pl wrote:
> > > I'm currently trying to use po4a for the aptitude documentation, and
> > > here are the few problems I have:
> > > * if there is a comment in a sentence such as
> > >          In the <!-- TODO: <link linkend='secHier'>
> > >          -->hierarchy editor, stores the hierarchy location
> > >   then the result will be:
> > >          msgid "In the"
> > > 	 msgstr ""
> > > 
> > > 	 msgid "hierarchy editor, stores the hierarchy location"
> > > 	 msgstr ""
> > 
> > Can anyone check the attached patch?
> > It makes the comments non-breaking, and just removes them from the
> > paragraphs.
> 
> It works perfectly, at least for aptitude. Thanks.
> 
> > > * if there is a footnote, such as
> > > 	<para>
> > > 	  Begining of the sentence
> > > 	    <footnote><para>footnote text</para></footnote>
> > > 	  end of the sentence.
> > > 	</para>
> > >   then once again it will be divided into three strings:
> > >         msgid "Begining of the sentence"
> > > 	msgid "footnote text"
> > > 	msgid "end of the sentence."
> > > 
> > >   I'm afraid that for this last problem, there is no easy solution and
> > >   we will have to keep the current situation.
> > 
> > There must be a way to indicate that the footnote tag should never be
> > separated from its paragraph.
> > 
> > However, it is not perfect (because you will want to extract the footnot
> > if it appear at the end of a paragraph).
> > 
> > The TeX module uses the following method: if the tag appears at the end of
> > a bloc, it is extracted, otherwise, we let the tag inlined in the
> > paragraph.
> 
> Do you intend to fix it before the next release? I'm waiting to know
> approximatly how the next release of po4a will be to ask Jean-Luc Coulon
> to update the French translation of the aptitude documentation in order
> to detect potential additional problems. It could be better if he works
> on a "stable" po file.

It's more complicated than expected: The problem is not with the <footnote>
tag (which is already in the inline category). The problem is caused by
the <para> tag, which impose the break in the footnote.

I don't know what can be done. Don't expect it in the next release.

Thus, with the following paragraph:
	<para>
	  Begining of the sentence
	    <footnote><para>footnote text</para></footnote>
	  end of the sentence.
	</para>

The following 3 messages are generated:
	msgid "Begining of the sentence <footnote>"
	msgid "footnote text"
	msgid "</footnote> end of the sentence."

Maybe we could do as in poxml (or xml2po, I don't remember). When they
encounter something like this, they use something like:

msgid "footnote text"
msgid "Begining of the sentence <placeholder -1/> end of the sentence."


Kind Regards,
-- 
Nekral