Using Wiki for KDE (User/Devel) Documentation

[Andras Mantia]

On Monday 21 February 2005 11:01, Jarosław Staniek wrote:
> Yeah, people are not volunteering. But AFAIK, there are a number of
> people who refuse to voluneer if the tools are harder than they can
> accept.

[Self-advertising follows]

Quanta (from CVS) has quite good docbook support. I was able to update 
our own handbook without having too much docbook writing experience.
- you can import the DTD for the docbook version what you use or you can 
use the shipped docbook 4.2, kde-docbook 4.1.2 or kde-docbook 4.2 
DTEPs. Both methods have pluses and minuses. The currently shipped 
version does not include the entities and may miss some newer things.
If you import one it will have the latest entities, but you have to 
manually fine-tune and add the toolbars to it. This is solvable if I 
publish the updated DTEP that can be downloaded easily via KNewStuff by 
the users.
Some benefits (not complete):
- you will get autocompletion for tags, attributes, entities (both 
external and inline defined)
- you will see only the possible tags valid at the current position 
(it's easier to enter valid markup)
- help in having a well-balanced document with report of possible errors
- toolbars that one can use to insert common tags

Unfortunately you still cannot import the updated entities only (from 
the GUI), but you can import again the new DTD into a different place 
and use the (new) entities.tag from there. Of course, you can hand edit 
that file if you want. ;-)

Anyway, if anybody wants to use Quanta for documentation writing, I'm 
happy to assist and help him/she. 

Andras

-- 
Quanta Plus developer - http://quanta.sourceforge.net
K Desktop Environment - http://www.kde.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20050221/603c2471/attachment.sig>
-------------- next part --------------
 
>> Visit http://mail.kde.org/mailman/listinfo/kde-devel#unsub to unsubscribe <<