packages/README.html

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3                "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4 <html xmlns="http://www.w3.org/1999/xhtml"
   5 lang="en" xml:lang="en">
   6 <head>
   7 <title>OpenDocumentText Exporter for Orgmode</title>
   8 <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
   9 <meta name="generator" content="Org-mode"/>
  10 <meta name="generated" content="2011-10-10 16:33:23 "/>
  11 <meta name="author" content="Jambunathan K "/>
  12 <meta name="description" content=""/>
  13 <meta name="keywords" content=""/>
  14 <style type="text/css">
  15  <!--/*--><![CDATA[/*><!--*/
  16   html { font-family: Times, serif; font-size: 12pt; }
  17   .title  { text-align: center; }
  18   .todo   { color: red; }
  19   .done   { color: green; }
  20   .tag    { background-color: #add8e6; font-weight:normal }
  21   .target { }
  22   .timestamp { color: #bebebe; }
  23   .timestamp-kwd { color: #5f9ea0; }
  24   .right  {margin-left:auto; margin-right:0px;  text-align:right;}
  25   .left   {margin-left:0px;  margin-right:auto; text-align:left;}
  26   .center {margin-left:auto; margin-right:auto; text-align:center;}
  27   p.verse { margin-left: 3% }
  28   pre {
  29         border: 1pt solid #AEBDCC;
  30         background-color: #F3F5F7;
  31         padding: 5pt;
  32         font-family: courier, monospace;
  33         font-size: 90%;
  34         overflow:auto;
  35   }
  36   table { border-collapse: collapse; }
  37   td, th { vertical-align: top;  }
  38   th.right  { text-align:center;  }
  39   th.left   { text-align:center;   }
  40   th.center { text-align:center; }
  41   td.right  { text-align:right;  }
  42   td.left   { text-align:left;   }
  43   td.center { text-align:center; }
  44   dt { font-weight: bold; }
  45   div.figure { padding: 0.5em; }
  46   div.figure p { text-align: center; }
  47   div.inlinetask {
  48     padding:10px;
  49     border:2px solid gray;
  50     margin:10px;
  51     background: #ffffcc;
  52   }
  53   textarea { overflow-x: auto; }
  54   .linenr { font-size:smaller }
  55   .code-highlighted {background-color:#ffff00;}
  56   .org-info-js_info-navigation { border-style:none; }
  57   #org-info-js_console-label { font-size:10px; font-weight:bold;
  58                                white-space:nowrap; }
  59   .org-info-js_search-highlight {background-color:#ffff00; color:#000000;
  60                                  font-weight:bold; }
  61   /*]]>*/-->
  62 </style>
  63 <script type="text/javascript">
  64 <!--/*--><![CDATA[/*><!--*/
  65  function CodeHighlightOn(elem, id)
  66  {
  67    var target = document.getElementById(id);
  68    if(null != target) {
  69      elem.cacheClassElem = elem.className;
  70      elem.cacheClassTarget = target.className;
  71      target.className = "code-highlighted";
  72      elem.className   = "code-highlighted";
  73    }
  74  }
  75  function CodeHighlightOff(elem, id)
  76  {
  77    var target = document.getElementById(id);
  78    if(elem.cacheClassElem)
  79      elem.className = elem.cacheClassElem;
  80    if(elem.cacheClassTarget)
  81      target.className = elem.cacheClassTarget;
  82  }
  83 /*]]>*///-->
  84 </script>
  85
  86 </head>
  87 <body>
  88
  89 <div id="preamble">
  90
  91 </div>
  92
  93 <div id="content">
  94 <h1 class="title">OpenDocumentText Exporter for Orgmode</h1>
  95
  96
  97
  98 <div id="table-of-contents">
  99 <h2>Table of Contents</h2>
 100 <div id="text-table-of-contents">
 101 <ul>
 102 <li><a href="#sec-1">1 Summary </a></li>
 103 <li><a href="#compatibility">2 Compatibility with Official Orgmode </a></li>
 104 <li><a href="#sec-3">3 Implementation Details </a></li>
 105 <li><a href="#sec-4">4 Notes for Reviewers and Fellow Developers </a></li>
 106 <li><a href="#sec-5">5 Package Layout </a></li>
 107 <li><a href="#sec-6">6 Obtaining OpenDocumentExporter </a>
 108 <ul>
 109 <li><a href="#sec-6-1">6.1 git checkout </a></li>
 110 <li><a href="#sec-6-2">6.2 Conventional tar </a></li>
 111 <li><a href="#sec-6-3">6.3 ELPA Tarball </a></li>
 112 </ul>
 113 </li>
 114 <li><a href="#sec-7">7 Test driving the Exporter </a></li>
 115 <li><a href="#sec-8">8 Bug Reports and Feature Requests </a></li>
 116 <li><a href="#sec-9">9 Possible Feature Enhacmentes </a>
 117 <ul>
 118 <li><a href="#sec-9-1">9.1 Support for fontification of babel blocks </a></li>
 119 <li><a href="#sec-9-2">9.2 Enhance table.el to support Odt format </a></li>
 120 <li><a href="#sec-9-3">9.3 Add support for exporting to odp </a></li>
 121 <li><a href="#sec-9-4">9.4 Support for generating MathML for LaTeX fragments </a></li>
 122 </ul>
 123 </li>
 124 <li><a href="#sec-10">10 Frequently Asked Questions </a>
 125 <ul>
 126 <li><a href="#sec-10-1">10.1 What features does the OpenDocumentExporter support? </a></li>
 127 <li><a href="#sec-10-2">10.2 Is OpenDocumentExporter part of Orgmode or Emacs? </a></li>
 128 <li><a href="#sec-10-3">10.3 How does it compare with official Orgmode </a></li>
 129 <li><a href="#sec-10-4">10.4 How can I export via command line? </a></li>
 130 <li><a href="#converter">10.5 How can I export to doc or docx format? </a>
 131 <ul>
 132 <li><a href="#sec-10-5-1">10.5.1 Install the converter program. </a></li>
 133 <li><a href="#sec-10-5-2">10.5.2 Convert using new interactive functions </a></li>
 134 </ul>
 135 </li>
 136 <li><a href="#sec-10-6">10.6 How can I apply custom styles? </a></li>
 137 </ul>
 138 </li>
 139 </ul>
 140 </div>
 141 </div>
 142
 143 <div id="outline-container-1" class="outline-2">
 144 <h2 id="sec-1"><span class="section-number-2">1</span> Summary </h2>
 145 <div class="outline-text-2" id="text-1">
 146
 147
 148 <p>
 149   This package adds support for exporting of Orgmode files to
 150   OpenDocumentText.
 151 </p>
 152 <p>
 153   The latest version of this document is available at
 154 </p>
 155 <dl>
 156 <dt>Web page</dt><dd><a href="http://repo.or.cz/w/org-mode/org-jambu.git/blob_plain/HEAD:/packages/README.html">http://repo.or.cz/w/org-mode/org-jambu.git/blob_plain/HEAD:/packages/README.html</a>
 157 </dd>
 158 </dl>
 159
 160
 161 </div>
 162
 163 </div>
 164
 165 <div id="outline-container-compatibility" class="outline-2">
 166 <h2 id="compatibility"><a name="sec-2" id="sec-2"></a><span class="section-number-2">2</span> Compatibility with Official Orgmode </h2>
 167 <div class="outline-text-2" id="text-compatibility">
 168
 169
 170 <p>
 171   This release is is as good as <b>org-20110613 (git commit c4737ae)</b>
 172   with <b>only</b> the following changes left out.
 173 </p>
 174 <table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
 175 <caption></caption>
 176 <colgroup><col class="left" /><col class="left" />
 177 </colgroup>
 178 <thead>
 179 <tr><th scope="col" class="left">git commit</th><th scope="col" class="left">Description</th></tr>
 180 </thead>
 181 <tbody>
 182 <tr><td class="left">2f50b1</td><td class="left">add an alternate for inline images</td></tr>
 183 <tr><td class="left">49e6bc</td><td class="left">Fix for html &amp; docbook export of desc list items</td></tr>
 184 <tr><td class="left">a201b1</td><td class="left">Fix HTML export of footnotes with lists, tables, quotes.</td></tr>
 185 <tr><td class="left">9f57b8</td><td class="left">Mixed export of numbered and unnumbered sections in HTML</td></tr>
 186 <tr><td class="left">438536</td><td class="left">Revert "Change underscores to hyphens in section labels"</td></tr>
 187 <tr><td class="left">33bae1</td><td class="left">Revert "Fix markup problems when using references in source fragments"</td></tr>
 188 <tr><td class="left">fa12fe</td><td class="left">Revert "org-html.el: Fix export of table.el tables."</td></tr>
 189 <tr><td class="left">f72541</td><td class="left">Revert "HTML export &ndash; Allow to change the name of the global DIV"</td></tr>
 190 </tbody>
 191 </table>
 192
 193
 194 </div>
 195
 196 </div>
 197
 198 <div id="outline-container-3" class="outline-2">
 199 <h2 id="sec-3"><span class="section-number-2">3</span> Implementation Details </h2>
 200 <div class="outline-text-2" id="text-3">
 201
 202
 203 <p>
 204   This package enhances Orgmode in the following manner:
 205 </p><ol>
 206 <li>A new line-oriented generic exporter
 207 </li>
 208 <li>All new html exporter re-implemented as a plugin to (1).
 209 </li>
 210 <li>A odt backend as a plugin to (1).
 211 </li>
 212 </ol>
 213
 214
 215 <p>
 216   Feature (1) is provided by <code>org-lparse.el</code>.
 217   Feture (2) is provided by <code>lisp/org-html.el</code>.
 218   Feature (3) is provided by <code>lisp/org-odt.el</code>.
 219 </p>
 220 <p>
 221   The new html exporter is feature-compatible with the official html
 222   exporter.
 223 </p>
 224 </div>
 225
 226 </div>
 227
 228 <div id="outline-container-4" class="outline-2">
 229 <h2 id="sec-4"><span class="section-number-2">4</span> Notes for Reviewers and Fellow Developers </h2>
 230 <div class="outline-text-2" id="text-4">
 231
 232
 233 <p>
 234   <code>org-lparse</code> is the entry point for the generic exporter and
 235   drives html and odt backends.
 236 </p>
 237 <p>
 238   <code>org-do-lparse</code> is the genericized version of the original
 239   <code>org-export-as-html</code> routine.
 240 </p>
 241 <p>
 242   <code>C-h v org-lparse-native-backends</code> is a good starting point for
 243   exploring the generic exporter.
 244 </p>
 245 </div>
 246
 247 </div>
 248
 249 <div id="outline-container-5" class="outline-2">
 250 <h2 id="sec-5"><span class="section-number-2">5</span> Package Layout </h2>
 251 <div class="outline-text-2" id="text-5">
 252
 253
 254 <ul>
 255 <li>odt/README.org
 256 </li>
 257 <li>odt/lisp/
 258 <dl>
 259 <dt>org-lparse.el</dt><dd>Generic line-oriented exporter
 260 </dd>
 261 <dt>org-xhtml.el</dt><dd>All new XHTML exporter
 262 </dd>
 263 <dt>org-odt.el</dt><dd>The OpenDocumentText backend
 264 </dd>
 265 </dl>
 266
 267 </li>
 268 <li>contrib/odt/tests
 269 <dl>
 270 <dt>org-mode-unicorn.png</dt><dd>
 271 </dd>
 272 <dt>test.org</dt><dd>Sample files for validating the exporter
 273 </dd>
 274 </dl>
 275
 276 </li>
 277 <li>contrib/odt/styles
 278 <dl>
 279 <dt>OrgOdtAutomaticStyles.xml</dt><dd>The default styles.xml file used by
 280          the OpenDocumentText exporter.
 281 </dd>
 282 <dt>OrgOdtStyles.xml</dt><dd>Automatic styles inserted in to content.xml
 283 </dd>
 284 </dl>
 285
 286 </li>
 287 <li>odt/BasicODConverter/
 288 <dl>
 289 <dt>BasicODConverter-0.8.0.oxt</dt><dd>OpenOffice extension for
 290          converting between various file formats supported by
 291          OpenOffice. A poor clone of unoconv.
 292 </dd>
 293 <dt>Filters.bas</dt><dd>
 294 </dd>
 295 <dt>Main.bas</dt><dd>StarBasic files that contribute to the above
 296                   extension.
 297 </dd>
 298 </dl>
 299
 300 </li>
 301 <li>odt/OASIS
 302 <dl>
 303 <dt>OpenDocument-v1.2-cs01-schema.rng</dt><dd>Copy of
 304          <a href="http://docs.oasis-open.org/office/v1.2/cs01/OpenDocument-v1.2-cs01-schema.rng">http://docs.oasis-open.org/office/v1.2/cs01/OpenDocument-v1.2-cs01-schema.rng</a>
 305 </dd>
 306 <dt>OpenDocument-v1.2-cs01-manifest-schema.rng</dt><dd>Copy of
 307          <a href="http://docs.oasis-open.org/office/v1.2/cs01/OpenDocument-v1.2-cs01-manifest-schema.rng">http://docs.oasis-open.org/office/v1.2/cs01/OpenDocument-v1.2-cs01-manifest-schema.rng</a>
 308 </dd>
 309 <dt>OpenDocument-schema-v1.1.rng</dt><dd>Copy of
 310          <a href="http://docs.oasis-open.org/office/v1.1/OS/OpenDocument-schema-v1.1.rng">http://docs.oasis-open.org/office/v1.1/OS/OpenDocument-schema-v1.1.rng</a>
 311 </dd>
 312 </dl>
 313
 314 </li>
 315 <li>odt/etc/schema
 316 <dl>
 317 <dt>od-schema-v1.1.rnc</dt><dd>
 318 </dd>
 319 <dt>od-manifest-schema-v1.2-cs01.rnc</dt><dd>
 320 </dd>
 321 <dt>od-schema-v1.2-cs01.rnc</dt><dd>rnc files for above rng
 322          files. Generated using <a href="http://www.thaiopensource.com/relaxng/trang.html">trang</a>.
 323
 324 </dd>
 325 <dt>schemas.xml</dt><dd>schema location file for auto validating the XML
 326                      files that form part of an OpenDocument
 327                      file. Refer <code>C-h f                      rng-set-schema-file-and-validate</code> FILENAME and
 328                      <code>C-h f rng-what-schema</code>.
 329
 330 </dd>
 331 </dl>
 332
 333 <p>    All the above files have been submitted for inclusing in Emacs
 334     proper. See
 335     <a href="http://lists.gnu.org/archive/html/emacs-devel/2011-06/msg00671.html">http://lists.gnu.org/archive/html/emacs-devel/2011-06/msg00671.html</a>
 336 </p></li>
 337 </ul>
 338
 339
 340 </div>
 341
 342 </div>
 343
 344 <div id="outline-container-6" class="outline-2">
 345 <h2 id="sec-6"><span class="section-number-2">6</span> Obtaining OpenDocumentExporter </h2>
 346 <div class="outline-text-2" id="text-6">
 347
 348
 349 <p>
 350   The OpenDocumentExporter could be downloaded by one of the following
 351   methods:
 352 </p>
 353
 354 </div>
 355
 356 <div id="outline-container-6-1" class="outline-3">
 357 <h3 id="sec-6-1"><span class="section-number-3">6.1</span> git checkout </h3>
 358 <div class="outline-text-3" id="text-6-1">
 359
 360 <dl>
 361 <dt>Checkout URL</dt><dd><a href="http://repo.or.cz/r/org-mode/org-jambu.git">http://repo.or.cz/r/org-mode/org-jambu.git</a>
 362 </dd>
 363 <dt>Web URL</dt><dd><a href="http://repo.or.cz/w/org-mode/org-jambu.git/">http://repo.or.cz/w/org-mode/org-jambu.git/</a>
 364 </dd>
 365 </dl>
 366
 367
 368 </div>
 369
 370 </div>
 371
 372 <div id="outline-container-6-2" class="outline-3">
 373 <h3 id="sec-6-2"><span class="section-number-3">6.2</span> Conventional tar </h3>
 374 <div class="outline-text-3" id="text-6-2">
 375
 376 <dl>
 377 <dt>Download URL</dt><dd><a href="http://repo.or.cz/w/org-mode/org-jambu.git/snapshot/HEAD.tar.gz">http://repo.or.cz/w/org-mode/org-jambu.git/snapshot/HEAD.tar.gz</a>
 378 </dd>
 379 </dl>
 380
 381
 382 </div>
 383
 384 </div>
 385
 386 <div id="outline-container-6-3" class="outline-3">
 387 <h3 id="sec-6-3"><span class="section-number-3">6.3</span> ELPA Tarball </h3>
 388 <div class="outline-text-3" id="text-6-3">
 389
 390 <dl>
 391 <dt>Archive URL</dt><dd><a href="http://repo.or.cz/w/org-mode/org-jambu.git/blob_plain/HEAD:/packages/">http://repo.or.cz/w/org-mode/org-jambu.git/blob_plain/HEAD:/packages/</a>
 392 </dd>
 393 </dl>
 394
 395
 396 <p>
 397    The tarball is distributed as an org-odt package (for example
 398    <code>org-odt-20110519.tar</code>).
 399 </p>
 400 <p>
 401    You need to have an <b>Org build &gt;= org-20110626</b> for the exporter to
 402    function properly.
 403 </p>
 404 <p>
 405    The most hassle-free way to download and install org-odt is through
 406    ELPA.
 407 </p>
 408 <p>
 409    More help on all the above methods are available at
 410    <a href="http://orgmode.org/worg/org-faq.html">http://orgmode.org/worg/org-faq.html</a>.
 411 </p>
 412 </div>
 413 </div>
 414
 415 </div>
 416
 417 <div id="outline-container-7" class="outline-2">
 418 <h2 id="sec-7"><span class="section-number-2">7</span> Test driving the Exporter </h2>
 419 <div class="outline-text-2" id="text-7">
 420
 421
 422 <p>
 423   Once the package is installed in to your load-path, use
 424   <code>C-u M-x org-odt-unit-test</code> to visit an example org file bundled
 425   with this package.
 426 </p>
 427 <ol>
 428 <li>Use <code>C-c C-e O</code> to export the buffer to OpenDocumentText.
 429 </li>
 430 <li>Use <code>M-x org-lparse</code> or <code>M-x org-lparse-and-open</code> for
 431      exporting to MS doc format.
 432 </li>
 433 <li>Use <code>M-x org-export-convert</code> on a buffer visiting odt file.
 434 </li>
 435 </ol>
 436
 437
 438 <p>
 439   Steps 2 and 3 require that a converter be installed on the
 440   system. See <a href="#converter">this FAQ entry</a> for more information on this.
 441 </p>
 442 <dl>
 443 <dt>Misc. Info</dt><dd>This package re-implements HTML exporter as
 444                   well. You will see the following warning message
 445                   *"Exporting to HTML using org-lparse&hellip;"* while you
 446                   are exporting using new HTML exporter.
 447
 448 </dd>
 449 <dt>Hint</dt><dd>If you are using BasicODConverter, you can use steps 2 and
 450             3 for exporting an Org outline to presentation formats
 451             like OpenOffice Impress (odp) and Microsoft Powerpoint
 452             (ppt)
 453 </dd>
 454 <dt>Know Issues</dt><dd>If you have dvipng installed it is possible that
 455                    the exported odt file has embedded images
 456                    clobbered. This is <b>not</b> a bug in the exporter but
 457                    seems like a bug in the package installer. See
 458                    <a href="http://lists.gnu.org/archive/html/bug-gnu-emacs/2011-06/msg00445.html">http://lists.gnu.org/archive/html/bug-gnu-emacs/2011-06/msg00445.html</a>.
 459 </dd>
 460 </dl>
 461
 462
 463 </div>
 464
 465 </div>
 466
 467 <div id="outline-container-8" class="outline-2">
 468 <h2 id="sec-8"><span class="section-number-2">8</span> Bug Reports and Feature Requests </h2>
 469 <div class="outline-text-2" id="text-8">
 470
 471
 472 <p>
 473   Send in your bug report and feature requests to
 474   <code>emacs-orgmode@gnu.org</code> or to <code>kjambunathan at gmail dot com</code>.
 475 </p>
 476 <p>
 477   Please search the Mailing List Archive -
 478   <a href="http://lists.gnu.org/archive/html/emacs-orgmode/">http://lists.gnu.org/archive/html/emacs-orgmode/</a> for <code>org-odt</code>
 479   before posting a question or a request either to me or the mailing
 480   list.
 481 </p>
 482 <p>
 483   Posting to mailing list is preferable. It is possible that your post
 484   helps another user out there.
 485 </p>
 486 </div>
 487
 488 </div>
 489
 490 <div id="outline-container-9" class="outline-2">
 491 <h2 id="sec-9"><span class="section-number-2">9</span> Possible Feature Enhacmentes </h2>
 492 <div class="outline-text-2" id="text-9">
 493
 494
 495
 496 </div>
 497
 498 <div id="outline-container-9-1" class="outline-3">
 499 <h3 id="sec-9-1"><span class="section-number-3">9.1</span> <span class="todo TODO"> TODO</span> Support for fontification of babel blocks </h3>
 500 <div class="outline-text-3" id="text-9-1">
 501
 502 <p>   May require enhancements to htmlfontify or htmlize packages.
 503 </p>
 504 </div>
 505
 506 </div>
 507
 508 <div id="outline-container-9-2" class="outline-3">
 509 <h3 id="sec-9-2"><span class="section-number-3">9.2</span> <span class="todo TODO"> TODO</span> Enhance table.el to support Odt format </h3>
 510 <div class="outline-text-3" id="text-9-2">
 511
 512
 513 </div>
 514
 515 </div>
 516
 517 <div id="outline-container-9-3" class="outline-3">
 518 <h3 id="sec-9-3"><span class="section-number-3">9.3</span> <span class="todo TODO"> TODO</span> Add support for exporting to odp </h3>
 519 <div class="outline-text-3" id="text-9-3">
 520
 521
 522 <p>
 523    Use OpenOffice's File-&gt;Send-&gt;{Outline to Presentation |
 524    AutoAbstract to Presentation}. Also see
 525 </p>
 526 <p>
 527    <a href="http://wiki.services.openoffice.org/wiki/Documentation/OOoAuthors_User_Manual/Impress_Guide/Creating_slides_from_an_outline">http://wiki.services.openoffice.org/wiki/Documentation/OOoAuthors_User_Manual/Impress_Guide/Creating_slides_from_an_outline</a>
 528 </p>
 529 </div>
 530
 531 </div>
 532
 533 <div id="outline-container-9-4" class="outline-3">
 534 <h3 id="sec-9-4"><span class="section-number-3">9.4</span> <span class="todo TODO"> TODO</span> Support for generating MathML for LaTeX fragments </h3>
 535 <div class="outline-text-3" id="text-9-4">
 536
 537 <p>   See <a href="http://lists.gnu.org/archive/html/emacs-orgmode/2011-03/msg01755.html">http://lists.gnu.org/archive/html/emacs-orgmode/2011-03/msg01755.html</a>
 538 </p>
 539 </div>
 540 </div>
 541
 542 </div>
 543
 544 <div id="outline-container-10" class="outline-2">
 545 <h2 id="sec-10"><span class="section-number-2">10</span> Frequently Asked Questions </h2>
 546 <div class="outline-text-2" id="text-10">
 547
 548
 549
 550 </div>
 551
 552 <div id="outline-container-10-1" class="outline-3">
 553 <h3 id="sec-10-1"><span class="section-number-3">10.1</span> What features does the OpenDocumentExporter support? </h3>
 554 <div class="outline-text-3" id="text-10-1">
 555
 556
 557 <p>
 558    At the moment, the exporter supports the following most commonly
 559    used features of Org
 560 </p>
 561 <ul>
 562 <li>Various Character Styles
 563 </li>
 564 <li>Various Paragraph Styles (including Source Blocks)
 565 </li>
 566 <li>Embedded ODT
 567 </li>
 568 <li>Embedded MathML
 569 </li>
 570 <li>Numbered, Bulleted and Description lists
 571 </li>
 572 <li>Embedding and Resizing of Images including embedding of LaTeX fragments
 573 </li>
 574 <li>Fuzzy, Dedicated and Radio Targets and Links
 575 </li>
 576 <li>Tables
 577 </li>
 578 <li>Footnotes
 579 </li>
 580 <li>Outline Numbering and Table Of Contents
 581 </li>
 582 <li>Special markups for elements like TODOs, Timestamps and Tags
 583 </li>
 584 </ul>
 585
 586
 587 <p>
 588    The exporter is quite usable and stable.
 589 </p>
 590 </div>
 591
 592 </div>
 593
 594 <div id="outline-container-10-2" class="outline-3">
 595 <h3 id="sec-10-2"><span class="section-number-3">10.2</span> Is OpenDocumentExporter part of Orgmode or Emacs? </h3>
 596 <div class="outline-text-3" id="text-10-2">
 597
 598
 599 <p>
 600    Not yet. I have expressed my willingness to merge this package in
 601    to official Orgmode and thus to Emacs. The current maintainer of
 602    Orgmode - <code>Bastien Guerry bzg at gnu.org</code> - has agreed to consider
 603    the package for integration. If you are interested in having this
 604    package merged with Orgmode send your requests to the maintainer.
 605 </p>
 606 <p>
 607    For the sake of record, I am the sole author of the changes
 608    included in this package and I am consenting to have this work or
 609    derivative works make it's way into Emacs proper. My FSF copyright
 610    assignment number is #618390.
 611 </p>
 612 </div>
 613
 614 </div>
 615
 616 <div id="outline-container-10-3" class="outline-3">
 617 <h3 id="sec-10-3"><span class="section-number-3">10.3</span> How does it compare with official Orgmode </h3>
 618 <div class="outline-text-3" id="text-10-3">
 619
 620 <p>   For information about the latest release see <a href="#compatibility">this.</a> For general
 621    information refer
 622    <a href="http://lists.gnu.org/archive/html/emacs-orgmode/2011-05/msg00751.html">http://lists.gnu.org/archive/html/emacs-orgmode/2011-05/msg00751.html</a>.
 623 </p>
 624 </div>
 625
 626 </div>
 627
 628 <div id="outline-container-10-4" class="outline-3">
 629 <h3 id="sec-10-4"><span class="section-number-3">10.4</span> How can I export via command line? </h3>
 630 <div class="outline-text-3" id="text-10-4">
 631
 632
 633 <p>
 634    See the following post
 635    <a href="http://lists.gnu.org/archive/html/emacs-orgmode/2011-04/msg00952.html">http://lists.gnu.org/archive/html/emacs-orgmode/2011-04/msg00952.html</a>.
 636 </p>
 637 </div>
 638
 639 </div>
 640
 641 <div id="outline-container-converter" class="outline-3">
 642 <h3 id="converter"><a name="sec-10-5" id="sec-10-5"></a><span class="section-number-3">10.5</span> How can I export to doc or docx format? </h3>
 643 <div class="outline-text-3" id="text-converter">
 644
 645 <p>   Here are the steps.
 646 </p>
 647
 648 </div>
 649
 650 <div id="outline-container-10-5-1" class="outline-4">
 651 <h4 id="sec-10-5-1"><span class="section-number-4">10.5.1</span> Install the converter program. </h4>
 652 <div class="outline-text-4" id="text-10-5-1">
 653
 654
 655 <p>
 656     There are numerous converters that are available: <code>unoconv</code>,
 657     <code>PyODConverter</code>, <code>JODConverter</code> etc etc.
 658 </p>
 659 <p>
 660     org-odt is distributed with it's own converter
 661     <code>BasicODConverter</code>. It is <i>Basic</i> not only because it is
 662     implemented in StarBasic but is a a very basic clone of unoconv.
 663 </p>
 664 <ul>
 665 <li id="sec-10-5-1-1">BasicODConverter <br/>
 666      Install <a href="http://repo.or.cz/w/org-mode/org-jambu.git/blob/HEAD:/contrib/odt/BasicODConverter-0.8.0.oxt">BasicODConverter</a> as a OpenOffice Extension.
 667
 668 </li>
 669 </ul>
 670 <ul>
 671 <li id="sec-10-5-1-2">unoconv <br/>
 672
 673 <p>
 674      If you prefer using unoconv as the converter add the following
 675      snippet to your <code>.emacs</code>.
 676 </p>
 677
 678
 679
 680 <pre class="example">;; not tested with unoconv
 681 (require 'org-html)
 682 (setq org-export-convert-process '("unoconv" "-f" "%f" "-o" "%d" "%i"))
 683 </pre>
 684
 685
 686 </li>
 687 </ul>
 688 </div>
 689
 690 </div>
 691
 692 <div id="outline-container-10-5-2" class="outline-4">
 693 <h4 id="sec-10-5-2"><span class="section-number-4">10.5.2</span> Convert using new interactive functions </h4>
 694 <div class="outline-text-4" id="text-10-5-2">
 695
 696
 697 <ul>
 698 <li id="sec-10-5-2-1">Export an Org buffer <br/>
 699      Use <code>M-x org-lparse</code> or <code>M-x org-lparse-and-open</code> and follow
 700      the prompts. Use TAB for completion if you are not already using
 701      ido.
 702
 703 <ul>
 704 <li id="sec-10-5-2-1-1">Additional Note <br/>
 705 <ol>
 706 <li>If you are using BasicODConverter you can export an Org file
 707         to <code>odp</code> or <code>ppt</code> formats.
 708 </li>
 709 <li>You can convert csv files to xls format
 710 </li>
 711 <li>OpenOffice doesn't ship with mediawiki or docbook export
 712         filters by default. So make sure that these extensions are
 713         installed before trying out these converters.
 714 </li>
 715 </ol>
 716
 717
 718 </li>
 719 </ul>
 720 </li>
 721 </ul>
 722 <ul>
 723 <li id="sec-10-5-2-2">Export an existing file <br/>
 724
 725 <p>
 726      Use <code>M-x org-export-convert</code> to convert an existing file.
 727 </p>
 728
 729 </li>
 730 </ul>
 731 </div>
 732 </div>
 733
 734 </div>
 735
 736 <div id="outline-container-10-6" class="outline-3">
 737 <h3 id="sec-10-6"><span class="section-number-3">10.6</span> How can I apply custom styles? </h3>
 738 <div class="outline-text-3" id="text-10-6">
 739
 740
 741 <p>
 742    See this thread:
 743    <a href="http://lists.gnu.org/archive/html/emacs-orgmode/2011-03/msg01460.html">http://lists.gnu.org/archive/html/emacs-orgmode/2011-03/msg01460.html</a>
 744 </p></div>
 745 </div>
 746 </div>
 747 </div>
 748
 749 <div id="postamble">
 750 <p class="date">Date: 2011-10-10 16:33:23 </p>
 751 <p class="author">Author: Jambunathan K </p>
 752 <p class="creator">Org version 7.7 with Emacs version 24</p>
 753 <a href="http://validator.w3.org/check?uri=referer">Validate XHTML 1.0</a>
 754
 755 </div>
 756 </body>
 757 </html>