<div dir="ltr"><div dir="ltr">On Thu, Jan 15, 2026 at 12:35 AM Luigi Toscano <<a href="mailto:luigi.toscano@tiscali.it">luigi.toscano@tiscali.it</a>> wrote:</div><div class="gmail_quote gmail_quote_container"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Benson Muite ha scritto:<br>
> On Wed, Jan 14, 2026, at 1:42 PM, Johnny Jazeix wrote:<br>
>> Hi,<br>
>><br>
>> Since we restored <a href="http://docs.kde.org" rel="noreferrer" target="_blank">docs.kde.org</a>, I would like to propose to add a new<br>
>> item in the checklist [1] for new projects (rewording welcome if<br>
>> needed):<br>
>> - [ ] User documentation in docbook format should exist in a doc (or<br>
>> docs) folder<br>
> <br>
> Docbook is nice and can be converted to html for web or viewed<br>
> directly using desktop applications.  Would authoring in other formats<br>
> and converting to Docbook also be allowed? For example Sphinx<br>
> uses ReStructured Text which can be converted to DocBook, TexInfo<br>
> can also be converted to DocBook.<br>
<br>
Right now, the source format used by khelpcenter and <a href="http://docs.kde.org" rel="noreferrer" target="_blank">docs.kde.org</a> is docbook.<br>
A few bigger manual uses sphinx, (digikam, kdenlive, krita, kstars) but that<br>
require a specialized site and I would consider that an exception and not the<br>
rule for now.<br></blockquote><div><br></div><div>Sphinx is not ideal for a number of reasons - as the more translated strings a Sphinx site has the slower the build process goes, and by quite a significant margin.</div><div>It takes about 1 hour 20 minutes to generate the Kdenlive documentation for instance (while just untranslated English is only a couple of minutes, and it only handles 12 other languages in those 80 minutes).</div><div><br></div><div>So before we can support Sphinx, we would have to re-work / re-write it's translation support completely to make it scalable.</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
We also generate man pages from docbook, I would definitely rule out TexInfo.<br>
If/when we manage to pull enough work to support sphinx in kdoctools we can<br>
consider sphinix as regular, but not right now.<br>
<br>
<br>
-- <br>
Luigi<br></blockquote><div><br></div><div>Cheers,</div><div>Ben </div></div></div>