litvinovg/w2phtml
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 21 Packages Wiki Activity Actions

Writer4LaTeX help content

Browse source 
git-svn-id: svn://svn.code.sf.net/p/writer2latex/code/trunk@86 f0f2a975-2e09-46c8-9428-3b39399b9f3c
This commit is contained in:
henrikjust 2011-02-10 08:39:07 +00:00
parent 22c38c3ff4
commit 559293a169
16 changed files with 878 additions and 120 deletions
Download patch file Download diff file Expand all files Collapse all files

123
source/oxt/writer4latex/help/en/org.openoffice.da.writer4latex.oxt/bibliography.xhp
View file

@ -9,30 +9,41 @@
<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 .</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">Zotero support</paragraph>
<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>
<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">Check this if you want to convert Zotero citations to LaTeX using the package natbib.sty.
This enables you to format the citations using a BibTeX style of your choice. If you do not check this option, the original
<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="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer4latex.oxt:BibliographyConvertZoteroCitations" visibility="hidden">Check this to convert Zotero citations using natbib.sty</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/org.openoffice.da.writer4latex.oxt:BibliographyZoteroBibTeXDir" id="bm_zoterobibtexdir"/>
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX folder</paragraph>
<paragraph role="paragraph" xml-lang="en-US">To use this feature you also have to export your Zotero bibliography database
to BibTeX.</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Type the full path to the folder containing the exported database or click
<emph>Browse</emph> to find the folder in your file system.</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>
@ -44,30 +55,74 @@
<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:BibliographyZoteroBibTeXDir" visibility="hidden">Enter the path to the folder containing the BibTeX file exported from Zotero</ahelp></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">Natbib Options</paragraph>
<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="heading" level="2" xml-lang="en-US">External BibTeX files</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</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 users that maintain their references in BibTeX, for example using
a tool like <link href="http://jabref.sourceforge.net/" name="Link to the JabRef Website">JabRef</link>.
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:BibliographyExternalBibTeXDir" id="bm_externalbibtexdir"/>
<paragraph role="heading" level="3" xml-lang="en-US">BibTeX folder</paragraph>
<paragraph role="paragraph" xml-lang="en-US">Type the full path to the folder containing the BibTeX database(s) or click
<emph>Browse</emph> to find the folder in your file system.</paragraph>
<paragraph role="paragraph" xml-lang="en-US"><ahelp hid="org.openoffice.da.writer4latex.oxt:Bibliography" visibility="hidden">Enter the path to the folder containing the BibTeX files</ahelp></paragraph>
<paragraph role="paragraph" xml-lang="en-US"></paragraph>
</body>
</helpdocument>