[svn-upgrade] Integrating new upstream version, jabref (2.5~beta1)
[debian/jabref.git] / src / help / StringEditorHelp.html
1 <html xmlns="http://www.w3.org/1999/xhtml">
2
3 <body text="#275856">
4     <basefont size="4" color="#2F4958" face="arial" />
5
6     <h1>The string editor</h1>
7
8     <p><em>Opened from the main window
9     by <b>BibTeX -> Edit strings</b> or pressing a button in the toolbar.</em></p>
10
11     <p><em>Strings</em> are the <em>bibtex</em> equivalent to
12     constants in a programming language. Each string is defined
13     with a unique <em>name</em> and a <em>content</em>. Elsewhere
14     in the database, the name can be used to represent the
15     content.</p>
16
17     <p>For instance, if many entries are from a journal with an
18     abbreviation that may be hard to remember, such as 'J. Theor.
19     Biol.' (Journal of Theroretical Biology), a string named JTB
20     could be defined to represent the journal's name. Instead of
21     repeating the exact journal name in each entry, the characters
22     '#JTB#' (without quotes) are put into the <em>journal</em>
23     field of each, ensuring the journal name is written identically
24     each time.</p>
25
26     <p>A string reference can appear anywhere in a field, always by
27     enclosing the string's name in a pair of '#' characters. This
28     syntax is specific for JabRef, and differs slightly from the
29     <em>bibtex</em> notation that is produced when you save your
30     database. Strings can by default be used for all standard
31     BibTeX fields, and in <b>Preferences -&gt; General -&gt;
32     File</b> you can opt to enable strings for non-standard fields
33     as well. In the latter case you can specify a set of fields
34     that are excepted from string resolving, and here it is
35     recommended to include the 'url' field and other fields that
36     may need to contain the '#' character and that may be processed
37     by BibTeX/LaTeX.</p>
38
39     <p>A string may in the same way be referred in the content of
40     another string, provided the referred string is defined
41     <em>before</em> the referring one.</p>
42
43     <p>While the order of strings in your BibTeX file is important
44     in some cases, you don't have to worry about this when using
45     JabRef. The strings will be displayed in alphabetical order in
46     the string editor, and stored in the same order, except when a
47     different ordering is required by BibTeX.</p>
48 </body>
49 </html>