Re: Authoring Tools WAS: Switching to XML - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Authoring Tools WAS: Switching to XML
Date
Msg-id 200612131714.kBDHEI800289@momjian.us
Whole thread Raw
In response to Re: Authoring Tools WAS: Switching to XML  (Peter Eisentraut <peter_e@gmx.net>)
Responses Re: Authoring Tools WAS: Switching to XML  (Josh Berkus <josh@agliodbs.com>)
List pgsql-docs
I have read the two long XML threads, and see these issues for
converting to XML:

o authoring, in two parts:

    o WYSIWYG - this seems unattainable because such editors are
      going to modify the surrounding XML, which will affect
      hand-edited changes

    o tag assistance - this seems possible, e.g. tag completion,
      drop down list of tags available for this section

o output generation - the XML toolchain is more widely used, but Tom has
  fixed the performance issue we have had for years.  The fact that the
  tool maintainers were unable to fix it themselves reflects badly on
  their maintenance of this toolchain.

o translation - does XML have better tools to assist in translating our
  manuals, and is this better than outputting XML via our makefile?

It would be nice to use htmltidy to clean up the xml before each
release, but I wonder whether it understand the tags well enough to
provide better formatting than we do now manually.

Tom, I think we need that SGML patch placed on our ftp site and a
reference to it made in our documentation.  I can do it of you want.

--
  Bruce Momjian   bruce@momjian.us
  EnterpriseDB    http://www.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Switching to XML
Next
From: Josh Berkus
Date:
Subject: Re: Authoring Tools WAS: Switching to XML