Merge w4l int w2l - update help files
git-svn-id: svn://svn.code.sf.net/p/writer2latex/code/trunk@202 f0f2a975-2e09-46c8-9428-3b39399b9f3c
This commit is contained in:
parent
fbb7f60ac1
commit
88c3a7295d
7 changed files with 235 additions and 201 deletions
|
@ -1,48 +1,44 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<helpdocument version="1.0">
|
||||
<meta>
|
||||
<topic id="writer4latex-introduction" indexer="include">
|
||||
<topic id="writer2latex-introduction" indexer="include">
|
||||
<title xml-lang="en-US">Introduction</title>
|
||||
<filename>org.openoffice.da.writer4latex.oxt/introduction.xhp</filename>
|
||||
<filename>org.openoffice.da.writer2latex.oxt/introduction.xhp</filename>
|
||||
</topic>
|
||||
</meta>
|
||||
<body>
|
||||
<paragraph role="heading" level="1" xml-lang="en-US">Introduction to Writer4LaTeX</paragraph>
|
||||
<paragraph role="heading" level="1" xml-lang="en-US">Introduction to Writer2LaTeX</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>
|
||||
<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 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 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>
|
||||
<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.writer4latex.oxt/import.xhp" name="Import TeX files">import</link>
|
||||
<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>
|
||||
|
@ -51,63 +47,51 @@
|
|||
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>
|
||||
<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>
|
Loading…
Add table
Add a link
Reference in a new issue