Re: [ANN] OpenDocumentText/OpenOffice Exporter - 0.6 Release

From: Christian Moe <mail@christianmoe.com>
To: Jambunathan K <kjambunathan@gmail.com>
Cc: emacs-orgmode@gnu.org
Subject: Re: [ANN] OpenDocumentText/OpenOffice Exporter - 0.6 Release
Date: Mon, 31 Jan 2011 12:00:07 +0100	[thread overview]
Message-ID: <4D469637.4070107@christianmoe.com> (raw)
In-Reply-To: <81aaikk8g2.fsf@gmail.com>

Hi,

This is great, and I look forward to seeing it as part of Org-mode.

Thanks for the detailed git instructions. Haven't dared try before.

Some feedback:

- *Captions/labels/references* do not yet integrate well with
   OpenOffice.

   - The illustration in sec 6.2.2 is captioned "Illustration fig:1024
     Unicorn Logo", echoing the label. One would probably prefer
     something *auto-numbered* like "Illustration 1: Unicorn Logo".

     - (Even better if there were possible to choose other types names,
       like Chart, Figure, etc.).

   - The reference to the same illustration is a hyperlink containing
     part of the label text ("1024"). A *cross-reference field* would
     be preferable to a hyperlink, and "Illustration 1" or similar
     better than "1024".

   - The table caption in sec 9.2, on the other hand, works the way I
     would want illustration captions to work: What appears in the
     caption is not the label text ("table:10"), but the auto-numbered
     "Table 1 An Example Table".

     - (It would be nice to have a colon or other *separator* between
       label and caption text: "Table 1: An Example Table".)

   - However, the reference to that table appears as a hyperlink saying
     "10", and the hyperlink does not appear to work. A cross-reference
     link to "Table 1" would be better.

- It might also be preferable to have links to inline targets, at
   least headline and CUSTOM_ID targets, exported as *cross-reference
   fields* rather than hyperlinks. In OpenOffice, a cross-reference
   field can give e.g. the automatically updated page number the target
   is at.

Exporting one of my own documents, I also found that:

- A space is inserted before *footnote markers*; it shouldn't be. You
   can't see this in the text document, where there is space before all
   footnote references anyway.

- Paragraphs were frequently split up, mid-sentence, by unwanted
   paragraph breaks. This bug is a bit of a mystery. The extra
   paragraph breaks appear where there is a newline in the text. But I
   can't discern any pattern as to why breaks are inserted at these
   newlines and not others. Nothing similar happens in HTML export.

Hope this helps you refine a really helpful contribution.

Yours,
Christian

On 1/28/11 10:46 PM, Jambunathan K wrote:
>
> I am happy to make available 0.6 release of OpenOffice/OpenDocumentText
> exporter. The exporter is based on org-parse.el contributed by Lennart
> Borgman.
>
> Web URL:
> - http://repo.or.cz/w/org-mode/org-jambu.git
>
> Checkout URLs:
> - git://repo.or.cz/org-mode/org-jambu.git
> - http://repo.or.cz/r/org-mode/org-jambu.git
>
>
> 1. Checkout my repo
>
> #+begin_src sh
>    git remote add org-odt http://repo.or.cz/r/org-mode/org-jambu.git
>    git fetch org-odt
>    git checkout -b org-odt org-odt/master
> #+end_src
>
> 2. Create a simple "~/elisp/org-odt-setup.el" with the following
>     content. Replace "~/src/staging/org-mode" with the root of your
>     checkout dir..
>
> #+begin_src emacs-lisp
>    (custom-set-variables
>     '(initial-buffer-choice "~/src/staging/org-mode/contrib/odt/files/test.org")
>     '(org-export-latex-default-packages-alist (quote (("AUTO" "inputenc" t))))
>     '(org-export-with-LaTeX-fragments (quote dvipng))
>    )
>
>    (add-to-list 'auto-mode-alist '("\\.org$" . org-mode))
>    (setq org-odt-base-dir "~/src/staging/org-mode")
>    (load-file (expand-file-name "contrib/odt/setup.el" org-odt-base-dir))
> #+end_src
>
> 3. Launch a minimal emacs and load the above file.
>
>     runemacs.exe -Q --load ~/elisp/org-odt-setup.el
>
>     You will find yourself in a 'test.org' buffer.
>
> 4. Use 'C-c C-e O' to export the above buffer as ODT and open it with
>     the default system app i.e., OpenOffice Writer for example.
>
> I am attaching the test.odt created in my machine using the above
> instructions.
>
> Lately, I have been finding myself a bit tied down with other things. So
> this release is a kind of a 'hasty' release. Needless to say, there are
> lots of areas where obvious improvements can be made.
>
> I will be a bit slow in responding for next few weeks. Let that not hold
>     you back.
>
>
>
>
>
> Jambunathan K.
>
>
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode