From kde-core-devel  Mon Feb 21 09:40:30 2005
From: Andras Mantia <amantia () kde ! org>
Date: Mon, 21 Feb 2005 09:40:30 +0000
To: kde-core-devel
Subject: Re: Using Wiki for KDE (User/Devel) Documentation
Message-Id: <200502211140.35012.amantia () kde ! org>
X-MARC-Message: https://marc.info/?l=kde-core-devel&m=110897903109840
MIME-Version: 1
Content-Type: multipart/mixed; boundary="--nextPart20169714.BbRmqJsfXZ"

--nextPart20169714.BbRmqJsfXZ
Content-Type: text/plain;
  charset="iso-8859-2"
Content-Transfer-Encoding: quoted-printable
Content-Disposition: inline

On Monday 21 February 2005 11:01, Jaros=B3aw 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=20
our own handbook without having too much docbook writing experience.
=2D you can import the DTD for the docbook version what you use or you can=
=20
use the shipped docbook 4.2, kde-docbook 4.1.2 or kde-docbook 4.2=20
DTEPs. Both methods have pluses and minuses. The currently shipped=20
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=20
manually fine-tune and add the toolbars to it. This is solvable if I=20
publish the updated DTEP that can be downloaded easily via KNewStuff by=20
the users.
Some benefits (not complete):
=2D you will get autocompletion for tags, attributes, entities (both=20
external and inline defined)
=2D you will see only the possible tags valid at the current position=20
(it's easier to enter valid markup)
=2D help in having a well-balanced document with report of possible errors
=2D toolbars that one can use to insert common tags

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

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

Andras

=2D-=20
Quanta Plus developer - http://quanta.sourceforge.net
K Desktop Environment - http://www.kde.org

--nextPart20169714.BbRmqJsfXZ
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.5 (GNU/Linux)

iD8DBQBCGaySTQdfac6L/08RAuvYAKC4MR33EvNdgvx2Fn+QHw4RVrj4NACbBz3f
rK8w1zIzR90A4YJjE5GkPX8=
=4ozH
-----END PGP SIGNATURE-----

--nextPart20169714.BbRmqJsfXZ--