Various work...

git-svn-id: svn://svn.code.sf.net/p/writer2latex/code/trunk@51 f0f2a975-2e09-46c8-9428-3b39399b9f3c
This commit is contained in:
henrikjust 2010-03-12 10:35:05 +00:00
parent 5311ac0b6b
commit 144b59f561
15 changed files with 368 additions and 126 deletions

View file

@ -2,7 +2,7 @@
<!-- article.xml
This is a configuration file for Writer4LaTeX.
It contains a lot of style mappings, which correspond to
the template LaTeX-article.stw.
the template LaTeX-article.odt.
Some definitions have been chosen for compatibility with tex4ht
-->
@ -32,6 +32,10 @@
<option name="bibtex_style" value="plain" />
<option name="formatting" value="ignore_most" />
<option name="page_formatting" value="ignore_all" />
<option name="table_first_head_style" value="table first head" />
<option name="table_head_style" value="table head" />
<option name="table_foot_style" value="table foot" />
<option name="table_last_foot_style" value="table last foot" />
<option name="ignore_empty_paragraphs" value="true" />
<option name="ignore_hard_page_breaks" value="false" />
<option name="ignore_hard_line_breaks" value="false" />
@ -65,15 +69,17 @@
<heading-level-map writer-level="6" name="subparagraph" level="5" />
</heading-map>
<!-- Defintions for \maketitle. At least one of the styles Title, Author, Date
<!-- Defintions for \maketitle. At least one of the styles Title/title, Author, Date
in any order will give correct results.
Uses a predefined style from OOo for the title -->
<style-map name="Title" class="paragraph" before="\title{" after="}" line-break="false" />
<style-map name="title" class="paragraph" before="\title{" after="}" line-break="false" />
<style-map name="author" class="paragraph" before="\author{" after="}" line-break="false" />
<style-map name="date" class="paragraph" before="\date{" after="}" line-break="false" />
<style-map name="Title" class="paragraph-block" next="author;date" before="" after="\maketitle" />
<style-map name="author" class="paragraph-block" next="Title;date" before="" after="\maketitle" />
<style-map name="date" class="paragraph-block" next="Title;author" before="" after="\maketitle" />
<style-map name="title" class="paragraph-block" next="author;date" before="" after="\maketitle" />
<style-map name="author" class="paragraph-block" next="Title;title;date" before="" after="\maketitle" />
<style-map name="date" class="paragraph-block" next="Title;title;author" before="" after="\maketitle" />
<!-- Definitions for the abstract. The abstract can contain any number of paragraphs -->
<style-map name="abstract title" class="paragraph" before="\renewcommand\abstractname{" after="}" line-break="false" />
@ -103,6 +109,10 @@
<style-map name="Quotations" class="paragraph-block" next="Quotations" before="\begin{quotation}" after="\end{quotation}" />
<style-map name="Quotations" class="paragraph" before="" after="" />
<!-- quotation; using custom style -->
<style-map name="quotation" class="paragraph-block" next="quotation" before="\begin{quotation}" after="\end{quotation}" />
<style-map name="quotation" class="paragraph" before="" after="" />
<!-- verse -->
<style-map name="verse" class="paragraph-block" next="verse" before="\begin{verse}" after="\end{verse}" />
<style-map name="verse" class="paragraph" before="" after="" />
@ -114,6 +124,16 @@
<style-map name="Preformatted Text" class="paragraph-block" next="Preformatted Text" before="\begin{verbatim}" after="\end{verbatim}" />
<style-map name="Preformatted Text" class="paragraph" before="" after="" verbatim="true" />
<!-- verbatim; using custom style -->
<style-map name="verbatim" class="paragraph-block" next="verbatim" before="\begin{verbatim}" after="\end{verbatim}" />
<style-map name="verbatim" class="paragraph" before="" after="" verbatim="true" />
<!-- definitions for multi page table support -->
<style-map name="table first head" class="paragraph" before="" after="" />
<style-map name="table head" class="paragraph" before="" after="" />
<style-map name="table foot" class="paragraph" before="" after="" />
<style-map name="table last foot" class="paragraph" before="" after="" />
<!-- Definitions for some standard OOo paragraph styles -->
<style-map name="Text body" class="paragraph" before="" after="" />
<style-map name="First line indent" class="paragraph" before="" after="" />
@ -126,6 +146,7 @@
<style-map name="obeylines-h" class="text" before="" after="" />
<style-map name="verb" class="text" before="\verb|" after="|" verbatim="true" />
<style-map name="Emphasis" class="text" before="\emph{" after="}" />
<style-map name="emph" class="text" before="\emph{" after="}" />
<style-map name="Strong Emphasis" class="text" before="\textbf{" after="}" />
<style-map name="textrm" class="text" before="\textrm{" after="}" />
<style-map name="textsf" class="text" before="\textsf{" after="}" />
@ -158,13 +179,18 @@
<style-map name="List Heading" class="paragraph" before="\item[" after="]" line-break="false" />
<style-map name="List Contents" class="paragraph" before="" after="" />
<!-- Definitions for description list. Uses custom styles -->
<style-map name="description item" class="paragraph-block" next="description item;description text" before="\begin{description}" after="\end{description}"/>
<style-map name="description item" class="paragraph" before="\item[" after="]" line-break="false" />
<style-map name="description text" class="paragraph" before="" after="" />
<!-- Definitions for itemize and enumerate -->
<style-map name="itemize" class="paragraph" before="" after="" />
<style-map name="enumerate" class="paragraph" before="" after="" />
<!-- Definitions for verbatim LaTeX code -->
<style-map name="LaTeX" class="paragraph" before="" after="" verbatim="true" />
<style-map name="LaTeX" class="text" before="" after="" verbatim="true" />
<style-map name="LaTeX" class="text" before="" after="{}" verbatim="true" />
</config>

View file

@ -19,7 +19,7 @@
<paragraph role="heading" level="2" xml-lang="en-US">Authoring LaTeX files with Writer4LaTeX</paragraph>
<paragraph role="paragraph" xml-lang="en-US">You can use Writer4LaTeX in two different ways
</paragraph>
<list type="unordered" bullet="disc">
<list type="unordered">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">You can prepare your documents with Writer as you usually do,
keeping a few
@ -47,15 +47,67 @@
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 it possible to work on documents
that were orginally authored in LaTeX.
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">Before you start</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Before you can use Writer4LaTeX, you need to
<link href="org.openoffice.da.writer4latex.oxt/configuration.xhp" name="Configuration">configure</link> it.
This requires that you have
a working TeX installation on your system such as MikTeX for Windows or TeX Live for unix/linux.
</paragraph>
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">The LaTeX export filter Writer2LaTeX must be installed in %PRODUCTNAME.
You can get this extension at
<link href="http://extensions.services.openoffice.org/project/writer2latex" name="Writer2LaTeX download">http://extensions.services.openoffice.org/project/writer2latex</link>.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Writer4LaTeX 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">Finally 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">The LaTeX export filter Writer2LaTeX must be installed in %PRODUCTNAME.
You can get this extension at
<link href="http://extensions.services.openoffice.org/project/writer2latex" name="Writer2LaTeX download">http://extensions.services.openoffice.org/project/writer2latex</link>.</paragraph>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">Writer4LaTeX 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 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">Finally 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">
<paragraph>Writer4LaTeX has not been tested on Mac OS X, but it should be possible to configure it manually
if you have installed a LaTeX distribution and viewers for DVI, PDF and PostScript documents.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">You also need to install the LaTeX export filter Writer2LaTeX
in %PRODUCTNAME. You can get this extension at
<link href="http://extensions.services.openoffice.org/project/writer2latex" name="Writer2LaTeX download">http://extensions.services.openoffice.org/project/writer2latex</link>.</paragraph>
</case>
</switch>
</body>
</helpdocument>

View file

@ -10,15 +10,15 @@
<paragraph role="heading" level="1" xml-lang="en-US">Using the templates</paragraph>
<paragraph role="heading" level="2" xml-lang="en-US">The article template</paragraph>
<section id="howtoget" xml-lang="en-US">
Choose <emph>File - New - Templates and Documents</emph>
Choose <emph>File - New - Templates and Documents - Writer2LaTeX</emph>
</section>
<paragraph role="paragraph" xml-lang="en-US">This template contains a number of styles that corresponds to LaTeX code.
If you use these styles and makes sure to use the configuration <emph>W4L: Article</emph> when you convert your document
(this is selected automatically) with Writer2LaTeX, you will get a result that resembles a handwritten LaTeX file.
Note that hard formatting and any other styles will be ignored. The available styles are summarized in the following tables.
The use of italics in these tables indicates styles that are predefined in %PRODUCTNAME Writer.
The names of these styles will be localized if you use a non-english version of %PRODUCTNAME.</paragraph>
<paragraph role="heading" level="3">Paragraph styles</paragraph>
</paragraph>
<paragraph role="heading" level="3" xml-lang="en-US">Paragraph styles</paragraph>
<paragraph role="heading" level="4" xml-lang="en-US">Title styles</paragraph>
<table>
<tablerow>
<tablecell>
@ -30,7 +30,7 @@
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Title</paragraph>
<paragraph role="tablecontent" xml-lang="en-US">title</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">\title{...}</paragraph>
@ -68,6 +68,11 @@
<paragraph role="tablecontent" xml-lang="en-US">abstract environment</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph">Note that also \maketitle is added at the end of a sequence of title, author and date.</paragraph>
<paragraph role="heading" level="4" xml-lang="en-US">Heading styles</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Note that the names of the heading styles are localized in %PRODUCTNAME Writer</paragraph>
<table>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">part</paragraph>
@ -116,6 +121,9 @@
<paragraph role="tablecontent" xml-lang="en-US">\subparagraph{...}</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="heading" level="4" xml-lang="en-US">Other paragraph styles</paragraph>
<table>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">flushleft</paragraph>
@ -166,7 +174,7 @@
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Preformatted text</paragraph>
<paragraph role="tablecontent" xml-lang="en-US">verbatim</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">verbatim environment</paragraph>
@ -198,7 +206,7 @@
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">List Heading</paragraph>
<paragraph role="tablecontent" xml-lang="en-US">description item</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">description list (item label)</paragraph>
@ -206,16 +214,65 @@
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">List Contents</paragraph>
<paragraph role="tablecontent" xml-lang="en-US">description text</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">description list (item text)</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">LaTeX</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">The text content of the paragraph is inserted as verbatim LaTeX code.</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="paragraph">Note that also \maketitle is added at the end of a sequence of Title, author and date.</paragraph>
<paragraph role="paragraph">For the verbatim environment, only characters available in the input encoding are accepted.
Other characters are converted to question marks and other content is discarded, eg. footnotes.</paragraph>
<paragraph role="heading" level="4" xml-lang="en-US">Special paragraph styles for tables</paragraph>
<paragraph role="paragraph" xml-lang="en-US">%PRODUCTNAME Writer supports multipage tables with repeating headers.
LaTeX on the other hand also provides support for repeating foots and special header and foot on the first repspectively last
page of the table. The article template provides four special paragraph styles to let you use these LaTeX features.
Note that the special pagragraphs appear colored in %PRODUCTNAME Writer for clarity, but the colors will be removed in the export
to LaTeX.</paragraph>
<table>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">table first head</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Identifies a row to be used as first head in table</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">table head</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Identifies a row to be used as head in table</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">table foot</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Identifies a row to be used as foot in table</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">table last foot</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Identifies a row to be used as last foot in table</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph role="heading" level="3">Text styles</paragraph>
<table>
<tablerow>
@ -228,20 +285,12 @@
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Emphasis</paragraph>
<paragraph role="tablecontent" xml-lang="en-US">emph</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">\emph{...}</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">Strong Emphasis</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">\textbf{...}</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">textrm</paragraph>
@ -393,6 +442,14 @@
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">{\Huge ...}</paragraph>
</tablecell>
<tablerow>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">LaTeX</paragraph>
</tablecell>
<tablecell>
<paragraph role="tablecontent" xml-lang="en-US">The text content is inserted as verbatim LaTeX code.</paragraph>
</tablecell>
</tablerow>
</tablerow>
</table>
<paragraph role="paragraph">For the \verb command, only characters available in the input encoding are accepted.