[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-i18n-doc
Subject:    Re: Generating docs for kdeextragear
From:       Nicolas Goutte <nicolasg () snafu ! de>
Date:       2005-06-20 23:28:05
Message-ID: 200506210124.40592.nicolasg () snafu ! de
[Download RAW message or body]

On Tuesday 21 June 2005 00:17, Krzysztof Lichota wrote:
> Sebastian Trueg (author of K3b) reported that docs for my language
> (Polish) cannot be compiled (i.e. index.cache created) on some systems.
> This is, as I understand, due to missing proper entities in kdelibs 3.2
> (they are part of kdelibs/kdoctools).
>
> This is general problem with docs I have already reported many times
> (showing more clearly with kdeextragear apps, as they support many
> kdelibs) - entities should be part of i18n module, so that they can be
> compiled together with docs.
>
> I think that expanding entites during generation of docs would solve the
> problem as there would be no external entities, but as far as I can see
> meinproc is not able to do so.

It depends what you called "generation".

If you mean "writing docs", then it means returning to the old KDE behaviour, 
when there were no entities in docbooks.

If you mean "compiling", that is the time point when 
kdelibs's entities are needed. (Once the doc is transformed into HTML, there 
are no other entities than at most the HTML ones.)

>
> Any other ideas what to do with this problem?

Personally I would have two ideas:

- write again author names, emails etc in full instead of using an entity for 
such critical docs. (However this is also again going back to the old KDE 
behaviour.)

- the translation should have the possibility to 
manipulate the !DOCTYPE, so that translators can add entities there. (As far 
as I know, this is not possible currently.)

>
> Regards

Have a nice day!

>
> 	Krzysztof Lichota (Polish team)

[prev in list] [next in list] [prev in thread] [next in thread]