From kde-i18n-doc Wed Oct 20 07:08:13 2010 From: Burkhard =?iso-8859-15?q?L=FCck?= Date: Wed, 20 Oct 2010 07:08:13 +0000 To: kde-i18n-doc Subject: Re: kdebase-runtime/glossary doc cheats the DTD Message-Id: <201010200908.14225.lueck () hube-lueck ! de> X-MARC-Message: https://marc.info/?l=kde-i18n-doc&m=128755867300316 Am Mittwoch, 20. Oktober 2010, um 08:06:46 schrieb Federico Zenith: > In data mercoledì 20 ottobre 2010 06:04:14, Yuri Chornoivan ha scritto: > > Yes this markup is a bit ugly, but usual XML markup you have proposed > > does not work for glossaries. If we use the usual markup it will be > > stripped during glossary generation. > > > > We have tried to find the solution, but nobody proposed one. The current > > markup is the only way to solve the problem at the moment. > > If docbook is not a suitable format, and if the glossary is meant only to > be used in KHelpCenter as Burkhard's mail implies, shouldn't the glossary > terms and texts be included in the KHelpCenter GUI files instead, so we > don't have to worry about working around the DTD? > The reason to use this ugly hack: * KHelpcenter has no maintainer, and I can't implement the glossary using text from GUI files * There are several people who can write/update docbooks * Documentation can be updated with every minor release -- Burkhard Lück