summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJambunathan K <kjambunathan@gmail.com>2011-12-07 02:42:52 +0530
committerBastien Guerry <bzg@altern.org>2011-12-10 18:13:26 +0100
commitdc9e33b0a5462881a697c07c3ce3878770b95861 (patch)
treed1275eaec484484346e7b5512168cb279ff6c42f
parent57185cc6d96e3da1fd12407559bbeb602aa505e0 (diff)
downloadorg-mode-dc9e33b0a5462881a697c07c3ce3878770b95861.tar.gz
org.texi: Improve ODT section
-rw-r--r--doc/org.texi67
1 files changed, 55 insertions, 12 deletions
diff --git a/doc/org.texi b/doc/org.texi
index efb3f40..bdc43f5 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -623,6 +623,11 @@ OpenDocument Text export
* Working with raw OpenDocument XML::
* Advanced topics in @acronym{ODT} export::
+Math formatting in @acronym{ODT} export
+
+* Working with @LaTeX{} math snippets::
+* Working with MathML or OpenDocument formula files::
+
Advanced topics in @acronym{ODT} export
* Exporting and Converting to Other formats::
@@ -10820,11 +10825,11 @@ converted file instead.
@anchor{x-export-to-other-formats}
@vindex org-export-odt-preferred-output-format
Very often, you will find yourself exporting to @acronym{ODT} format, only to
-immediately save the exported document to a different format like @samp{doc},
-@samp{pdf} etc. In such cases, you will find it convenient to configure a
-converter (@pxref{Configuring a converter}) and specify your preferred
-output format by customizing the variable
-@code{org-export-odt-preferred-output-format}. This way the export commands
+immediately save the exported document to a different format like @samp{pdf}.
+In such cases, you will find it convenient to configure a converter
+(@pxref{Exporting and Converting to Other formats}) and specify your
+preferred output format by customizing the variable
+@code{org-export-odt-preferred-output-format}. This way, the export commands
(@pxref{x-export-to-odt,,Exporting to ODT}) can be extended to also export to
the preferred format.
@@ -10906,8 +10911,9 @@ and alignment}) then these are honored on export@footnote{The column widths
are interpreted as weighted ratios with the default weight being 1}.
@cindex #+ATTR_ODT
-You can override the default formatting of the table by specifying a custom
-table style with the @code{#+ATTR_ODT} line.
+If you are not satisfied with the default formatting of tables, you can
+create custom table styles and associate them with a table using
+@code{#+ATTR_ODT} line. @xref{Customizing Tables in @acronym{ODT} export}.
@node Images in @acronym{ODT} export, Math formatting in @acronym{ODT} export, Tables in @acronym{ODT} export, OpenDocument Text export
@subsection Images in @acronym{ODT} export
@@ -10998,6 +11004,14 @@ original height:width ratio, do the following
@node Math formatting in @acronym{ODT} export, Literal Examples in @acronym{ODT} export, Images in @acronym{ODT} export, OpenDocument Text export
@subsection Math formatting in @acronym{ODT} export
+@menu
+* Working with @LaTeX{} math snippets::
+* Working with MathML or OpenDocument formula files::
+@end menu
+
+@node Working with @LaTeX{} math snippets, Working with MathML or OpenDocument formula files, Math formatting in @acronym{ODT} export, Math formatting in @acronym{ODT} export
+@subsubsection Working with @LaTeX{} math snippets
+
@LaTeX{} math snippets (@pxref{LaTeX fragments}) can be embedded in the ODT
document using one of the following ways:
@@ -11012,9 +11026,9 @@ This option is activated on a per-file basis with
@end example
With this option, @LaTeX{} fragments are first converted in to MathML
-fragments using an external LaTeX-to-MathML converter program. The resulting
-MathML fragments are then embedded as a OpenDocument Formula in the exported
-document.
+fragments using an external @LaTeX{}-to-MathML converter program. The
+resulting MathML fragments are then embedded as a OpenDocument Formula in the
+exported document.
@vindex org-latex-to-mathml-convert-command
@vindex org-latex-to-mathml-jar-file
@@ -11034,8 +11048,20 @@ converter, you can configure the above variables as shown below.
"/path/to/mathtoweb.jar")
@end lisp
-@cindex dvipng
+You can use the following commands to quickly verify the reliability of
+@LaTeX{}-to-MathML converter.
+@table @kbd
+
+@item M-x org-export-as-odf
+Convert a @LaTeX{} math snippet to OpenDocument formula(@file{.odf}) file.
+
+@item M-x org-export-as-odf-and-open
+Convert a @LaTeX{} math snippet to OpenDocument formula(@file{.odf}) file and
+open the formula file with the system-registered application.
+@end table
+
+@cindex dvipng
@item png
This option is activated on a per-file basis with
@@ -11047,9 +11073,26 @@ This option is activated on a per-file basis with
With this option, @LaTeX{} fragments are processed into png images and the
resulting images are embedded in the exported document. This method requires
that the @file{dvipng} program be available on your system.
-
@end enumerate
+@node Working with MathML or OpenDocument formula files, , Working with @LaTeX{} math snippets, Math formatting in @acronym{ODT} export
+@subsubsection Working with MathML or OpenDocument formula files
+
+For various reasons, you may find embedding @LaTeX{} math snippets in a
+@acronym{ODT} document less than reliable. In that case, you can embed a
+Math equation by linking to it's MathML(@file{.mml}) source or it's
+OpenDocument formula(@file{.odf}) file as shown below:
+
+@example
+[[./equation.mml]]
+@end example
+
+or
+
+@example
+[[./equation.odf]]
+@end example
+
@node Literal Examples in @acronym{ODT} export, Working with raw OpenDocument XML, Math formatting in @acronym{ODT} export, OpenDocument Text export
@subsection Literal Examples in @acronym{ODT} export