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