ff746dd4076801c40cf7c2c742c506fd2200539a
[debian/jabref.git] / src / help / ExternalFiles.html
1 <HTML>
2
3 <BODY text="#275856">
4 <basefont size="4" color="#2F4958" face="arial">
5
6 <H1>PDF/PS/URL/DOI links in JabRef</H1>
7
8 JabRef lets you link up your entries with PDF or PS files stored on your system, as well as
9 links to the document on the web in the form of an URL or a DOI identifier.
10
11 <H2>Setting up external viewers</H2>
12
13 The program has to know which external viewers to use for PDF, PS and web pages. These are by default
14 set to values that probably make sense for your operating system, so there's a fair chance you don't
15 have to change these values.
16 <p>To change the external viewer settings, go to <b>Preferences -> General</b>.
17
18 <H2>Opening external files or links</H2>
19
20 There are several ways to open an external file or web page. In the entry editor, you can double click on the text field
21 containing the file name, DOI or URL. In the entry table you can select an entry and use the menu choice, keyboard shortcut
22 or the right-click menu to open the file or web page. Finally, you can click on a PDF, PS, URL or DOI icon.
23 <P> By default the entry table will contain two columns with icons for those entries that link to external files and URLs.
24   You can disable any of these in <b>Preferences -> Table</b>. The second column of the entry table shows icons for PDF or PS files (only PDF if both
25  are present), and the third column shows icons for URL or DOI (only URL if both are present). You open the file or web
26  page by clicking on an icon.
27
28 <H2>The main PDF directory</H2>
29
30 PDF files get a special treatment to make it as easy as possible to link them to your entries. To take advantage of this
31 you have to indicate a directory in <b>Options -> Preferences -> External programs</b> as your main PDF directory. All PDF files that are stored in
32 or below this directory will be referred to with a relative path by JabRef, making it easy for you if you need to move the
33 PDF directory or if several users use the same database from different network places.
34 <P>Additionally, if you give your PDF files names that correspond to the relevant entry's bibtex key (plus '.pdf'),
35   JabRef will be able to search your main directory and its subfolders for the correct PDF. Once the correctly-named
36   PDF is in place you access this function by clicking the 'Auto' button next to the PDF field in the entry editor. If
37   the PDF is found, the field will immediately be set.
38 <P>If you name a PDF file as mentioned, you can also open the PDF without setting the PDF field of the entry at all.
39   The downside is that the PDF icon will not appear in the table unless you do (manually or with the 'Auto' button).
40
41 </HTML>