bad1f069060069698d7cb692e8f052f5b4ee5d90
[debian/jabref.git] / src / help / JournalAbbreviations.html
1 <HTML>
2
3 <BODY text="#275856">
4 <basefont size="4" color="#2F4958" face="arial">
5
6 <H1>Journal abbreviations</H1>
7
8 This feature can be configured under <b>Tools -> Manage journal abbreviations</b>.
9
10 <p>JabRef can automatically toggle journal names between abbreviated and unabbreviated form, as long
11 as the names are contained in one of your journal lists. You can use several lists, all realized as
12 external text files on your hard disk.
13
14 <H2>Using the feature</H2>
15 <p>
16 Journal name conversion can be accessed either from within the entry editor, or from the <b>Tools</b> menu.
17 In the entry editor you will find a button labelled <i>Toggle abbreviation</i> by the <i>journal</i> field.
18 Clicking this button will cause the current journal name to be switched to the next of three modes:
19 <ul>
20     <li>Full name, e.g. "Aquacultural Engineering"</li>
21     <li>ISO abbreviation, e.g. "Aquacult. Eng."</li>
22     <li>MEDLINE abbreviation, e.g. "Aquacult Eng"</li>
23 </ul>
24 If the current journal name is not found in your journal lists, the field will not be modified.
25
26 <p>
27 To convert the journal names of many entries in bulk, you can select any number of entries, and choose
28 <b>Tools -> Abbreviate journal names (ISO)</b>, <b>Tools -> Abbreviate journal names (MEDLINE)</b> or
29     <b>Tools -> Unabbreviate journal names</b>. These two actions
30 will abbreviate and unabbreviate the journal names of all selected entries for which the journal name could
31 be found in your journal lists.
32
33 <h2>Setting up your journal lists</h2>
34
35 You can have several journal lists, all external text files linked from JabRef. The primary list can be
36 edited from within JabRef.
37
38 <H3>Your personal journal abbreviations list</H3>
39
40 Your personal journal list is managed in the upper part of the <b>Manage journal abbreviations</b> window.
41 To start building your personal journal abbreviations list, choose <i>New file</i>, and enter a filename
42 manually or using the <i>Browse</i> button. If you already have a file that you want to use as a starting point,
43 choose <i>Existing file</i>, and use the <i>Browse</i> button to choose the file. The table will update to show
44 the contents of the list you have selected.
45
46 <p>The table and the tool buttons to the right allow you to add, remove and edit journal entries. For each entry
47 you must provide the full journal name, and the ISO abbreviation (e.g. "Aquacultural Engineering" and "Aquacult. Eng.").
48 To edit an entry, double-click its row in the table.
49
50 <p>Once you click <i>OK</i>, if you have selected a file, and the table contains at least one entry, the table
51 contents will be stored to the selected file, and JabRef's list of journals will be updated.
52
53 <h3>External journal lists</h3>
54
55 In addition to your personal list, you can link to a number of external lists. These links can be set up
56 in the lower part of the <b>Manage journal abbreviations</b> window. External lists are similar to the personal
57 list - the only difference is that JabRef doesn't provide an interface for editing the external lists.
58 <p>
59 To add a new external list, if necessary, click the <b>+</b> button to add another slot to the interface.
60 Then use either the <i>Browse</i> or <i>Download</i> button next to one of the
61 slots in the lower part of the window.
62     <ul>
63     <li>The <i>Browse</i> button allows you to select an existing file on
64 your computer.</li>
65     <li>The <i>Download</i> button allows you to download a list over the internet by entering and
66 URL, store it to a local file on your computer, and link to it as a journal list from JabRef. The URL will
67 default to the address of a journal list provided from the JabRef web page. This list is incomplete, but
68 may be improved in the future.</li>
69     </ul>
70
71 Any entry in your personal journal list will override an entry with the same full journal name in one of the
72 external lists. Similarly, the external lists are given precedence in the order they are listed.
73
74 </BODY>
75 </HTML>