[Docutils-users] raw odt (was: installation directories)

[G. M. <mi...@us...>]

On 27.02.08, Dave Kuhlman wrote:
> G. Milde <milde <at> users.berlios.de> writes:

> > I assume (but did not test) that adding `visit_raw` and `depart_raw`
> > methods that just pass to the odtwriter class might solve your problem
> > (but of course not provide raw access to odtwriter output which is a more
> > complicated task).
> > 

> OK.  I'll try.  But, I'm not sure I'll know what to do.  Would
> someone actually try to pass through the "raw" XML code to be
> inserted into a ODF .odt file?  Here is an example of what that
> might look like::
...
> Gack!

> Would someone really want to do that?

I do not assume that people want to hand-write odt xml (the way you will do
with raw latex, say). However, the raw directive might come handy e.g. 

 * with snippets produced by other programs or taken from an oo-produced
   file, a text input field, say::
   
    .. raw:: odt
   
      <draw:control text:anchor-type="as-char" svg:y="-0.887cm"
      draw:z-index="1" draw:style-name="gr1" draw:text-style-name="P1"
      svg:width="4.026cm" svg:height="1.438cm" draw:control="control1"/>

   This might be especially useful with raw input of external files.

 * as an alternative to raw text in another output format::
 
    .. raw:: latex
   
      \latex
      
    .. raw:: html odt
   
      LaTeX   

> Of course, you would have to remove all (most? some?) of the
> indentation and whitespace.

Correct formatting might indeed be a problem, as messing with the
whitespace seems to corrupt an oo document. Is there documentation about
formatting issues?

> Or, should I just add the visit_raw and depart_raw methods, but
> ignore any content. Basically, this is what odtwriter does now.  It
> is printing out that "missing" warning message and ignoring the raw
> directive.

I could imagine the raw directive to insert its content in a form that is
accepted by oofice -- at least with plain text.

Alternatively, it could output a more verbose warning, like

.. warning:: 

  Ignoring content of raw directive: < content here >

  There is currently no consensus on how to implement the raw
  directive for odtwriter, help welcome.
  
  
Günter