Started modifying project structure

This commit is contained in:
Georgy Litvinov 2020-12-13 14:03:25 +01:00
parent 4e16ed01c2
commit 1e4ee37f89
566 changed files with 3340 additions and 176 deletions

View file

@ -0,0 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<tree_view version="02-nov-2014">
<help_section application="writer2latex" id="w2l01_writer" title="Writer2LaTeX">
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/introduction.xhp">Introduction</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/menu.xhp">Menu and toolbar</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/bibtex.xhp">BibTeX references</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/export.xhp">LaTeX export</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/logviewer.xhp">View log files</topic>
<!--<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/import.xhp">LaTeX import</topic>-->
<node id="w2l01_writer_toolbar_configuration" title="Toolbar configuration">
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/applications.xhp">Applications</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/bibliography.xhp">Bibliography</topic>
</node>
<node id="w2l01_writer_configuration" title="Custom format">
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Introduction.xhp">Introduction</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Documentclass.xhp">Documentclass</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Headings.xhp">Headings</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Styles.xhp">Styles</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Characters.xhp">Characters</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Fonts.xhp">Fonts</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Pages.xhp">Pages</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Tables.xhp">Tables</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Figures.xhp">Figures</topic>
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/Configuration/Textandmath.xhp">Text and math</topic>
</node>
</help_section>
</tree_view>

View file

@ -0,0 +1,74 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-characters" indexer="include">
<title xml-lang="en-US">Characters</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Characters.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Characters</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define how to convert character formatting</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Characters</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">Character formatting packages</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseHyperref" id="bm_configusehyperref"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use hyperref.sty (support for hyperlinks)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to export hyperlinks using the LaTeX package
hyperref.sty. As a side effect this package will create links for cross references etc.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseColor" id="bm_configusecolor"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use color.sty (color support)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want color support (text color only) using the
LaTeX package color.sty.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseUlem" id="bm_configuseulem"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use ulem.sty (underline and strike out text)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to support underlined and striked out text using the LaTeX
package ulem.sty. Note that this does not work well for longer passages of text. Writer2LaTeX will never export
underline and strike out for entire paragraphs.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigFormattingAttribute" id="bm_configformattingattribute"/>
<paragraph role="heading" level="2" xml-lang="en-US">Formatting attributes</paragraph>
<paragraph role="paragraph" xml-lang="en-US">For some formatting attributes you can directly control the generated LaTeX
code.</paragraph>
<paragraph role="heading" level="3" xml-lang="en-US">Formatting attribute</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select the formatting attribute:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Bold</emph>: Boldface text</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Italics</emph>: Italics text</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Small caps</emph>: Text formatted as small caps.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Superscript</emph>: Text formatted as superscript.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Subscript</emph>: Text formatted as subscript.</paragraph>
</listitem>
</list>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigCustomAttribute" id="bm_configcustomattribute"/>
<paragraph role="heading" level="3" xml-lang="en-US">Apply custom LaTeX code</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to define custom LaTeX code for the currently selected
attribute. Otherwise Writer2LaTeX will use default code, e.g. \textbf for boldface text.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigAttributeBefore" id="bm_configattributebefore"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX code before</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the LaTeX code to add before the text, e.g. <emph>\emph{</emph></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigAttributeAfter" id="bm_configattributeafter"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX code after</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the LaTeX code to add after the text, e.g. <emph>}</emph></paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,39 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-documentclass" indexer="include">
<title xml-lang="en-US">Documentclass</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Documentclass.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Documentclass</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define the documentclass for the LaTeX document</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Documentclass</emph>
</section>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNoPreamble" id="bm_confignopreamble"/>
<paragraph role="heading" level="3" xml-lang="en-US">Do not include preamble</paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you check this option, Writer2LaTeX will not create the a LaTeX preamble,
nor include \begin{document} and \end{document}. This is useful if the document is to be included in another LaTeX document.
Note that in this case you will have to make sure that all packages/definitions needed are available in the master
LaTeX document.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigDocumentclass" id="bm_configdocumentclass"/>
<paragraph role="heading" level="3" xml-lang="en-US">Documentclass</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Type the name of the LaTeX documentclass to use (e.g.
<emph>article</emph>, <emph>book</emph>).</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigGlobalOptions" id="bm_configglobaloptions"/>
<paragraph role="heading" level="3" xml-lang="en-US">Global options</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Type a list of global options to add to the documentclass, e.g. <emph>landscape</emph>
to get \documentclass[landscape]{article}.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigCustomPreamble" id="bm_configcustompreamble"/>
<paragraph role="heading" level="3" xml-lang="en-US">Custom preamble</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The text you type here will be copied verbatim into the LaTeX preamble.
For example <emph>\usepackage{palatino}</emph> to typeset your document using the postscript font Palatino.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,57 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-figures" indexer="include">
<title xml-lang="en-US">Styles</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Figures.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Figures</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define how to convert figures</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Figures</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">General</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseCaption" id="bm_configusecaption"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use caption.sty to format captions (also for tables)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to take advantage of the LaTeX package caption.sty.
Currently Writer2LaTeX only uses the support for non-floating captions from this package.
This applies to all captions (figure and table captions).</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigAlignFrames" id="bm_configalignframes"/>
<paragraph role="heading" level="3" xml-lang="en-US">Center figures</paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you check this, all graphics and text boxes will be centered.
Otherwise standard formatting is applied (this normally means that they will appear flush left).</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigFigureSequenceName" id="bm_configfiguresequencename"/>
<paragraph role="heading" level="3" xml-lang="en-US">Figure sequence names</paragraph>
<paragraph role="paragraph" xml-lang="en-US">This option can be set to a sequence name in the source document.
OpenDocument has a very weak sense of figure captions: A figure caption is a paragraph containing a sequence number.
If you use %PRODUCTNAME's defaults, Writer2LaTeX can guess which sequence name to use.
If it fails, you can type the name here, or select the name from the list. (Note that %PRODUCTNAME Writer has four
basic sequence names which always will be displayed in English here. These are Drawing, Illustration, Table, Text.)
Normally this field should be left empty.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Graphics</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNoImages" id="bm_confignoimages"/>
<paragraph role="heading" level="3" xml-lang="en-US">Do not export graphics</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to ignore all graphics in the export.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigRemoveGraphicsExtension" id="bm_configremovegraphicsextension"/>
<paragraph role="heading" level="3" xml-lang="en-US">Omit file extension</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to export file names for images without file extension.
You will thus get eg. \includegraphics{myimage} rather than \includegraphics{myimage.png}.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigImageOptions" id="bm_configimageoptions"/>
<paragraph role="heading" level="3" xml-lang="en-US">Graphic options</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Type any options that should be applied to all images
(ie. all \includegraphics commands). For example <emph>width=\linewidth</emph>.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,51 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-fonts" indexer="include">
<title xml-lang="en-US">Fonts</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Fonts.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Fonts</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define the font packages to use in the exported LaTeX document</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Fonts</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">Font packages (not used for XeTeX)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">These options have no effect if the backend is XeTeX, which handles
fonts quite differently from "classic" LaTeX.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUsePifont" id="bm_configusepifont"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use pifont.sty (dingbats)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use of symbol font Zapf Dingbats using the LaTeX package
pifont.sty.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseTipa" id="bm_configusetipa"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use tipa.sty and tipax.sty (phonetic symbols)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use phonetic symbols using the LaTeX packages
tipa.sty and tipx.sty.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseEurosym" id="bm_configuseeurosym"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use eurosym.sty (euro currency symbol)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the eurosym font using the LaTeX package
eurosym.sty. This package provides a slightly better euro symbol than standard LaTeX.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseWasysym" id="bm_configusewasysym"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use wasysym.sty (various symbols)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the wasy symbol font using the LaTeX package
wasysym.sty.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseIfsym" id="bm_configuseifsym"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use ifsym.sty (geometric shapes)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the ifsym symbol font using the LaTeX package
ifsym.sty.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseBbding" id="bm_configusebbding"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use bbding.sty (metafont dingbats)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the bbding symbol font (a clone of Zapf Dingbats)
using the LaTeX package bbding.sty.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,70 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-export" indexer="include">
<title xml-lang="en-US">Headings</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Headings.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Headings</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define the conversion of headings in the document</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Headings</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">Headings</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigMaxLevel" id="bm_configmaxlevel"/>
<paragraph role="heading" level="3" xml-lang="en-US">Heading levels to export</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Choose the number of heading levels you want to export as LaTeX sectioning commands.
Other headings are exported as ordinary paragraphs.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigWriterLevel" id="bm_configwriterlevel"/>
<paragraph role="heading" level="3" xml-lang="en-US">Writer level</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Choose a heading level to configure.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigLaTeXLevel" id="bm_configlatexlevel"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX level</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Choose the heading level in LaTeX to use for the selected Writer level.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The standard document classes uses this level numbering</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>\part</emph>: Level -1</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>\chapter</emph>: Level 0</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>\section</emph>: Level 1</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>\subsection</emph>: Level 2</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>\subsubsection</emph>: Level 3</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>\paragraph</emph>: Level 4</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>\supparagraph</emph>: Level 5</paragraph>
</listitem>
</list>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigLaTeXName" id="bm_configLaTeXName"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX heading name</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the name of the section command in LaTeX, e.g. <emph>section</emph> to
produce a \section, or select a standard section command from the list.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Indexes and tables</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNoIndex" id="bm_confignoindex"/>
<paragraph role="heading" level="3" xml-lang="en-US">Do not include indexes</paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you check this option, Writer2LaTeX will not export indexes
(e.g. table of contents, bibliopgrahy). This option is intended for the case that the document is to be part
of a larger LaTeX document, which may contain global indexes.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,24 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-introduction" indexer="include">
<title xml-lang="en-US">Custom format</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Introduction.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Custom format</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define a custom format for the LaTeX export</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX</emph>
</section>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigIntroduction" id="bm_configintroduction"/>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX comes with a number of predefined LaTeX formats.
A format defines the kind of LaTeX document to generate (the document class to use and the packages to load).
It also defines a set of rules defining how content and formatting should be exported to LaTeX. Advanced users can define
their own format on these pages. This requires some knowledge of LaTeX.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">To use the custom format, choose <emph>Custom</emph> in the export dialog.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,52 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-pages" indexer="include">
<title xml-lang="en-US">Pages</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Pages.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Pages</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define how to convert page formatting</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Pages</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">Page geometry (page size and margins)</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigExportGeometry" id="bm_configexportgeometry"/>
<paragraph role="heading" level="3" xml-lang="en-US">Export page geometry</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to export the page geometry. Otherwise the default
page geometry of the documentclass will be used.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseGeometry" id="bm_configusegeometry"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use geometry.sty</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use package geometry.sty to export the geometry of the page.
Otherwise the geometry will be exported using low level LaTeX commands.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigExportHeaderFooter" id="bm_configexportheaderfooter"/>
<paragraph role="heading" level="2" xml-lang="en-US">Export header and footer</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to export the contents of the header and the footer.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseFancyhdr" id="bm_configusefancyhdr"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use fancyhdr.sty</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the package fancyhdr.sty to export the header and footer of the page.
Otherwise the header and footer will be exported using low level LaTeX page style commands.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Page numbers</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseLastpage" id="bm_configuselastpage"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use lastpage.sty</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this option to use the package lastpage.sty to represent the page count.
Otherwise the page count is not exported (e.g. content like "page 3 of 7" cannot be exported).</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Endnotes</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseEndnotes" id="bm_configuseendnotes"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use endnotes.sty</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the package endnotes.sty to format the endnotes in the
LaTeX document. Otherwise endnotes will be converted to footnotes.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,137 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-styles" indexer="include">
<title xml-lang="en-US">Styles</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Styles.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Styles</paragraph>
<paragraph role="paragraph" xml-lang="en-US">On this page you can define mappings from styles in %PRODUCTNAME Writer
to your own LaTeX styles.</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Styles</emph>
</section>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigStyleFamily" id="bm_configstylefamily"/>
<paragraph role="heading" level="3" xml-lang="en-US">Style family</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select a style family:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Character</emph>: Define LaTeX code for character styles</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Paragraph</emph>: Define LaTeX code for paragraph styles</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Paragraph block</emph>: Define LaTeX code for a block of paragraphs
starting with a specific paragraph style.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>List</emph>: Define LaTeX code for list styles
(e.g. enumerate or itemize).</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>List item</emph>: Define LaTeX code for individual list items.</paragraph>
</listitem>
</list>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigStyleName" id="bm_configstylename"/>
<paragraph role="heading" level="3" xml-lang="en-US">Style name</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select an %PRODUCTNAME Writer style name from the list.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNewStyle" id="bm_confignewstyle"/>
<paragraph role="heading" level="3" xml-lang="en-US">New...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to add a new style to the list. Select a style in the list
or type a style name.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigDeleteStyle" id="bm_configdeletestyle"/>
<paragraph role="heading" level="3" xml-lang="en-US">Delete...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to delete the current style name from the list.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigBefore" id="bm_configbefore"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX code before</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the LaTeX code to add before this particular style, e.g.
<emph>\begin{center}</emph> or <emph>\textbf{</emph>.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigAfter" id="bm_configafter"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX code after</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the LaTeX code to add after this particular style, e.g.
<emph>\end{center}</emph> or <emph>}</emph>.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNext" id="bm_confignext"/>
<paragraph role="heading" level="3" xml-lang="en-US">Next style(s)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">This is only used for paragraph blocks: Paragraphs formatted with a style from
this list are included in the block.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigAddNext" id="bm_configaddnext"/>
<paragraph role="heading" level="3" xml-lang="en-US">Add...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to add another style to the list of next styles.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigRemoveNext" id="bm_configremovenext"/>
<paragraph role="heading" level="3" xml-lang="en-US">Remove...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to remove the current style from the list of next styles.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigVerbatim" id="bm_configverbatim"/>
<paragraph role="heading" level="3" xml-lang="en-US">Verbatim content</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to export the content as verbatim LaTeX. This implies that
characters not available in the inputencoding are converted to question marks and that other content is discarded,
eg. footnotes.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigLineBreak" id="bm_configlinebreak"/>
<paragraph role="heading" level="3" xml-lang="en-US">Line break inside</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to add line breaks inside the LaTeX construction surrounding
this element. You will probably want this for a construction like <emph>\begin{center}...\end{center}</emph> but not for
a construction like <emph>\textbf{...}</emph>.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigLoadDefaults" id="bm_configloaddefaults"/>
<paragraph role="heading" level="3" xml-lang="en-US">Load default mappings</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX comes with a set of default style mappings corresponding to
some of the predefined styles in %PRODUCTNAME Writer. Click this button to add these mappings to the current set. You will get
a warning if this will overwrite one or more existing mappings.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigOtherStyles" id="bm_configotherstyles"/>
<paragraph role="heading" level="3" xml-lang="en-US">Other styles</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select how you want to export paragraphs and text with a style for which no style
mapping has been defined. This enables you to ensure that only content with accepted styles is exported.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Ignore</emph>: The content is ignored silently.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Convert</emph>: The content is converted as normal.</paragraph>
</listitem>
</list>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigFormatting" id="bm_configformatting"/>
<paragraph role="heading" level="3" xml-lang="en-US">Other formatting</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select how you want to export formatting for styles that does not have
a style mapping.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Ignore all</emph>: Ignore all character, paragraph,
heading, list and footnote formatting contained in the document.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Ignore most</emph>: Convert basic character
formatting.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Convert basic</emph>: Convert basic character formatting,
paragraph justification and all numberings (lists, headings, footnotes).</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Convert most</emph>: Convert all supported formatting, except
that paragraph formatting and font size is only converted if it is set by a style. To be able to preserve
formatting, an environment is created for all paragraph styles, custom lists are used for listings, headings are
reformatted using the \@startsection command etc.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Convert all</emph>: Convert all supported formatting.</paragraph>
</listitem>
</list>
</body>
</helpdocument>

View file

@ -0,0 +1,74 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-tables" indexer="include">
<title xml-lang="en-US">Tables</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Tables.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Tables</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define how to convert tables</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Tables</emph>
</section>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNoTables" id="bm_confignotables"/>
<paragraph role="heading" level="3" xml-lang="en-US">Do not export tables</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this option to ignore all tables in the export.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseColortbl" id="bm_configusecolortbl"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use colortbl.sty (background color in cells)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to apply background color to tables using the
package colortbl.sty. This option has no effect unless you also check <emph>Use color.sty</emph> on the page
<emph>Characters</emph>.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseTabulary" id="bm_configusetabulary"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use tabulary.sty (automatic column width)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if tabulary.sty should be used to export tables.
This package determines column widths automatically which can be useful for tables with a lot of text in each cell.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseSupertabular" id="bm_configusesupertabular"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use supertabular.sty (multipage tables)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the package supertabular.sty to export tables which may break
across pages.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseLongtable" id="bm_configuselongtable"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use longtable.sty (multipage tables)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the package longtable.sty to export tables which may break
across pages.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTableFirstHeadStyle" id="bm_configtablefirstheadstyle"/>
<paragraph role="heading" level="3" xml-lang="en-US">Style for first head</paragraph>
<paragraph role="paragraph" xml-lang="en-US">This option is used to produce advanced tables, that are not supported in
%PRODUCTNAME Writer. Enter the name of a paragraph style, or select a style in the list.
If the first paragraph of the first cell in a row is formatted
with this paragraph style, the row in question will be used for the first head in a multipage table.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTableHeadStyle" id="bm_configtableheadstyle"/>
<paragraph role="heading" level="3" xml-lang="en-US">Style for head</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Likewise this option specifies a paragraph style that identifies a
repeating head in a multipage table (like a normal table head in %PRODUCTNAME Writer).</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTableFootStyle" id="bm_configtablefootstyle"/>
<paragraph role="heading" level="3" xml-lang="en-US">Style for foot</paragraph>
<paragraph role="paragraph" xml-lang="en-US">This option specifies a paragraph style that identifies a repeating foot in a
multipage table.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTableLastFootStyle" id="bm_configtablelastfootstyle"/>
<paragraph role="heading" level="3" xml-lang="en-US">Style for last foot</paragraph>
<paragraph role="paragraph" xml-lang="en-US">This option specifies a paragraph style that identifies the last foot in a
multipage table.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTableSequenceName" id="bm_configtablesequencename"/>
<paragraph role="heading" level="3" xml-lang="en-US">Table sequence name</paragraph>
<paragraph role="paragraph" xml-lang="en-US">This option can be set to a sequence name in the source document.
OpenDocument has a very weak sense of table captions: A table caption is a paragraph containing a sequence number.
If you use %PRODUCTNAME's defaults, Writer2LaTeX can guess which sequence name to use.
If it fails, you can type the name here, or select the name from the list. (Note that %PRODUCTNAME Writer has four
basic sequence names which always will be displayed in English here. These are Drawing, Illustration, Table, Text.)
Normally this field should be left empty.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,82 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-configuration-textandmath" indexer="include">
<title xml-lang="en-US">Text and math</title>
<filename>org.openoffice.da.writer2latex.oxt/Configuration/Textandmath.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Text and math</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Define how to convert text strings and math content.</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>Tools - Options - Writer2LaTeX - Text and math</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">Math packages</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigUseOoomath" id="bm_configuseooomath"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use ooomath.sty (custom package supporting %PRODUCTNAME equations)</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to use the LaTeX package ooomath.sty. This package defines a number of
LaTeX macros used to convert formulas from %PRODUCTNAME to LaTeX. If this package is not used, the necessary definitions will
be included in the LaTeX preamble, which may become quite long. Hence using ooomath.sty is recommended for documents with
formulas. The package is part of the complete
<link href="http://writer2latex.sourceforge.net" name="Writer2LaTeX home page">Writer2LaTeX distribution</link>.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Math symbols</paragraph>
<paragraph role="paragraph" xml-lang="en-US">In %PRODUCTNAME Math you can add user-defined symbols. Writer2LaTeX already
understands the predefined symbols such as %alpha. If you define your own symbols, you can define corresponding LaTeX
code here.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigMathSymbolName" id="bm_configmathsymbolname"/>
<paragraph role="heading" level="3" xml-lang="en-US">Name</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select the name of the user-defined symbol.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNewSymbol" id="bm_configdeletesymbol"/>
<paragraph role="heading" level="3" xml-lang="en-US">New...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to add a new symbol to the list. Select a symbol from the list
or type the name.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigDeleteSymbol" id="bm_configdeletesymbol"/>
<paragraph role="heading" level="3" xml-lang="en-US">Delete...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to delete the current symbol from the list.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigMathLaTeX" id="bm_configmathlatex"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX code</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the LaTeX code corresponding to this symbol, e.g.
<emph>\Downarrow</emph>.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Text replace</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Often LaTeX requires special care to typeset certain constructions. For example
according to German typographical rules, an abbreviation like z.B. should be typeset with a small space before the B, which in
LaTeX code will be <emph>z.\,B</emph>. Another example is French quotations marks (« Je parle français ») which should be
converted to the LaTeX macros <emph>\fg</emph> and <emph>\og</emph>. A final example is translation of the text LaTeX to
<emph>\LaTeX</emph> to properly typeset the LaTeX logo.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTextInput" id="bm_configtextinput"/>
<paragraph role="heading" level="3" xml-lang="en-US">Input</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select a text string from the list</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigNewText" id="bm_confignewtext"/>
<paragraph role="heading" level="3" xml-lang="en-US">New...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to add a new text string to the list. Enter the original text as it appears
in the %PRODUCTNAME Writer document, or paste text from the clipboard.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigDeleteText" id="bm_configdeletetext"/>
<paragraph role="heading" level="3" xml-lang="en-US">Delete...</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to the delete the current text string. Writer2LaTeX has
a few predefined strings that cannot be deleted.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTextLaTeX" id="bm_configtextlatex"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX code</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the LaTeX code to export for this text string.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Tab stops</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigTabStopLaTeX" id="bm_configtabstoplatex"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX code</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Normally tab stops are converted to spaces, but in this field you can enter any
LaTeX code, that should be used instead. For example <emph>\quad{}</emph> or <emph>\hspace{2em}</emph>.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,144 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-applications" indexer="include">
<title xml-lang="en-US">Applications</title>
<filename>org.openoffice.da.writer2latex.oxt/applications.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigurationDialog" id="bm_configurationdialog"/>
<paragraph role="heading" level="1" xml-lang="en-US">Configuration of applications</paragraph>
<paragraph role="paragraph" xml-lang="en-US">On this page you can configure the interaction between Writer2LaTeX
and your LaTeX distribution as well as viewers for the different output formats.</paragraph>
<section id="howtoget" xml-lang="en-US">
Select <emph>Tools - Options - Writer2LaTeX toolbar - Applications</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">Prerequisites</paragraph>
<paragraph role="paragraph" xml-lang="en-US">This requires that you have installed certain software on your system.</paragraph>
<switch select="sys">
<case select="WIN">
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX needs a working LaTeX distribution<!-- including TeX4ht-->.
MikTeX is recommended and can be downloaded from
<link href="http://www.miktex.org" name="MikTeX download">http://www.miktex.org</link>.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">In addition, you should install viewers for PDF and PostScript files.
Gsview is recommended and can be downloaded from
<link href="http://pages.cs.wisc.edu/~ghost/gsview/" name="gsview download">http://pages.cs.wisc.edu/~ghost/gsview/</link>.
Note that you have to install ghostscript as well (follow the links on the web site).</paragraph>
</listitem>
</list>
</case>
<case select="UNIX">
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX needs a working LaTeX distribution<!-- which includes TeX4ht-->.
<link href="http://www.tug.org/texlive/" name="TeX live">TeX live</link>
is recommended and is available for most UNIX-like systems. The installation depends on your system.
If you are using Debian or Ubuntu you can for example install the basic required packages by typing these commands from a terminal window:</paragraph>
<paragraph role="code" xml-lang="en-US">sudo apt-get install texlive
<br/>sudo apt-get install texlive-latex-extra
<br/>sudo apt-get install texlive-xetex
<!--<br/>sudo apt-get install tex4ht--></paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Also you should install viewers for DVI, PDF and PostScript files.
The viewers evince and okular can handle all formats and are recommended.
You can also use a combination of the viewers xdvi, xpdf and ghostview.
</paragraph>
</listitem>
</list>
</case>
<case select="MAC">
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX needs a working LaTeX distribution<!-- which includes TeX4ht-->.
</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Also you should install viewers for DVI, PDF and PostScript files.
</paragraph>
</listitem>
</list>
<paragraph xml-lang="en-US"><emph>Note</emph>: The Writer2LaTeX toolbar is not tested on Mac OS X.</paragraph>
</case>
</switch>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:AfterExport" id="bm_afterexport"/>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:AfterExport" visibility="hidden">Choose the desired behavior after export</ahelp></paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">After Export</paragraph>
<paragraph role="paragraph" xml-lang="en-US">After Export, Writer2LaTeX can build the result with LaTeX and display the final document in a viewer. Choose the desired behavior in the list.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Do nothing</emph> will only export the document to LaTeX</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Build with LaTeX</emph> will build the converted document with LaTeX to produce the final result in DVI, PDF or PostScript format</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Build with LaTeX and view result</emph> will display the final result in a DVI, PDF or PostScript viewer</paragraph>
</listitem>
</list>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigurationAutoButton" id="bm_configurationautobutton"/>
<paragraph role="heading" level="2" xml-lang="en-US">Automatic Configuration</paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you click this button, Writer2LaTeX will try to locate the external programs
and configure them. You will be presented with a short report of the results. Any applications that Writer2LaTeX cannot find for
you should be configured manually.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ConfigurationAutoButton" visibility="hidden">Click here to let Writer2LaTeX configure your external applications automatically</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigurationApplication" id="bm_configurationapplication"/>
<paragraph role="heading" level="2" xml-lang="en-US">Application</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select the external application you wish to configure in the list.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The available applications are:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">PdfLaTeX: The pdflatex executable (used if you select PDF as your backend format)</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">LaTeX: The latex executable (used for other backend formats)</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Dvips: The DVI to PostScript converter dvips (used if you select PostScript as your backend format)</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">BibTeX: The bibtex executable (used if your document contains a bibliography)</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">MakeIndex: The makeindex executable (used if your document contains an alphabetical index)</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">DVI Viewer: Application to view DVI files</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">PDF Viewer: Application to view PDF files</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">PostScript Viewer: Application to view PostScript files</paragraph>
</listitem>
</list>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ConfigurationApplication" visibility="hidden">Select the external application you wish to configure here</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:UseDefault" id="bm_configurationusedefault"/>
<paragraph role="heading" level="2" xml-lang="en-US">Use the system's default application</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select this if you wish to use the default application to view files
of the selected type.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:UseDefault" visibility="hidden">Select this to use the default application to view files of the selected type</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigurationExecutable" id="bm_configurationexecutable"/>
<paragraph role="heading" level="2" xml-lang="en-US">Executable</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Type the full path to the executable or click <emph>Browse</emph> to find
the executable in your file system</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ConfigurationExecutable" visibility="hidden">Type the full path to the executable here or find it using the Browse button</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ConfigurationOptions" id="bm_configurationoptions"/>
<paragraph role="heading" level="2" xml-lang="en-US">Options</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Fill out any additional options here. Often you will only need the file name,
which is denoted <emph>%s</emph>.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ConfigurationOptions" visibility="hidden">Fill out any additional options here, using %s to represent the file name</ahelp></paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,143 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-bibliography" indexer="include">
<title xml-lang="en-US">Bibliography</title>
<filename>org.openoffice.da.writer2latex.oxt/bibliography.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyDialog" id="bm_bibliographydialog"/>
<paragraph role="heading" level="1" xml-lang="en-US">Configuration of bibliography</paragraph>
<paragraph role="paragraph" xml-lang="en-US">On this page you can configure the use of BibTeX as bibliography
database in %PRODUCTNAME Writer.</paragraph>
<section id="howtoget" xml-lang="en-US">
Select <emph>Tools - Options - Writer2LaTeX toolbar - Bibliography</emph>
</section>
<paragraph role="heading" level="2" xml-lang="en-US">Using BibTeX as bibliography database</paragraph>
<paragraph role="paragraph" xml-lang="en-US">%PRODUCTNAME Writer comes with a standard bibliography database.
Citations can be created from the content of the database.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">On the other hand, LaTeX traditionally stores bibliographic
information in the BibTeX database format.
The Writer2LaTeX toolbar enables you to use BibTeX databases directly in %PRODUCTNAME Writer.
With this feature you can create citations from a BibTeX file rather than from the standard bibliography database.
</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The following sections describe four different
ways to handle bibliograhic citations.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Using the standard bibliography database</paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you want to use the standard tools in %PRODUCTNAME Writer
to manage and create citations, you should not make any settings to this page.
Upon export, Writer2LaTeX can convert to and format your citations with BibTeX.
You can enable this in the export dialog.
</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyUseExternalBibTeXFiles" id="bm_useexternalbibtexfiles"/>
<paragraph role="heading" level="2" xml-lang="en-US">Use BibTeX as bibliography database</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyUseExternalBibTeXFiles" visibility="hidden">Check this to enable the insertion of citations from BibTeX file(s)</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this to enable the use of BibTeX as bibliograhy database.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">You can then use the
<link href="org.openoffice.da.writer2latex.oxt/bibtex.xhp"
name="Writer2LaTeX toolbar">Writer2LaTeX toolbar</link> to insert citations from BibTeX files.
Upon export, Writer2LaTeX can format your citations with BibTeX using the original BibTeX files.
You can enable this in the export dialog.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyBibTeXLocation" id="bm_bibtexlocation"/>
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX location</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX will look for BibTeX files in the location you define.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>In central folder</emph>: Select this option if you keep all your
BibTeX files in a central location.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>In subfolder of document folder</emph>: Select this option if you
want to use project-specific BibTeX files. For example using a folder named "bibliography" relative to the document
folder.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>In document folder</emph>: Select this option if you want to
keep your BibTeX files in the same folder as the document. <emph>Warning</emph>: In this case you should not use the
same name for the LaTeX file and the BibTeX file (your BibTeX file might be overwritten if you do).</paragraph>
</listitem>
</list>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyBibTeXLocation" visibility="hidden">Select the type of location for your BibTeX files</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyBibTeXDir" id="bm_bibtexdir"/>
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX folder</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter the path to the folder containing your BibTeX files, or select the folder
using the <emph>Browse</emph>-button.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyBibTeXDir" visibility="hidden">Enter the path to the folder containing the BibTeX files</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyBibTeXDirButton" id="bm_bibtexdirbutton"/>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyBibTeXDirButton" visibility="hidden">Click to select the path to the folder containing the BibTeX files</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyBibTeXEncoding" id="bm_bibtexencoding"/>
<paragraph role="heading" level="3" xml-lang="en-US">File encoding</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select the encoding of the BibTeX files (this will depend on your
BibTeX editor). If you use XeTeX as a backend, you should always use UTF-8.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyConvertZoteroCitations" id="bm_convertzoterocitations"/>
<paragraph role="heading" level="2" xml-lang="en-US">Convert Zotero citations</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><link href="http://www.zotero.org" name="Link to the Zotero Website">Zotero</link>
is a free, easy-to-use tool to help you collect, organize, cite, and share your research sources.
Zotero provides a plugin for %PRODUCTNAME which permits you to insert citations from Zotero in your
%PRODUCTNAME Writer document using a selection of citation schemes.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to convert Zotero citations to LaTeX.
This enables you to format the citations using a BibTeX style of your choice.
Also, the bibliography created by Zotero will be replaced with a BibTeX-generated bibliography.
If you do not check this option, the original
citation text inserted by Zotero will be used.</paragraph>
<paragraph role="heading" level="3" xml-lang="en-US">Exporting your Zotero database to BibTeX</paragraph>
<paragraph role="paragraph" xml-lang="en-US">To use this feature you must export your Zotero database to the specified
folder.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The Writer2LaTeX distribution contains a folder named <emph>Zotero</emph>,
which contains a file called <emph>BibTeX-Writer2LaTeX.js</emph>. This file must be added to Zotero to provide a suitable
BibTeX export: In Zotero, choose <emp>Edit</emph> - <emph>Preferences</emph> - <emph>Advanced</emph> and click <emph>Show Data Directory</emph>.
Open the subfolder <emph>Translators</emph>, and copy <emph>BibTeX-Writer2LaTeX.js</emph> to this location.
Finally restart Zotero.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">You can now export your Zotero database: In Zotero, select
<emph>File</emph> - <emph>Export Library</emph>, and choose <emph>BibTeX (Writer2LaTeX)</emph> (not <emph>BibTeX</emph>).
Save the file in the folder, you have defined.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyConvertZoteroCitations" visibility="hidden">Check this to convert Zotero citations to LaTeX</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyConvertJabRefCitations" id="bm_convertjabrefcitations"/>
<paragraph role="heading" level="2" xml-lang="en-US">Convert JabRef citations</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><link href="http://jabref.sourceforge.net/" name="Link to the JabRef Website">JabRef</link>
is an open source bibliography reference manager using BibTeX as native file format.
You can use JabRef to edit your BibTeX files.
In addition JabRef permits you to insert citations directly from JabRef in your %PRODUCTNAME Writer document
using a selection of citation schemes.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to convert JabRef citations to LaTeX.
This enables you to format the citations using a BibTeX style of your choice.
Also, the bibliography created by JabRef will be replaced with a BibTeX-generated bibliography.
If you do not check this option, the original
citation text inserted by JabRef will be used.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyConvertJabRefCitations" visibility="hidden">Check this to convert JabRef citations to LaTeX</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyIncludeOriginalCitations" id="bm_includeoriginalcitations"/>
<paragraph role="heading" level="3" xml-lang="en-US">Include original citations as comments</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Check this if you want to include the original citations produced by Zotero or
JabRef as comments in the LaTeX source. This has no effect on the final result but might be helpful if you edit the LaTeX source.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyIncludeOriginalCitations" visibility="hidden">Check this to include the citations inserted by Zotero or JabRef as comments in the LaTeX source.</ahelp></paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Natbib</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyUseNatbib" id="bm_usenatbib"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use natbib.sty</paragraph>
<paragraph role="paragraph" xml-lang="en-US">To fully support the citations inserted by Zotero or JabRef you will need
the package natbib.sty. Check this if you want to take advantage of this package (the BibTeX style you use must be compatible
with natbib.sty).</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyUseNatbib" visibility="hidden">Check this to use the package natbib.sty for your citations</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibliographyNatbibOptions" id="bm_natbiboptions"/>
<paragraph role="heading" level="3" xml-lang="en-US">Options</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Enter any options to the package natbib.sty here.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibliographyNatbibOptions" visibility="hidden">Enter any options to the package natbib.sty here</ahelp></paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,78 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-bibtex" indexer="include">
<title xml-lang="en-US">Insert BibTeX references</title>
<filename>org.openoffice.da.writer2latex.oxt/bibtex.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXDialog" id="bm_bibtexdialog"/>
<paragraph role="heading" level="1" xml-lang="en-US">Manage BibTeX reference</paragraph>
<paragraph role="paragraph" xml-lang="en-US">BibTeX is the standard database format for bibliographic references
in LaTeX.
This dialog is used to insert bibliographic references in %PRODUCTNAME Writer from BibTeX files.
This enables you to maintain your references in BibTeX, rather that using the bibliography database
in %PRODUCTNAME Writer.
</paragraph>
<section id="howtoget" xml-lang="en-US">
Click the <emph>Bib</emph>-button on the toolbar
</section>
<paragraph role="paragraph" xml-lang="en-US">The dialog presents a list of BibTeX files from a specific folder.
The folder to search is configured in the <link href="org.openoffice.da.writer2latex.oxt/bibliography.xhp"
name="Bibliography settings">bibliography settings</link>.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Using the dialog</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXFile" id="bm_bibtexfile"/>
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX file</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select the BibTeX file to use in this list.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXFile" visibility="hidden">Select the BibTeX file to use</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXEntry" id="bm_bibtexentry"/>
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX entry</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select the entry to use in this list. The list contains the keys of
all entries in the selected BibTeX file.
Basic information about the entry is displayed in the field below the list.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXEntry" visibility="hidden">Select the entry to use</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXInsert" id="bm_bibtexinsert"/>
<paragraph role="heading" level="3" xml-lang="en-US">Insert reference</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to insert a bibliographic reference to
the currently selected entry.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXInsert" visibility="hidden">Click to insert a reference to the current entry</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXUpdate" id="bm_bibtexupdate"/>
<paragraph role="heading" level="3" xml-lang="en-US">Update references</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this to update all bibliographic references in the document.
You should do this if you have edited a BibTeX file. This will ensure that
the content of all references is in sync with the current content of the BibTeX files.
Writer2LaTeX will display a message to confirm the result.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXUpdate" visibility="hidden">Click to update the content of all references</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXClose" id="bm_bibtexclose"/>
<paragraph role="heading" level="3" xml-lang="en-US">Close</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to close the dialog.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXClose" visibility="hidden">Click to close the dialog</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXNew" id="bm_bibtexnew"/>
<paragraph role="heading" level="3" xml-lang="en-US">New</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button create a new BibTeX file in the configured
directory. Enter a name for the file in the dialog.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXNew" visibility="hidden">Click to create a new BibTeX file</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXEdit" id="bm_bibtexedit"/>
<paragraph role="heading" level="3" xml-lang="en-US">Edit</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to edit the currently selected BibTeX file.
The file will open in your default BibTeX editor. If no default BibTeX editor was found on your system,
an error message is displayed.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXEdit" visibility="hidden">Click to edit the current file in your BibTeX editor</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:BibTeXReload" id="bm_bibtexreload"/>
<paragraph role="heading" level="3" xml-lang="en-US">Reload</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Click this button to reload the BibTeX files in the dialog.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:BibTeXReload" visibility="hidden">Click to reload the BibTeX files</ahelp></paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,430 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-export" indexer="include">
<title xml-lang="en-US">LaTeX Export</title>
<filename>org.openoffice.da.writer2latex.oxt/export.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:Options" id="bm_options"/>
<paragraph role="heading" level="1" xml-lang="en-US">LaTeX Export</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Exports the current document in LaTeX 2e format. A LaTeX document can be
typeset with the TeX typesetting system.</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>File - Export - LaTeX 2e</emph> or click the <emph>TeX</emph>-button in the toolbar
</section>
<paragraph role="heading" level="2" xml-lang="en-US">General</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsConfig" id="bm_options_config"/>
<paragraph role="heading" level="3" xml-lang="en-US">LaTeX format</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsConfig" visibility="hidden">Select the general format for the LaTeX document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Conceptually, %PRODUCTNAME Writer and LaTeX are quite different.
A LaTeX document is usually based on a certain "document class", that determines the general layout and formatting of the document.
In addition the use of several LaTeX packages may change various aspects of the LaTeX document.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The result of a conversion into LaTeX will thus depend very much on which
LaTeX packages are used and how much formatting it is desired to preserve.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX offers a number of default formats, all based on the standard LaTeX document class "article".
Each of the formats defines the LaTeX packages to use and the handling of formatting.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Ultra-clean article</emph> will create a very basic LaTeX article,
with almost no formatting preserved.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Clean article</emph> will also create a default LaTeX article,
but does preserve some basic formatting from the %PRODUCTNAME Writer document, such as boldface, color and hyperlinks.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Default</emph> creates a LaTeX article preserving as much formatting
as it is possible without any significant deviations from LaTeX standards.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Print optimized</emph> on the other hand creates a LaTeX article
preserving as much formatting as possible. The result will resemble the %PRODUCTNAME Writer document,
but will look slightly different from a standard LaTeX article (and the LaTeX code will be less readable).</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Screen optimized (pdf)</emph> also creates a LaTeX article preserving
most of the formatting, but optimized for screen viewing (using the package pdfscreen) rather than printing.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Custom</emph> is a user defined format. To configure the custom format,
choose <emph><link href="org.openoffice.da.writer2latex.oxt/Configuration/Introduction.xhp"
name="Custom configuration">Tools - Options - Writer2LaTeX</link></emph>.
</paragraph>
</listitem>
</list>
<paragraph role="paragraph" xml-lang="en-US">Expert users can extend the list with further formats using
<emph>configuration packages</emph>. See the documentation on the
<link href="http://writer2latex.sourceforge.net" name="Link to the Writer2LaTeX Website">web site for Writer2LaTeX</link>.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsBackend" id="bm_options_backend"/>
<paragraph role="heading" level="3" xml-lang="en-US">Backend</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsBackend" visibility="hidden">Select the final format of the exported document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">When processing a LaTeX document, the final result is a document in a certain
backend format. The handling of certain aspects of the document, in particular graphics, depends on the backend.
With this option you can select the backend format.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Generic</emph> will create a LaTeX document that can be processed
with any flavour of LaTeX, usually with a file in DVI format as the result. Graphics is not supported with this backend.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Pdf (pdfTeX)</emph> will create a LaTeX document that is suitable
for processing with pdfLaTeX. Graphics are converted to a format that can be included in pdf files.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Postscript (dvips)</emph> will create a LaTeX document that is
suitable for generating documents in Postscript format, usually by post processing with dvips.
Graphics will be converted to Encapsulated postscript format.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Unspecified</emph> will create a LaTeX document with no
particular backend in mind. All graphics will be exported in the original format,
and it is up to the user to handle them.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" xml-lang="en-US">If you have selected the format Screen optiomized (pdf), you cannot select
the backend, which will always be pdf.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsInputencoding" id="bm_options_inputencoding"/>
<paragraph role="heading" level="3" xml-lang="en-US">Encoding</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsInputencoding" visibility="hidden">Select the character encoding of the LaTeX file</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">A LaTeX document is a text file, which always uses a certain character encoding.
The character encoding is important if the LaTeX file is going to be edited in a text editor:
You should select an encoding that is supported by your text editor. This setting is also important to get optimal support
for international characters: If you for example use pdfTeX, searching in the final pdf document will only work for
characters supported by the selected character encoding.
Currently, Writer2LaTeX supports 8 different encodings which together are suitable for a large number of languages written
with either latin, greek or cyrillic letters.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The supported character encodings are <emph>US ASCII</emph>,
<emph>West European (ISO 8859-1)</emph>, <emph>East European (ISO 8859-2)</emph>, <emph>Latin/Greek (ISO 8859-7)</emph>,
<emph>Microsoft East European (Cp1250)</emph>, <emph>Microsoft Cyrillic (Cp1251)</emph>, <emph>Russian (koi8-r)</emph>
and <emph>Unicode (UTF8)</emph>.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you have selected XeTeX as your backed, the character encoding is always UTF-8.
XeTeX is needed for asian (CJK) and bidirectional (CTL) scripts.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsMultilingual" id="bm_options_multilingual"/>
<paragraph role="heading" level="3" xml-lang="en-US">Enable multilingual support</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsMultilingual" visibility="hidden">Check this if your document contains text in more than one language</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you check this option, all the language settings in the %PRODUCTNAME Writer
document will be exported to LaTeX. Sometimes the language settings in a %PRODUCTNAME Writer document are not correct,
so if you have a document that is written in one language only you may want to uncheck this option.
This will produce a cleaner LaTeX file because you may avoid a large number of language selections.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsFont" id="bm_options_font"/>
<paragraph role="heading" level="3" xml-lang="en-US">Font</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:Font" visibility="hidden">Select a font scheme to use in the LaTeX document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Use this option to select a font scheme to use in the LaTeX document.
</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Default (Computer Modern)</emph> Computer Modern is
the original default font for TeX.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>CM Bright</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Concrete</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Concrete + Euler Math</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Iwona</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Kurier</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Antykwa Toru&#x0144;ska</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Kerkis</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>New Century Schoolbook + Fourier Math</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Palatino + PXfonts Math</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Palatino + Pazo Math</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Palatino + Euler Math</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Times + TXfonts Math</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Times + Symbol</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Arev Sans + Arev Math</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Bitstream Charter + Math Design</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Utopia + Math Design</emph> </paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Utopia + Fourier Math</emph> </paragraph>
</listitem>
</list>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsGreekMath" id="bm_options_greekmath"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use greek letters as symbols</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsGreekMath" visibility="hidden">Check this treat greek characters as symbols rather than as text</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Greek letters used in latin text are often used as symbols, such as the
number π or the word γ-radiation. By checking this option (not available if XeTeX is the backend),
all greek letters used within latin or cyrillic text
will be treated as mathematical symbols, which will produce a slightly better result and also not require that
greek text fonts are available in the LaTeX installation. This option has no effect on greek text (provided the language
is set correctly in the %PRODUCTNAME Writer document).</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsAdditionalSymbols" id="bm_options_additonalsymbols"/>
<paragraph role="heading" level="3" xml-lang="en-US">Support additional symbols</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsAdditionalSymbols" visibility="hidden">Check this to add support for additonal symbols (e.g. phonetic symbols, smileys)</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you select this option (not available if XeTeX is the backend),
LaTeX will load some additional packages containing support for various symbols:
A better looking euro-symbol, phonetic characters, dingbats and various other
symbols and geometric shapes.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Bibliography</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsUseBibtex" id="bm_options_usebibtex"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use BibTeX for bibliography</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsUseBibtex" visibility="hidden">Check this to export the bibliography to BibTeX format</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Usually the bibliography in a LaTeX document is generated by the companion
program BibTeX. If you check this option, all the bibliographic references will be exported to BibTeX format for
later processing with the BibTeX program.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsBibtexStyle" id="bm_options_bibtexstyle"/>
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX style</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsBibtexStyle" visibility="hidden">Enter the name of a BibTeX style to format the bibliography</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you use BibTeX, you should also select a BibTeX style to be used when
generating the bibliography. Select one of the predefined styles <emph>plain</emph>, <emph>unsrt</emph>, <emph>alpha</emph> or
<emph>abbrv</emph> or type the name of any BibTeX style which is available
in your LaTeX installation.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Files</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsWrapLines" id="bm_options_wraplines"/>
<paragraph role="heading" level="3" xml-lang="en-US">Wrap long lines</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsWrapLines" visibility="hidden">Check this if you want to wrap long lines in the LaTeX file</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Checking this option wraps long lines in the generated LaTeX file.
This enhances the readability if the file is later edited in a text editor. If you use a text editor that wraps
lines automatically, you should uncheck this option.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsWrapLinesAfter" id="bm_options_wraplinesafter"/>
<paragraph role="heading" level="3" xml-lang="en-US">After characters</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsWrapLinesAfter" visibility="hidden">Enter the number of characters after which the lines should be wrapped</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you choose to wrap long lines, they will be wrapped as soon as possible
after this number of characters.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsSplitLinkedSections" id="bm_options_splitlinkedsections"/>
<paragraph role="heading" level="3" xml-lang="en-US">Split document at linked sections</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsSplitLinkedSections" visibility="hidden">Check this to create a separate LaTeX file for each linked section</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Checking this option will create separate LaTeX files for sections in
the %PRODUCTNAME Writer document with linked content. This can be an advantage if the LaTeX document is later edited
in a text editor.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsSplitToplevelSections" id="bm_options_splittoplevelsections"/>
<paragraph role="heading" level="3" xml-lang="en-US">Split document at top level sections</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsSplitToplevelSections" visibility="hidden">Check this to create a separate LaTeX file for all sections that are not nested inside another section</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Checking this option will create separate LaTeX files for all top level
sections in the %PRODUCTNAME Writer document (but not for nested sections).</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsSaveImagesInSubdir" id="bm_options_saveimagesinsubdir"/>
<paragraph role="heading" level="3" xml-lang="en-US">Save images in subdirectory</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsSaveImagesInSubdir" visibility="hidden">Check this to save the images in a separate subdirectory</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX normally saves images associated with the document in the same
directory as the LaTeX document. If the document contains a large number of images it may be more convenient to save
the images in a separate subdirectory. This option will create a subdirectory with the same name as the LaTeX document
to store the images.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Special content</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsNotes" id="bm_options_notes"/>
<paragraph role="heading" level="3" xml-lang="en-US">Export notes</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsNotes" visibility="hidden">Select how to export notes in the document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">This option determines how to export notes (also known as annotations)
in the %PRODUCTNAME Writer document.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Do not export</emph> will ignore the notes.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>As comments</emph> will export the notes as comments in the LaTeX file.
They will not be visible in the final document after processing with LaTeX.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>As marginal notes</emph> will put the notes in the margin of the document.
In this case they will be visible in the final document, but beware that the notes will be lost if the margin
is too narrow.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>As pdf annotations</emph> will export the notes as pdf text
annotations. If the pdf viewer supports it, you will be able to read the notes. Adobe Reader displays text annotations
with a yellow icon, which allows you to open and read the note. If the document is not processed with pdfTeX,
the notes will be converted to marginal notes.</paragraph>
</listitem>
</list>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsMetadata" id="bm_options_metadata"/>
<paragraph role="heading" level="3" xml-lang="en-US">Export document properties (metadata)</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsMetadata" visibility="hidden">Check this if you want to export meta data associated with the document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you check this option, Writer2LaTeX will export the title, author and date
of the document as found under File Properties. Furthermore, if you have chosen pdf as the backend, the title, author,
subject and keywords will be exported to the pdf document and will be viewable if the pdf viewer supports it.
If the option is not checked, only the title will be exported.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:DisplayHiddenText" id="bm_display_hidden_text"/>
<paragraph role="heading" level="3" xml-lang="en-US">Display hidden text</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:DisplayHiddenText" visibility="hidden">Check this if you want to export text that is currently hidden in the document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you check this option, Writer2LaTeX will export all text in the
document, even if it is currently hidden.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Figures and tables</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsOriginalImageSize" id="bm_options_originalimagesize"/>
<paragraph role="heading" level="3" xml-lang="en-US">Use original image size</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsOriginalImageSize" visibility="hidden">Select this option to use the original image size (the size specified in the document will be ignored)</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Often images in a %PRODUCTNAME Writer document are scaled up or down
from their original size. Normally the same scaling will be used in the LaTeX document, but if you select this option,
the original (unscaled) image size will be used.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsOptimizeSimpleTables" id="bm_options_optimizesimpletables"/>
<paragraph role="heading" level="3" xml-lang="en-US">Optimize simple tables</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsOptimizeSimpleTables" visibility="hidden">Check this to optimize the width of tables</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Normally Writer2LaTeX will generate tables with the same column widths
as in the original document. For tables with simple content it may be more desirable to create tables which are as
narrow as possible, with only one line of text per cell. Compare the table</paragraph>
<table class="wide">
<tablerow>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph" xml-lang="en-US">to the optimized table</paragraph>
<table>
<tablerow>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
<tablecell>
<paragraph role="paragraph" xml-lang="en-US">Simple content</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph" xml-lang="en-US">If you check this option, Writer2LaTeX will try to optimize tables.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsSimpleTableLimit" id="bm_options_simpletablelimit"/>
<paragraph role="heading" level="3" xml-lang="en-US">Maximum width in characters</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsSimpleTableLimit" visibility="hidden">Enter the maximum width in characters of tables that should have optimized their width</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you have chosen to optimize simple tables, you have to specify the maximum
width of the table, measured in the number of characters. If you for example set the number to 50, only tables with a total
width of 50 or fewer characters will be optimized.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsFloatTables" id="bm_options_floattables"/>
<paragraph role="heading" level="3" xml-lang="en-US">Float tables</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsFloatTables" visibility="hidden">Check this to allow tables to flow in the document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">In %PRODUCTNAME Writer you can either choose that the rows of a table must
be kept together on one page or that the table may split across page breaks. Keeping a table on one page may be desirable
to increase the readability of the table, but it may also leave large white gaps at the bottom of the page.
In LaTeX this problem is solved with floating tables: A table can automatically move to another position which fixes
the whitespace problem. If you check this option, all tables that are not allowed to break across pages are exported as
floating tables.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsFloatFigures" id="bm_options_floatfigures"/>
<paragraph role="heading" level="3" xml-lang="en-US">Float figures</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsFloatFigures" visibility="hidden">Check this to allow figures to flow in the document</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">A similar option is available for figures (graphics, text boxes).
If you check this option, figures are converted to floating figures which can move in the document to reduce whitespace.
This will not affect figures anchored as character.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsFloatOptions" id="bm_options_floatoptions"/>
<paragraph role="heading" level="3" xml-lang="en-US">Float placement</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsFloatOptions" visibility="hidden">Select placement of floating tables and figures</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">If you choose to let either tables or figures float, use this option to
specify the placement of the floats:</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Top or bottom of page</emph> will place the floats either at
the top or the bottom of a page.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Top of page</emph> will place floats at the top of a page.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Bottom of page</emph> will place floats at the top of a page.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Here or top of page</emph> will place floats at their original position,
if there is room left on the page, and otherwise at the top of a page.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Here or bottom of page</emph> will place floats at their
original position, if there is room left on the page, and otherwise at the bottom of a page.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" xml-lang="en-US">In all cases it might happen that LaTeX creates some special pages which only
contains floats. This will usually be the case if there are many floats compared to the amount of text.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">AutoCorrect</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsIgnoreHardPageBreaks" id="bm_options_ignorehardpagebreaks"/>
<paragraph role="heading" level="3" xml-lang="en-US">Ignore hard page breaks</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsIgnoreHardPageBreaks" visibility="hidden">Check this if you don't want to export manual page breaks</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Hard (or manual) page breaks are often used to optimize page breaks in the
final editing of a document. In this case you will probably not want to export these page breaks, as LaTeX creates page
breaks that are quite different from the page breaks in %PRODUCTNAME Writer. If you select this option, hard page breaks
will be ignored when exporting the document.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsIgnoreHardLineBreaks" id="bm_options_ignorehardlinebreaks"/>
<paragraph role="heading" level="3" xml-lang="en-US">Ignore hard line breaks</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsIgnoreHardLineBreaks" visibility="hidden">Check this if you don't want to export manual line breaks</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">For similar reasons, you can select this option to ignore hard (manual) line
breaks during export.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsIgnoreEmptyParagraphs" id="bm_options_ignoreemptyparagraphs"/>
<paragraph role="heading" level="3" xml-lang="en-US">Ignore empty paragraphs</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsIgnoreEmptyParagraphs" visibility="hidden">Check this if you don't want to export empty paragraphs</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Empty paragraphs are sometimes used a simple means to create vertical spacing
in %PRODUCTNAME Writer. In a well-structured document, an empty paragraph is probably a mistake. Hence you can select this
option to ignore empty paragraphs in the document in the export. If you do not select the option, an empty paragraph is
exported as vertical space.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:OptionsIgnoreDoubleSpaces" id="bm_options_ignoredoublespaces"/>
<paragraph role="heading" level="3" xml-lang="en-US">Ignore double spaces</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:OptionsIgnoreDoubleSpaces" visibility="hidden">Check this if you don't want to export two consecutive space characters</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">For similar reasons you can choose to ignore two or more spaces in a row using
this option.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer4latex-import" indexer="include">
<title xml-lang="en-US">TeX import</title>
<filename>org.openoffice.da.writer4latex.oxt/import.xhp</filename>
</topic>
</meta>
<body>
<!--<paragraph role="heading" level="1" xml-lang="en-US">Importing TeX files</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Coming soon to an extension near you!</paragraph>-->
</body>
</helpdocument>

View file

@ -0,0 +1,97 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-introduction" indexer="include">
<title xml-lang="en-US">Introduction</title>
<filename>org.openoffice.da.writer2latex.oxt/introduction.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Introduction to Writer2LaTeX</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The Writer2LaTeX extension provides you with a set of tools to
create LaTeX documents with %PRODUCTNAME Writer.
By installing Writer2LaTeX you will be able to author well-structured LaTeX documents using (almost)
the full power of %PRODUCTNAME Writer.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX has two modes of operation</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">You can use Writer2LaTeX as an export filter.
It adds LaTeX and BibTeX export to the <emph>File - Export</emph>
<link href="org.openoffice.da.writer2latex.oxt/menu.xhp" name="Applications">menu</link>.
</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">You can use Writer as a frontend for LaTeX.
It adds a
<link href="org.openoffice.da.writer2latex.oxt/menu.xhp" name="Applications">toolbar</link>
to interact with your LaTeX installation.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The functionality of %PRODUCTNAME Writer with
the Writer2LaTeX toolbar can be compared to the application
<link href="http://www.lyx.org" name="Link to the Lyx Website">LyX</link>.
</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Before you can use the Writer2LaTeX toolbar, you need to
<link href="org.openoffice.da.writer2latex.oxt/applications.xhp" name="Applications">configure</link> it.
</paragraph>
</listitem>
</list>
<!--<paragraph role="heading" level="2" xml-lang="en-US">LaTeX import</paragraph>
<paragraph role="paragraph" xml-lang="en-US">You can
<link href="org.openoffice.da.writer2latex.oxt/import.xhp" name="Import TeX files">import</link>
existing LaTeX documents into Writer.
This feature uses Eitan M. Gurari's excellent
<link href="http://www.cse.ohio-state.edu/~gurari/TeX4ht/" name="Link to the TeX4ht Website">TeX4ht</link>
system. Note however, that this feature doesn't make roundtrip
editing %PRODUCTNAME Writer ↔ LaTeX is possible. The intended use of the import feature to make documents
that were originally authored in LaTeX.
</paragraph>-->
<paragraph role="heading" level="2" xml-lang="en-US">Authoring LaTeX files with Writer2LaTeX</paragraph>
<paragraph role="paragraph" xml-lang="en-US">With Writer2LaTeX you can prepare your documents with Writer
as you usually do.
You can then invoke Writer2LaTeX to convert your document into LaTeX, process the LaTeX document and display
the final result.
You are free to create either a LaTeX document that preserves as much of your formatting as possible or
create a clean LaTeX document that will resemble a LaTeX document created by hand.
</paragraph>
<paragraph role="heading" level="3" xml-lang="en-US">Guidelines</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Not every feature in %PRODUCTNAME Writer is supported by LaTeX.
To avoid unexpected results follow these guidelines.</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Page styles</emph>: %PRODUCTNAME Writer offers a sofisticated
page style scheme, where every page style can define another style to be used for the next page.
You can thus have something like Style A → Style B → Style C.
In LaTeX this is only possible in the first step of a page sequence:
The example above will produce Style A → Style B → Style B in LaTeX.
You should beware of this when you design your page styles. Note that explicit change of page style with
<emph>Insert - Manual break</emph> is not affected by this limitation.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">In LaTeX the same page geometry is used for all pages. The dimensions are
taken from the first page of your document.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Do not create headers and footers with more than one line of text,
these will not be exported correctly to LaTeX.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Background color</emph>: Background color is currently not supported
except in table cells. You should avoid using background color elsewhere.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Graphics</emph>: Anchor graphics to paragraph or to character if you
want a floating graphic. If you want the graphic to be a part of the text flow, anchor it to character. Do not anchor
graphics to page as this will make the graphics turn up the wrong place in your document.
You are advised not to wrap text around graphics as this is not exported to LaTeX anyway.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Also, do not use drawing objects inserted directly in the text (using the
Drawing toolbar). These will not be converted to LaTeX.
If you need to insert a drawing, insert an embedded Draw object (<emph>Insert - Object</emph>).</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>Tables</emph>: Avoid using cells spanning several rows, as this
is currently not supported. Cells spanning several columns are fully supported.</paragraph>
</listitem>
</list>
<paragraph role="paragraph" xml-lang="en-US">In general you should be aware that not all formatting is exported. The export of formatting
depends on the selected LaTeX format.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,44 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-logviewer" indexer="include">
<title xml-lang="en-US">View log files</title>
<filename>org.openoffice.da.writer2latex.oxt/logviewer.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:LogViewer" id="bm_logviewer"/>
<paragraph role="heading" level="1" xml-lang="en-US">View log files</paragraph>
<paragraph role="paragraph" xml-lang="en-US">View the log files of the most recent LaTeX run of the
current document.</paragraph>
<section id="howtoget" xml-lang="en-US">
Click the <emph>Log</emph>-button on the toolbar
</section>
<paragraph role="paragraph" xml-lang="en-US">When the document is processed with LaTeX, a number of
log files are generated. They contain error messages and other technical information about the conversion.
Advanced users may use this for troubleshooting.</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Log files</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ViewLaTeXLog" id="bm_viewlatexlog"/>
<paragraph role="heading" level="3" xml-lang="en-US">View LaTeX log</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ViewLaTeXLog" visibility="hidden">Select this to view the log of the latest LaTeX run</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select this to view the log of the latest LaTeX run.
The log file can become quite long and difficult to read. If you only want to view error messages in the
log, you can check <emph>Only errors</emph> at the bottom of the dialog.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ErrorFilter" id="bm_errorfilter"/>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ErrorFilter" visibility="hidden">Check this if you only want to see error messages in the log file</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ViewBibTeXLog" id="bm_viewbibtexlog"/>
<paragraph role="heading" level="3" xml-lang="en-US">View BibTeX log</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ViewBibTeXLog" visibility="hidden">Select this to view the log of the latest BibTeX run</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select this to view the log of the latest BibTeX run.</paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex.oxt:ViewMakeindexLog" id="bm_viewmakeindexlog"/>
<paragraph role="heading" level="3" xml-lang="en-US">View Makeindex log</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex.oxt:ViewMakeindexLog" visibility="hidden">Select this to view the log of the latest Makeindex run</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Select this to view the log of the latest Makeindex run.</paragraph>
</body>
</helpdocument>

View file

@ -0,0 +1,71 @@
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer2latex-menu" indexer="include">
<title xml-lang="en-US">Menu and toolbar</title>
<filename>org.openoffice.da.writer2latex.oxt/menu.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Menu and toolbar</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">Using Writer2LaTeX as an export filter</paragraph>
<paragraph role="heading" level="3" xml-lang="en-US"><link href="org.openoffice.da.writer2latex.oxt/export.xhp"
name="Export LaTeX files">File - Export</link></paragraph>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX adds two entries to the <emph>File - Export</emph>
menu in Writer</paragraph>
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>LaTeX 2e [Writer2LaTeX]</emph> to export the
current document to LaTeX.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US"><emph>BibTeX [Writer2LaTeX]</emph> to export the
bibliographic references in the current document to BibTeX.</paragraph>
</listitem>
</list>
<paragraph role="heading" level="2" xml-lang="en-US">Using the Writer2LaTeX toolbar</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Writer2LaTeX adds a toolbar in Writer,
providing the following commands.</paragraph>
<paragraph role="heading" level="3" xml-lang="en-US"><link href="org.openoffice.da.writer2latex.oxt/bibtex.xhp"
name="Insert BibTeX reference">Insert BibTeX reference</link></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex:InsertBibTeX" id="bm_insertbibtex"/>
<paragraph role="paragraph" xml-lang="en-US">Insert a bibliographic reference to an item in a BibTeX file.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex:InsertBibTeX" visibility="hidden">Insert reference to an item in a BibTeX file</ahelp></paragraph>
<paragraph role="heading" level="3" xml-lang="en-US"><link href="org.openoffice.da.writer2latex.oxt/export.xhp"
name="Export LaTeX files">Publish to LaTeX</link></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex:ProcessDocument" id="bm_processdocument"/>
<paragraph role="paragraph" xml-lang="en-US">Convert the document to LaTeX, process the result with LaTeX
and display the result in an external viewer.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Before you can use this feature, you need to
<link href="org.openoffice.da.writer2latex.oxt/applications.xhp" name="Applications">configure</link>
the external applications to use.
</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex:ProcessDocument" visibility="hidden">Run LaTeX and display the result</ahelp></paragraph>
<paragraph role="heading" level="3" xml-lang="en-US"><link href="org.openoffice.da.writer2latex.oxt/logviewer.xhp"
name="View log files">View Log files</link></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex:ViewLog" id="bm_viewlog"/>
<paragraph role="paragraph" xml-lang="en-US">In case of any problems in the conversion process, you can view the log files created by
LaTeX, MakeIndex and BibTeX here</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer2latex:ViewLog" visibility="hidden">View log files created by LaTeX, MakeIndex and BibTeX</ahelp></paragraph>
<paragraph role="heading" level="3" xml-lang="en-US"><link href="org.openoffice.da.writer2latex.oxt/Configuration/Introduction.xhp"
name="Confguration">Edit custom format</link></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer2latex:EditCustomFormat" id="bm_editcustomformat"/>
<paragraph role="paragraph" xml-lang="en-US">Edit the custom export format. This format is used if you select
<emph>Custom</emph> as LaTeX format in the export dialog.</paragraph>
</body>
</helpdocument>