From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org) by nuthatch.gentoo.org with esmtp (Exim 4.54) id 1Fd1pB-0000IC-Hr for garchives@archives.gentoo.org; Mon, 08 May 2006 09:14:41 +0000 Received: from robin.gentoo.org (localhost [127.0.0.1]) by robin.gentoo.org (8.13.6/8.13.6) with SMTP id k489EABj009009; Mon, 8 May 2006 09:14:10 GMT Received: from shadanakar.org ([213.219.250.128]) by robin.gentoo.org (8.13.6/8.13.6) with ESMTP id k489BkOn030507 for ; Mon, 8 May 2006 09:11:46 GMT Received: from armada (n44.cpms.ru [87.236.29.44]) by shadanakar.org (Postfix) with ESMTP id 6640B417F752 for ; Mon, 8 May 2006 13:11:46 +0400 (MSD) From: To: Subject: RE: [gentoo-dev] GuideXML editor, tidyGuide and Google SoC Date: Mon, 8 May 2006 13:09:14 +0400 Message-ID: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.2869 In-Reply-To: <445F078D.4020006@gentoo.org> Thread-Index: AcZyfcIgwjsxGJnLQtejrFwHc1XsuAAAGEkg X-Archives-Salt: 985462e2-4bec-4958-b03e-cd4e97832339 X-Archives-Hash: 336410f119214801cbc6e30fb11000fb > jackdark@gmail.com wrote: > achumakov@gentoo.org wrote: > > (snipped) > > Templates seem a bit . . . hackish. Mostly we also need > documentation writers to be/who are comfortable with working > with the XML code itself, tags and all. First of all, we need _documentation_ and _documentation writers, don't we? > WYSIWYG editors just don't strike me as a good idea for > working on docs. Plus someone would have to make extensions > to it every time another feature or three is added to > GuideXML, like neysx's recent code highlights. > So, the template is the way: any good XML editor with a template behaves well when the doc doesn't fit template: it just switches to raw mode ;-) Afaicr, making extension to 100-200 lines of template is still far easier than patching a brand-new WYSIWYG editor, too. > As long as users can use a plain text editor (gedit, leafpad, > mousepad, bluefish, etc.), all they have to do (besides > validating it with xmllint before > committing) is run it through YosWink's repodoc [1], a > thorough GuideXML QA checker. How 'bout "Gentoo is about choice"? > > No need for big heavy editors like OOo and lots of extra > plugins/templates/etc. :) > OOo etc could make editing more productive for those not familiar with XML odds - just imagine why translation of Gentoo doc is so slow and weak? > Still, if this gets off the ground, I'll give it a test > drive. I'm not big on WYSIWYG, but I'll try it out. Thank you anyway. --achumakov -- gentoo-dev@gentoo.org mailing list