Selaa lähdekoodia

org.texi: Improve ODT section

Jambunathan K 14 vuotta sitten
vanhempi
commit
dc9e33b0a5
1 muutettua tiedostoa jossa 55 lisäystä ja 12 poistoa
  1. 55 12
      doc/org.texi

+ 55 - 12
doc/org.texi

@@ -623,6 +623,11 @@ OpenDocument Text export
 * Working with raw OpenDocument XML::
 * Working with raw OpenDocument XML::
 * Advanced topics in @acronym{ODT} export::
 * 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
 Advanced topics in @acronym{ODT} export
 
 
 * Exporting and Converting to Other formats::
 * Exporting and Converting to Other formats::
@@ -10820,11 +10825,11 @@ converted file instead.
 @anchor{x-export-to-other-formats}
 @anchor{x-export-to-other-formats}
 @vindex org-export-odt-preferred-output-format
 @vindex org-export-odt-preferred-output-format
 Very often, you will find yourself exporting to @acronym{ODT} format, only to
 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
 (@pxref{x-export-to-odt,,Exporting to ODT}) can be extended to also export to
 the preferred format.
 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}.
 are interpreted as weighted ratios with the default weight being 1}.
 
 
 @cindex #+ATTR_ODT
 @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
 @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
 @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
 @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
 @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
 @LaTeX{} math snippets (@pxref{LaTeX fragments}) can be embedded in the ODT
 document using one of the following ways:
 document using one of the following ways:
 
 
@@ -11012,9 +11026,9 @@ This option is activated on a per-file basis with
 @end example
 @end example
 
 
 With this option, @LaTeX{} fragments are first converted in to MathML
 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-convert-command
 @vindex org-latex-to-mathml-jar-file
 @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")
       "/path/to/mathtoweb.jar")
 @end lisp
 @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
 @item png
 
 
 This option is activated on a per-file basis with
 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
 With this option, @LaTeX{} fragments are processed into png images and the
 resulting images are embedded in the exported document.  This method requires
 resulting images are embedded in the exported document.  This method requires
 that the @file{dvipng} program be available on your system.
 that the @file{dvipng} program be available on your system.
-
 @end enumerate
 @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
 @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
 @subsection Literal Examples in @acronym{ODT} export