Le Lundi 11 F?vrier 2002 12:08, Anders Lund a ?crit : > > So many docs are still untranslated in so many languages that it wouldn't > > change a lot of things. According to me, you could commit it. > > I am very glad to hear that. > > > But I would urge it gets proofread and the markup fixed before it gets > > committed. > > I use kate with the xml plugin to write the documentation, which in it self > makes the markup easy, as that plugin knows the DTD.
Yes, but there are "style" issue for which I think that Lauri wants to keep control on. A plugin doesn't know anything about KDE documentation style ;-) > And I do of cause run it through meinproc, and i spellcheck it, and i get > comments/suggestions from the kate list once in a while. > > What i would manily > like was some guide to the usage of the markup, things like examples and > so. I mainly look in the source of other manuals for that. There is some http://i18n.kde.org/doc/markup.html. > > What I do not understand is that we still have a doc for kwrite : is this > > still relevant ? > > There is another interresting question. > > As things changes in katepart, the kwrite documentation gets - it is - > outdated. > > Most of kwrite is the katepart editor, so maybe that chapter should be > shared? Menus are different though, and the configuration dialogs, though > some of that could be shared too maybe. How do i turn parts of the dosc > into sharable bits? Entities allow to share bits. xml2pot seems to have problems with such sharing when top-level element of the shared part is not a section or chapter, that's all. Members of the kde-i18n-doc team can help you out with that. > If that is posible, maintaining the kwrite manual would be a minor task. Think about existing translations of kwrite that could be reused for kate. Please see next message on this topic. > Other questions: > I have been looking for how to link to documentation for standrad dialogs > like the file dialog, the color picker, the keyboard shortcut editor etc, > but I haven't found any. Can that really be true? It's easy, we have an I/O slave for that. Just ask Coolo, he'll explain you. > I try to add QWhatsThis help in every sensible place in kate - dialogs, > nonstandard gui elements. This documentation in some cases should be equal > to the manual. Is there a way to link either way, which would make > maintaining both easier? Perharps we could have a single source for that. I CC this message to the kde-docbook mailing list who are extraction scripts experts ;-).
