#+TITLE:     BasicODConverter.org
#+AUTHOR:    Jambunathan K
#+EMAIL:     kjambunathan@gmail.com
#+DATE:      2011-09-21 Wed
#+DESCRIPTION:
#+KEYWORDS:
#+LANGUAGE:  en
#+OPTIONS:   H:4 num:t toc:t \n:nil @:t ::t |:t ^:t -:t f:t *:t <:t
#+OPTIONS:   TeX:t LaTeX:dvipng skip:nil d:nil todo:t pri:nil tags:not-in-toc

#+EXPORT_SELECT_TAGS: export
#+EXPORT_EXCLUDE_TAGS: noexport
#+LINK_UP:   
#+LINK_HOME: 
#+XSLT:


* Converter Setup
** Install BasicODConverter-0.8.0.oxt 
*** See contrib/odt/BasicODConverter/ 

** Customize org-lparse-convert-process
*** Choose BasicODConverter from the menu

* Converter Configuration
** Direct export to doc or pdf
*** Customize org-export-odt-preferred-output-format
**** Choose doc or pdf 

** Direct export to odp or ppt
***  Customize org-lparse-convert-capabilities
**** Add ppt and odp as output file formats under "Text" document class
     With this C-h v org-lparse-convert-capabilities RET should report
     something as shown below

,---- org-lparse-convert-capabilities
| (("Text"
|   ("odt" "ott" "doc" "rtf")
|   (("pdf" "pdf")
|    ("odt" "odt")
|    ("xhtml" "html")
|    ("rtf" "rtf")
|    ("ott" "ott")
|    ("doc" "doc")
|    ("ooxml" "xml")
|    ("html" "html")
|    ("odp" "odp")   <----------
|    ("ppt" "ppt"))) <----------
|  ("Web"
|   ("html" "xhtml")
|   (("pdf" "pdf")
|    ("odt" "txt")
|    ("html" "html")))
|  ("Spreadsheet"
|   ("ods" "ots" "xls" "csv")
|   (("pdf" "pdf")
|    ("ots" "ots")
|    ("html" "html")
|    ("csv" "csv")
|    ("ods" "ods")
|    ("xls" "xls")
|    ("xhtml" "xhtml")
|    ("ooxml" "xml")))
|  ("Presentation"
|   ("odp" "otp" "ppt")
|   (("pdf" "pdf")
|    ("swf" "swf")
|    ("odp" "odp")
|    ("xhtml" "xml")
|    ("otp" "otp")
|    ("ppt" "ppt")
|    ("odg" "odg")
|    ("html" "html"))))
`----

* Exporting Org files
** Exporting Org->Doc or Pdf
*** Use C-c C-e O or C-c C-e o 
    Exporter will not only output the odt file but will also export it
    to your preferred format configured in the previous step.

** Exporting Org->Odt/Ppt
*** Visit your .org file
*** M-x org-lparse-and-open
**** Export To:  => choose odp or ppt
**** Native Backend: => choose odt
**** Have you read the note of CAUTION?

    The file will first be exported to odt and then converted to
    odp/ppt. The odt->odp conversion will launch LibreOffice
    frame. The export is NOT FINISHED YET. WAIT FOR 10 SECS after
    which it would close. This means that conversion is fully done.

    If you have used org-lparse-and-open the presentation will be
    opened again for your review.

    The macro does the same thing as LibreOffice's File->Send->Outline
    to Presentation but in a hands-off manner.

**** Further Adjustments may be needed
     - See
       http://wiki.services.openoffice.org/wiki/Documentation/OOoAuthors_User_Manual/Impress_Guide/Creating_slides_from_an_outline
       for more information.

* Converting Non-Org files
** Visit your odt file
   - File will open within Emacs in archive mode
** Use C-u M-x org-lparse-convert RET 
*** Fill "File to be Converted"
*** Output Format: => choose odp
*** Wait for 10-15s and be patient until the file is produced

* Power Tips
** Use TAB for completing available formats
*** Use of ido mode is highly recommended

** Use org-lparse-convert as Uber-conversion command
*** csv->xls
*** odt->latex
*** odp->html
*** svg->svm

** Create an org-export-as-odp-and-open custom command

#+begin_src emacs-lisp
  (defun org-export-as-odp-and-open (arg)
    "Export the outline as ODP and immediately open it with a browser.
  If there is an active region, export only the region. The prefix
  ARG specifies how many levels of the outline should be exported.
  The default is 3.  Lower levels will be stripped from the
  exported presentaion."
    (interactive "P")
    (org-lparse-and-open "odp" "odt" arg))
  
#+end_src

* Thanks
** This presentation itself if created using org-odt
** Native org->odp exporter, if there is popular demand