[Orgmode] Re: docbook export-special

[Baoqiu Cui]

Rustom Mody <address@hidden> writes:

> On Thu, May 28, 2009 at 2:30 PM, Carsten Dominik
> <address@hidden> wrote:
>>
>> On May 28, 2009, at 9:47 AM, Rustom Mody wrote:
>>
>>> Hello Baoqiu,
>>>
>>> Rustom Mody <rustompmody <at> gmail.com> writes:
>>>
>>>> Baoqiu wrote:
>>>> Can you use #+BEGIN_DOCBOOK ... #+END_DOCBOOK instead to achieve what
>>>> you want?
>
> Hell! I could swear that I tried this yesterday and the content disappeared!
> Today its appearing in the xml output so thats probably enough.

I am very glad to know that this works for you.

> I worked out the current mappings as i find them:
> 1 BEGIN_QUOTE  ->  <blockquote>
> 2 BEGIN_EXAMPLE  ->  <programlisting>
> 3 BEGIN_SRC lang -> <programlisting>
> 4 BEGIN_VERSE ->  <literallayout>
> 5 BEGIN_CENTER ->  something complicated

Yes, the above mappings are what I use now in the exporter.
BEGIN_CENTER is handled using <informaltable>.

Have you tried something like the following?

#+DOCBOOK: <para><emphasis>One line</emphasis> written in DocBook</para>

#+BEGIN_DOCBOOK
<warning>
  <para>You should know what you are doing when quoting DocBook XML code
  in your Org file.  Invalid DocBook XML file may be generated by
  DocBook exporter if you are not careful!</para>
</warning>
#+END_DOCBOOK

Because we already have #+BEGIN_DOCBOOK ... #+END_DOCBOOK, there is no
point to support many other blocks like #+begin_warning
... #+end_warning (for the above example) etc., which can really pollute
Org-mode files.

> It would ne nice if something like this is there at least in the
> org-docbook.el sources -- The manual is long enough and need not be
> lengthened with the requirements of fringe users like
> Yours truly :-)

I can add a little more comments in org-docbook.el, but ideally we
should add important things to the manual if they are missing.  What
particular information do you want to see in the manual?

Baoqiu