From owner-freebsd-doc@FreeBSD.ORG Mon May 5 15:48:55 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 88E9D106566C for ; Mon, 5 May 2008 15:48:55 +0000 (UTC) (envelope-from murray@stokely.org) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.174]) by mx1.freebsd.org (Postfix) with ESMTP id 1DF008FC20 for ; Mon, 5 May 2008 15:48:54 +0000 (UTC) (envelope-from murray@stokely.org) Received: by ug-out-1314.google.com with SMTP id q2so73189uge.37 for ; Mon, 05 May 2008 08:48:53 -0700 (PDT) Received: by 10.66.221.18 with SMTP id t18mr4643078ugg.80.1210002531033; Mon, 05 May 2008 08:48:51 -0700 (PDT) Received: by 10.67.20.17 with HTTP; Mon, 5 May 2008 08:48:50 -0700 (PDT) Message-ID: <2a7894eb0805050848x5e52bfabjcb682cc30d006ed9@mail.gmail.com> Date: Mon, 5 May 2008 08:48:50 -0700 From: "Murray Stokely" To: jvk-list@thekrafts.org In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: Cc: freebsd-doc@freebsd.org Subject: Re: WYSIWYG editor for DocBook? X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 05 May 2008 15:48:55 -0000 On Sun, May 4, 2008 at 9:31 PM, Joe Kraft wrote: > I'm looking to break into the documentation writing/maintaining area and > have been looking through the recommended tools to do that. I figure the > best way to break into it is to start writing some stuff for myself to > document how I maintain my system and such. I'd like to do it in the same > style as the FreeBSD documentation to build up my comfort levels before > working with the real docs. > > 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. > > Way back when I was writing HTML, I used an editor called HotDog which had > similar features and I kind of liked that way of working. > > Any thoughts, recommendations? I've never used a WYSIWYG editor for DocBook, but I have found psgml with emacs to be an enormous timesaver. Even if all you ever use is its keyboard shortcut to close the current tag you'll save an enormous amount of typing. It also fully understands the DTD so will only allow elements or attributes that make sense in the current part of the document. There are some commercial editors for XML that might be worth investigating. - Murray