From owner-freebsd-doc@FreeBSD.ORG Mon May 5 22:05:49 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 DD10F106566C for ; Mon, 5 May 2008 22:05:49 +0000 (UTC) (envelope-from fbsdlists@gmail.com) Received: from rv-out-0506.google.com (rv-out-0506.google.com [209.85.198.224]) by mx1.freebsd.org (Postfix) with ESMTP id B81B38FC1A for ; Mon, 5 May 2008 22:05:49 +0000 (UTC) (envelope-from fbsdlists@gmail.com) Received: by rv-out-0506.google.com with SMTP id b25so145799rvf.43 for ; Mon, 05 May 2008 15:05:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; bh=osyhnB2LritAtbYRa+vmuas7oQuLZXTld8qsm198tAw=; b=wA/2zU+S3bRo871laN8JkDtYcSiRchsz3zkHInzoAg42wkR4MxIK5fLye6Gu4kpckoHqSFUAbQ1MMrBIdECqAPo2fJ2bfRx7aq1aE5WDjntPcfVz73Nh7lucnAm5Q927e26Pqh1UjpHlQyTowoqamrnMx1drlKIfSSWWfrOCvPY= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=UEhQrs92wovImTp7+AwhWwrPzSOnDljE+TIJ00MWqFiIrkdrQ2h7a3/HaT7UlvD02R9TSJQ2O0SYmqLL/OMbjnl1i9LJNkR7K0zlm0BO8L+sy5uvBG22h9kcetKUIDc+vJKY3cMBME70nQ90KXpjLBX1xZbaOc/ggAXTlj/eDis= Received: by 10.140.202.12 with SMTP id z12mr3031516rvf.186.1210023528500; Mon, 05 May 2008 14:38:48 -0700 (PDT) Received: by 10.141.13.15 with HTTP; Mon, 5 May 2008 14:38:48 -0700 (PDT) Message-ID: <54db43990805051438y7e1dec70ya85d325dae769566@mail.gmail.com> Date: Mon, 5 May 2008 17:38:48 -0400 From: "Bob Johnson" 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 22:05:49 -0000 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