Benson Muite ha scritto: > On Wed, Jan 14, 2026, at 1:42 PM, Johnny Jazeix wrote: >> Hi, >> >> Since we restored docs.kde.org, I would like to propose to add a new >> item in the checklist [1] for new projects (rewording welcome if >> needed): >> - [ ] User documentation in docbook format should exist in a doc (or >> docs) folder > > Docbook is nice and can be converted to html for web or viewed > directly using desktop applications. Would authoring in other formats > and converting to Docbook also be allowed? For example Sphinx > uses ReStructured Text which can be converted to DocBook, TexInfo > can also be converted to DocBook.
Right now, the source format used by khelpcenter and docs.kde.org is docbook. A few bigger manual uses sphinx, (digikam, kdenlive, krita, kstars) but that require a specialized site and I would consider that an exception and not the rule for now. We also generate man pages from docbook, I would definitely rule out TexInfo. If/when we manage to pull enough work to support sphinx in kdoctools we can consider sphinix as regular, but not right now. -- Luigi
