Merge w4l int w2l - move help files
git-svn-id: svn://svn.code.sf.net/p/writer2latex/code/trunk@201 f0f2a975-2e09-46c8-9428-3b39399b9f3c
This commit is contained in:
henrikjust
parent
f806f79c00
commit
fbb7f60ac1
8 changed files with 10 additions and 10 deletions
|
|
@ -1,7 +1,15 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<tree_view version="15-apr-2010">
|
||||
<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 reference</topic>
|
||||
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/guidelines.xhp">Guidelines</topic>
|
||||
<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/export.xhp">LaTeX Export</topic>
|
||||
<!--<topic id="writer2latex/org.openoffice.da.writer2latex.oxt/import.xhp">Importing TeX files</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>
|
||||
|
|
|
|||
|
|
@ -0,0 +1,69 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<helpdocument version="1.0">
|
||||
<meta>
|
||||
<topic id="writer4latex-applications" indexer="include">
|
||||
<title xml-lang="en-US">Applications</title>
|
||||
<filename>org.openoffice.da.writer4latex.oxt/applications.xhp</filename>
|
||||
</topic>
|
||||
</meta>
|
||||
<body>
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.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">Before you can use Writer4LaTeX you must configure it to use your LaTeX
|
||||
distribution as well as viewers for the different output formats.</paragraph>
|
||||
<section id="howtoget" xml-lang="en-US">
|
||||
Select <emph>Tools - Options - %PRODUCTNAME Writer - Writer4LaTeX - Applications</emph>
|
||||
</section>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.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, Writer4LaTeX will try to locate the external programs
|
||||
and configure them. You will be presented with a short report of the results. Any applications that Writer4LaTeX cannot find for
|
||||
you must be configured manually.</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer4latex.oxt:ConfigurationAutoButton" visibility="hidden">Click here to let Writer4LaTeX configure your external applications automatically</ahelp></paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.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.writer4latex.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.writer4latex.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.writer4latex.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.writer4latex.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.writer4latex.oxt:ConfigurationOptions" visibility="hidden">Fill out any additional options here, using %s to represent the file name</ahelp></paragraph>
|
||||
</body>
|
||||
</helpdocument>
|
||||
|
|
@ -0,0 +1,128 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<helpdocument version="1.0">
|
||||
<meta>
|
||||
<topic id="writer4latex-bibliography" indexer="include">
|
||||
<title xml-lang="en-US">Bibliography</title>
|
||||
<filename>org.openoffice.da.writer4latex.oxt/bibliography.xhp</filename>
|
||||
</topic>
|
||||
</meta>
|
||||
<body>
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.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 define the interaction between Writer4LaTeX and
|
||||
external bibliographic tools.</paragraph>
|
||||
<section id="howtoget" xml-lang="en-US">
|
||||
Select <emph>Tools - Options - %PRODUCTNAME Writer - Writer4LaTeX - Bibliography</emph>
|
||||
</section>
|
||||
|
||||
<paragraph role="heading" level="2" xml-lang="en-US">Citations and BibTeX files</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">There are several ways to handle bibliographic references in %PRODUCTNAME Writer.
|
||||
If you use the standard bibliographic tool provided by %PRODUCTNAME, Writer4LaTeX can convert the references to BibTeX if you
|
||||
choose to do so in the export dialog. In this case you should not make any settings on this page.</paragraph>
|
||||
|
||||
<paragraph role="paragraph" xml-lang="en-US">You may also use other tools such as Zotero or JabRef to handle your citations.
|
||||
If you want to use BibTeX to format references inserted by these tools, Writer4LaTeX can convert them for you. In this case
|
||||
you have to define the location of the BibTeX files produced by Zotero or JabRef.</paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.oxt:BibliographyUseExternalBibTeXFiles" id="bm_useexternalbibtexfiles"/>
|
||||
<paragraph role="heading" level="3" xml-lang="en-US">Use external BibTeX files for ordinary citations</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">Check this if the citations in your document refers to one or more external BibTeX files.
|
||||
(The keys used in the document must match up with the keys in the external BibTeX files.)</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">This feature is for advanced users that maintain their references in BibTeX.
|
||||
It enables you to use the original BibTeX files in the LaTeX document rather than converting the inserted
|
||||
references back into BibTeX.</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer4latex.oxt:BibliographyUseExternalBibTeXFiles" visibility="hidden">Check this if your citations refer to external BibTeX file(s)</ahelp></paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.oxt:BibliographyConvertZoteroCitations" id="bm_convertzoterocitations"/>
|
||||
<paragraph role="heading" level="3" 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="4" 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 <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 Firefox.</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">You can now export your Zotero database: In Zotero, select
|
||||
<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.writer4latex.oxt:BibliographyConvertZoteroCitations" visibility="hidden">Check this to convert Zotero citations to LaTeX</ahelp></paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.oxt:BibliographyConvertJabRefCitations" id="bm_convertjabrefcitations"/>
|
||||
<paragraph role="heading" level="3" 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.
|
||||
Zotero provides a <link href="http://jabref.sourceforge.net/OOPlugin-jabref.php" name="JabRef OOo plugin">plugin</link>
|
||||
which permits you to insert citations from JabRef in your %PRODUCTNAME Writer document
|
||||
using a selection of citation schemes. You should use version 0.8.999 beta or later of the plugin.</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.writer4latex.oxt:BibliographyConvertJabRefCitations" visibility="hidden">Check this to convert JabRef citations to LaTeX</ahelp></paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.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.writer4latex.oxt:BibliographyIncludeOriginalCitations" visibility="hidden">Check this to include the citations inserted by Zotero or JabRef as comments in the LaTeX source.</ahelp></paragraph>
|
||||
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.oxt:BibliographyBibTeXLocation" id="bm_bibtexlocation"/>
|
||||
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX location</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">Writer4LaTeX 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 (this is usually recommended).</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 "bibliopgraphy" 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.writer4latex.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.writer4latex.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.writer4latex.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.writer4latex.oxt:BibliographyBibTeXDirButton" id="bm_bibtexdirbutton"/>
|
||||
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer4latex.oxt:BibliographyBibTeXDirButton" visibility="hidden">Click to select the path to the folder containing the BibTeX files</ahelp></paragraph>
|
||||
|
||||
<paragraph role="heading" level="2" xml-lang="en-US">Natbib</paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.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.writer4latex.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.writer4latex.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.writer4latex.oxt:BibliographyNatbibOptions" visibility="hidden">Enter any options to the package natbib.sty here</ahelp></paragraph>
|
||||
|
||||
<paragraph role="paragraph" xml-lang="en-US"></paragraph>
|
||||
|
||||
</body>
|
||||
</helpdocument>
|
||||
|
|
@ -0,0 +1,48 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<helpdocument version="1.0">
|
||||
<meta>
|
||||
<topic id="writer4latex-guidelines" indexer="include">
|
||||
<title xml-lang="en-US">Guidelines</title>
|
||||
<filename>org.openoffice.da.writer4latex.oxt/guidelines.xhp</filename>
|
||||
</topic>
|
||||
</meta>
|
||||
<body>
|
||||
<paragraph role="heading" level="1" 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>
|
||||
|
|
@ -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>
|
||||
|
|
@ -0,0 +1,113 @@
|
|||
<?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>
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<helpdocument version="1.0">
|
||||
<meta>
|
||||
<topic id="writer4latex-menu" indexer="include">
|
||||
<title xml-lang="en-US">The LaTeX menu</title>
|
||||
<filename>org.openoffice.da.writer4latex.oxt/menu.xhp</filename>
|
||||
</topic>
|
||||
</meta>
|
||||
<body>
|
||||
<paragraph role="heading" level="1" xml-lang="en-US">The LaTeX menu</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">Writer4LaTeX offers the top level menu <emph>LaTeX</emph> in Writer
|
||||
with the following commands.</paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex:ProcessDocument" id="bm_processdocument"/>
|
||||
<paragraph role="heading" level="2" xml-lang="en-US">Run LaTeX...</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">Convert the document to LaTeX and display the result in an external viewer.
|
||||
You can configure the export in the dialog.</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer4latex:ProcessDocument" visibility="hidden">Run LaTeX and display the result</ahelp></paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex:ProcessDirectly" id="bm_processdirectly"/>
|
||||
<paragraph role="heading" level="2" xml-lang="en-US">Run LaTeX directly</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US">Convert the document to LaTeX and display the result in an external viewer.
|
||||
This command does not display the configuration dialog, but reuses the last settings.</paragraph>
|
||||
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer4latex:ProcessDirectly" visibility="hidden">Run LaTeX directly and display the result</ahelp></paragraph>
|
||||
|
||||
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex:ViewLog" id="bm_viewlog"/>
|
||||
<paragraph role="heading" level="2" xml-lang="en-US">View Log files</paragraph>
|
||||
<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.writer4latex:ViewLog" visibility="hidden">View log files created by LaTeX, MakeIndex and BibTeX</ahelp></paragraph>
|
||||
</body>
|
||||
</helpdocument>
|
||||
Loading…
Add table
Add a link
Reference in a new issue