=D1=81=D1=83=D0=B1=D0=BE=D1=82=D0=B0, 27 =D1=81=D1=96=D1=87=D0=BD=D1=8F 202=
4 =D1=80. 20:10:05 EET Mincho Kondarev =D0=BD=D0=B0=D0=BF=D0=B8=D1=81=D0=B0=
=D0=BD=D0=BE:
> Hi,
> I am translating some documentation files from=20
> l10n-kf5/templates/docmessages, creating the corresponding po file for my
> language in l10n-kf5/bg/docmessages local on my machine. But before
> committing them, I would like to make a preview as html file.
> I have read the instruction for translating of documentations and  I did =
not
> understand something, or the instructions are outdated.
> According to the manual those steps are necessary:
> 1. translate po file in docmessages for corresponding program
> 2. create the docbook files using -  po2xml english-XML translated-PO
> 3. make the screenshot for the localized version of the interface
>=20
> And the problems I encountered:
> i can not find the l10n-kf5/documentation/PACKAGE/doc/, instead I used the
> doc/ *.docbook from the package itself to create the translated docbook
> files. Then I use meinproc5 to generate the preview in html, but I can't
> complete that perhaps due to  missing entities. I suppose this is because=
=20
> I didn't  translated all of the docbooks.
> Is there an option to make html file from a single docbook file?
> When  I finish the translations and png files how to commit them? With po
> files I will use the svn as usually , but for docbook and png?
>=20
> With regards

Hi,

1. Actually, the docs recommend to use update_xml script from l10n-scripty=
=20
like this (just an example):

SCRIPTY_I18N_BRANCH=3Dtrunk_kf5 ./l10n-scripty/update_xml bg kalarm

And you are right. It can be done step by step with po2xml, but it's not th=
e=20
optimal way.

2. Sure, the entities should be added/fixed beforehand. First you can add/t=
est=20
them locally in=20

/usr/share/kf5/kdoctools/customization/bg

then fix them in the repo

https://invent.kde.org/frameworks/kdoctools/-/tree/master/src/customization/
bg?ref_type=3Dheads

Hope this helps.

Best regards,
Yuri