Hi Brad,
FWIW I began using XMLMind to create and update entries in the ZF
documentation.
It had a tendency to mash existing code examples (e.g. converting all
< to < and removing CDATA instructions) and muck around with every
single line re: whitespace. In turn this meant the documentation guys
had real trouble determining what had been changed, as the change logs
showed that every line was updated, thus drawing out the process.
As an editor it's brilliant - I use it a lot for other projects. Maybe
the paid-for version allows more fine-grained control over the output,
but for now I'll stick with hand-coding when it comes to ZF updates.
Cheers
Matt,
Sorry about continuing an OT discussion, but I'm curious what you
mean when you say the XML from XMLmind XML Editor (XXE) wasn't "good
enough?" My experience with XXE has been that the XML was perfectly
valid, well formatted in respect to whitespace, and met the DocBook
specs. I find it surprising that it's quicker for you to copy-and-
paste from Microsoft Word than it is to just use a structured
content editing tool like XXE from the beginning. In my
understanding, the whole point of structured content is that you're
considering both content and structure at the same time.
On Thu, Jul 31, 2008 at 2:39 PM, Matthew Ratzloff <[EMAIL PROTECTED]
> wrote:
Microsoft Word, and then translated into DocBook by hand. This is
the quickest way for me that I've found. The first part I worry
about the content. Only then do I worry about the semantics and
formatting.
I tried using XMLmind's editor once for client documentation at
work. I dumped it. The XML it produces just wasn't good enough.
-Matt
On Thu, Jul 31, 2008 at 6:41 AM, Keith Pope <[EMAIL PROTECTED]>
wrote:
Hey guys,
Do you use a docbook editor for writing the zf docs? If so whats a
good editor to use?
Thx
Keith Pope
--
allpay.net Limited, Fortis et Fides, Whitestone Business Park,
Whitestone, Hereford, HR1 3SE. Registered in England No. 02933191.
UK VAT Reg. No. 666 9148 88.
Telephone: 0870 243 3434, Fax: 0870 243 6041.
Website: www.allpay.net Email: [EMAIL PROTECTED]
This email, and any files transmitted with it, is confidential and
intended solely for the use of the individual or entity to whom it
is addressed. If you have received this email in error please notify
the allpay.net Information Security Manager at the number above.
--
Bradley Holt
[EMAIL PROTECTED]
--
Simon Mundy | Director | PEPTOLAB
""" " "" """""" "" "" """"""" " "" """"" " """"" " """""" "" "
202/258 Flinders Lane | Melbourne | Victoria | Australia | 3000
Voice +61 (0) 3 9654 4324 | Mobile 0438 046 061 | Fax +61 (0) 3 9654
4124
http://www.peptolab.com