Re: How to handle &...; tags in docmessages?

Albert Astals Cid <[email protected]> Tue, 24 Feb 2026 00:24:06 +0100
Newsgroups gmane.comp.kde.devel.internationalization-and-documentation
Message-ID <23013392.EfDdHjke4D@xps15>
El dissabte, 21 de febrer del 2026, a les 20:54:35 (Hora estàndard d’Europa 
central), Zayed Al-Saidi va escriure:
> Hi,
> 
> when I've started translating the docmessages, I found a lot of &...;
> tags. After I read more about them, I understand I should not
> translate them as they are DocBook Entities.
> 
> Then I found the customization file for DocBook, here:
> https://invent.kde.org/frameworks/kdoctools/-/tree/master/src/customization
> 
> I notice, there are no entities for application names there, like
> &kcharselect;  or &plasma;
> 
> However, all the application names are in general.entities
> https://invent.kde.org/frameworks/kdoctools/-/blob/master/src/customization/
> entities/general.entities
> 
> As my language is not written in English alphabets, How can I
> translate the names?

As far as I know nothing forces you to use the entities in the translation.

You can sust translate &kcharselect; to "Whatever You want"

Cheers,
  Albert

> 
> Your guidance is highly appreciated.
> 
> Regards,
> Zayed