From owner-freebsd-doc@FreeBSD.ORG Tue May 6 01:12:26 2008 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 42A83106566B for ; Tue, 6 May 2008 01:12:26 +0000 (UTC) (envelope-from freebsd-doc@m.gmane.org) Received: from ciao.gmane.org (main.gmane.org [80.91.229.2]) by mx1.freebsd.org (Postfix) with ESMTP id 054178FC21 for ; Tue, 6 May 2008 01:12:25 +0000 (UTC) (envelope-from freebsd-doc@m.gmane.org) Received: from list by ciao.gmane.org with local (Exim 4.43) id 1JtBjB-00065u-KC for freebsd-doc@freebsd.org; Tue, 06 May 2008 01:12:21 +0000 Received: from ip68-1-149-71.mc.at.cox.net ([68.1.149.71]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 06 May 2008 01:12:21 +0000 Received: from jvk-list by ip68-1-149-71.mc.at.cox.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 06 May 2008 01:12:21 +0000 X-Injected-Via-Gmane: http://gmane.org/ To: freebsd-doc@freebsd.org From: Joe Kraft Date: Mon, 05 May 2008 21:15:56 -0400 Lines: 39 Message-ID: References: <54db43990805051438y7e1dec70ya85d325dae769566@mail.gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7Bit X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: ip68-1-149-71.mc.at.cox.net User-Agent: KNode/0.10.5 Sender: news Subject: Re: WYSIWYG editor for DocBook? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: jvk-list@thekrafts.org List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 06 May 2008 01:12:26 -0000 Bob Johnson wrote: > On 5/5/08, Joe Kraft wrote: > [...] >> On the topic of editors, I'm wondering if there is a good editor that >> will >> show a final-ish product based on the tags. Perferably one that would >> allow me to look at the tags directly also, but basically something that >> I could just select the style I want it to come out in. >> > [...] > > By definition, you almost cannot have a WYSIWYG editor for DocBook, > because the final output depends on what medium (and what stylesheets) > you create the final output for (and with). > > But I understand that's not exactly what you meant. When I worked with > DocBook, it was pretty easy to set up a tool chain that quickly built > output in various formats (HTML, RTF, etc.) so I could easily look at > the results. And if I had bothered to used 'make' it probably would > have been even easier (but that assumes you already have some comfort > with 'make'). Not quite the real-time display implied by "WYSIWYG", > but I found it entirely adequate. > > It helps to use an editor that understands DocBook and won't let you > do anything not legal (and even better, offers a list of legal > choices when asked). I mostly used KATE (in KDE), but it doesn't do > much -- you can do better. > > Also be aware of whether any tools you are considering are designed > for SGML DocBook, or XML DocBook. > > - Bob Appreciate your insight and Murray's as well. I guess I'll jump in with one of the text editors and hope for the best. Thanks, Joe.