How to compile docmessages to docs

[Luigi Toscano]

Yuri Chornoivan ha scritto:
> Hi,
> 
> Please read some answers below.
> 
> вівторок, 24 вересня 2024 р. 17:54:52 EEST Matjaž Jeran написано:
>> I am in the process of compiling Plasma docmessages into docs from .po files
>> to .docbooks.
>>
>> I use adapted French script for Slovenian. I have some success and some
>> problems with these scripts. More than 100 applications have been
>> successfully compiled to docbook. There are two groups of issues:
>>
>> 1.
>> About a dozen apps have common diagnostics of some sort  undefined &abbrev;
>>
>> such as
>> index.docbook:243: element interface: validity error : Element interface is
>> not declared in interface list of possible children &fundamentals-chapter;
>>
>> where &abbrev; for Plasma6 is from this list:
>> &underFDL; &kmail-configure; &fundamentals-chapter; &reporting.bugs;
>>
>> where &abbrev; for Plasma5 is from this list:
>> # &LMB; &RMB; &etc; &ie; &Backspace; &Enter; &kde-frameworks;
>>
>> I suspect that the scripts must have some config file somewhere, where these
>> abbreviations are defined (maybe incomplete?). Can anybody help?
> 
> Should be here. Just replace the file in your system.
> 
> https://invent.kde.org/frameworks/kdoctools/-/blob/master/src/customization/
> sl/user.entities?ref_type=heads

Unfortunately that's not enough: the entities need to be part of a released
version of Frameworks, and the application that uses it must depend on that
version of Frameworks. Given the fact that KF5 is basically in frozen state
and it is unlikely that KF5 applications are going to bump their KF5
requirements, I had to remove the documentation you generated in the stable
KF5 branch. I'm sorry but at this point please don't generate them anymore on
any KF5 branch.
The alternative path for those branches would be to not use the new entities
in your translation.

-- 
Luigi