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