<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<meta>
<topic id="writer4latex-introduction" indexer="include">
<title xml-lang="en-US">Introduction</title>
<filename>org.openoffice.da.writer4latex.oxt/introduction.xhp</filename>
</topic>
</meta>
<body>
<paragraph role="heading" level="1" xml-lang="en-US">Introduction to Writer4LaTeX</paragraph>
<paragraph role="paragraph" xml-lang="en-US">The purpose of the Writer4LaTeX extension is to turn Writer into a frontend for LaTeX.
By installing Writer4LaTeX you will thus be available to author well-structured LaTeX documents using (almost) the full power of
%PRODUCTNAME Writer.
The functionality of %PRODUCTNAME Writer with Writer4LaTeX can be compared to the application
<link href="http://www.lyx.org" name="Link to the Lyx Website">LyX</link>.
</paragraph>
<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">
<listitem>
<paragraph role="paragraph" xml-lang="en-US">You can prepare your documents with Writer as you usually do,
keeping a few
<link href="org.openoffice.da.writer4latex.oxt/guidelines.xhp" name="Guidelines">guidelines</link> in mind.
You can then invoke Writer4LaTeX 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>
</listitem>
<listitem>
<paragraph role="paragraph" xml-lang="en-US">You can use some special
<link href="org.openoffice.da.writer4latex.oxt/templates.xhp" name="Using the templates">Writer templates</link>
provided with Writer4LaTeX to
create your documents. Using the styles supported by these templates, you can easily create standard LaTeX documents
using the opportunities of standard LaTeX document classes.
</paragraph>
<paragraph role="paragraph" xml-lang="en-US">For this initial version, templates for the standard LaTeX classes article
are provided. More templates will be added later (report, book, beamer...), and you can also add your own templates.
</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.writer4latex.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">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/applications.xhp" name="Applications">configure</link> it.
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>