Re: [fw-general] OT: Good Docbook Editor

[Matthew Ratzloff]

Thanks for posting that.  I might be willing to try it again with those
options.
-Matt

On Thu, Jul 31, 2008 at 11:11 PM, mikaelkael <[EMAIL PROTECTED]>wrote:

> Hi,
>
> I only use XXE for french translation.
>
> There is some configuration for XXE like:
> elements="address funcsynopsisinfo classsynopsisinfo
> literallayout programlisting screen synopsis" />
> or
>  
>
> The first one to maintain space in programlisting. And the second to use
> CDATA in programlisting instead of <.
>
> Mickael.
>
> Bradley Holt a écrit :
>
>> Simon,
>>
>> That's exactly what I was wondering - if XXE played well with the current
>> ZF doc setup (apparently it doesn't). I've only used it for documentation
>> that I created (but I have kept a close eye on the XML output and have been
>> happy with what I've seen). For non-programmers (or people who don't want to
>> hand-edit XML) its a really nice tool. We've been using it for
>> non-programmers to generate XHTML content since it focuses on structure
>> (WYSIWYM ), not presentation
>> (WYSIWYG). Too bad it doesn't play well with the ZF docs :-)
>>
>> Thanks,
>> Bradley
>>
>>
>> On Thu, Jul 31, 2008 at 5:27 PM, Simon Mundy <[EMAIL PROTECTED]> [EMAIL PROTECTED]>> wrote:
>>
>>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
>>
>>
>>
>>
>> --
>> Bradley Holt
>> [EMAIL PROTECTED] 
>>
>>
>
>

Re: [fw-general] OT: Good Docbook Editor

[mikaelkael]

Hi,

I only use XXE for french translation.

There is some configuration for XXE like:
 
or
 

The first one to maintain space in programlisting. And the second to use 
CDATA in programlisting instead of <.


Mickael.

Bradley Holt a écrit :

Simon,

That's exactly what I was wondering - if XXE played well with the 
current ZF doc setup (apparently it doesn't). I've only used it for 
documentation that I created (but I have kept a close eye on the XML 
output and have been happy with what I've seen). For non-programmers 
(or people who don't want to hand-edit XML) its a really nice tool. 
We've been using it for non-programmers to generate XHTML content 
since it focuses on structure (WYSIWYM 
), not presentation (WYSIWYG). 
Too bad it doesn't play well with the ZF docs :-)


Thanks,
Bradley

On Thu, Jul 31, 2008 at 5:27 PM, Simon Mundy <[EMAIL PROTECTED] 
> wrote:


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




--
Bradley Holt
[EMAIL PROTECTED] 

Re: [fw-general] OT: Good Docbook Editor

[Bradley Holt]

Simon,

That's exactly what I was wondering - if XXE played well with the current ZF
doc setup (apparently it doesn't). I've only used it for documentation that
I created (but I have kept a close eye on the XML output and have been happy
with what I've seen). For non-programmers (or people who don't want to
hand-edit XML) its a really nice tool. We've been using it for
non-programmers to generate XHTML content since it focuses on structure (
WYSIWYM ), not presentation (WYSIWYG).
Too bad it doesn't play well with the ZF docs :-)

Thanks,
Bradley

On Thu, Jul 31, 2008 at 5:27 PM, Simon Mundy <[EMAIL PROTECTED]>wrote:

> 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
>
>


-- 
Bradley Holt
[EMAIL PROTECTED]

Re: [fw-general] OT: Good Docbook Editor

[Simon Mundy]

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

Re: [fw-general] OT: Good Docbook Editor

[Bradley Holt]

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]

Re: [fw-general] OT: Good Docbook Editor

[Matthew Ratzloff]

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.netInformation 
> Security Manager at the number above.
>
>

RE: [fw-general] OT: Good Docbook Editor

[Keith Pope]

I was never very good with vi hehe :) Maybe its time to learn it...

- Original Message -
From: Matthew Weier O'Phinney <[EMAIL PROTECTED]>
Sent: Thu, 7/31/2008 2:59pm
To: fw-general@lists.zend.com
Subject: Re: [fw-general] OT: Good Docbook Editor

-- Keith Pope <[EMAIL PROTECTED]> wrote
(on Thursday, 31 July 2008, 02:41 PM +0100):
> Do you use a docbook editor for writing the zf docs? If so whats a good editor
> to use?

I use vim. It has good syntax highlighting, completes tags, and creates
end tags.

-- 
Matthew Weier O'Phinney
Software Architect   | [EMAIL PROTECTED]
Zend Framework   | http://framework.zend.com/
--

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.

Re: [fw-general] OT: Good Docbook Editor

[Matthew Weier O'Phinney]

-- Keith Pope <[EMAIL PROTECTED]> wrote
(on Thursday, 31 July 2008, 02:41 PM +0100):
> Do you use a docbook editor for writing the zf docs? If so whats a good editor
> to use?

I use vim. It has good syntax highlighting, completes tags, and creates
end tags.

-- 
Matthew Weier O'Phinney
Software Architect   | [EMAIL PROTECTED]
Zend Framework   | http://framework.zend.com/

Re: [fw-general] OT: Good Docbook Editor

[Simone Carletti]

I usually edit docbook files by hand with TextMate.
I created a custom DocBook bundle with a couple of snippets and scripts.

However, if you have to write large documentation files, I suggest you to
give a look at
* http://www.xmlmind.com/xmleditor/
* http://www.oxygenxml.com/

I've tried both and I chose to purchase an Oxygen license.

-- Simone


On Thu, Jul 31, 2008 at 3:41 PM, 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.netInformation 
> Security Manager at the number above.
>
>

Re: [fw-general] OT: Good Docbook Editor

[Bradley Holt]

Keith,

I haven't used it for ZF docs, but XMLmind XML
Editor(XXE) makes a really nice
DocBook editor. I don't know how well it plays
with the specific format used for ZF docs, though. Has anyone tried it on
the ZF docs?

On Thu, Jul 31, 2008 at 9: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.netInformation 
> Security Manager at the number above.
>
>


-- 
Bradley Holt
[EMAIL PROTECTED]