[svn-upgrade] Integrating new upstream version, jabref (2.5~beta1)
[debian/jabref.git] / src / help / CustomEntriesHelp.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>Customizing entry types</h1>
7
8     <p>To customize entry types, select the menu <strong>Options
9     --&gt; Customize entry types</strong>.</p>
10
11     <p>When customizing an entry type, you both define how its
12     entry editor should look, and what it takes for JabRef to
13     consider an entry complete. You can both make changes to the
14     existing entry types, and define new ones.</p>
15
16     <p>Note that no modifications you make in this dialog will be
17     stored until you click <b>Apply</b> or <b>OK</b>. If you click
18     <b>Cancel</b> or simply close the dialog, unapplied changes
19     will be lost.</p>
20
21     <h2>Using the entry customization dialog</h2>
22
23     <p>The entry
24     customization dialog is divided in three main panels. The
25     leftmost panel is where you can select an entry type for
26     modification, and add new ones. The middle panel is used for
27     setting up the required fields of the selected entry type, and
28     the right panel for setting up the optional fields.</p>
29
30     <h3>Adding and removing entry types</h3>
31
32     <p>The currently available entry types are listed in the left
33     panel. Whenever you select an entry type, the other panels will
34     update to show what fields are required and optional for this
35     entry type.</p>
36
37     <p>To add a new entry type, you must enter a name for it in the
38     text field below the type list, and click <b>Add</b>. The new
39     entry type will be added to the list, and selected for
40     modification.</p>
41
42     <p>To remove a custom entry type, select it and click
43     <b>Remove</b>. This operation will only be available for custom
44     entry types that are not merely modifications of standard
45     types. It is not possible to remove a standard entry type.</p>
46
47     <p>To return a modified standard type to its default setup,
48     select it and click <b>Default</b>. This operation will only be
49     available for customized entry types that modify a standard
50     type.</p>
51
52     <h2>Editing entry types</h2>
53
54     <p>When an entry type is selected, the
55     current required and optional fields will be listed in the
56     center and right panels of the dialog. The process of editing
57     the lists are identical for the required and optional fields.</p>
58
59     <p>To add a new field, edit the text field below the list, or
60     select a field name from the dropdown menu, then click
61     <b>Add</b>. The chosen field name will be added at the end of
62     the list.</p>
63
64     <p>To remove one or more fields, select them in the list, and
65     click <b>Remove</b>.</p>
66
67     <p>To change the order of the fields, choose one field name,
68     and click the arrow buttons to move it up or down in the
69     list.</p>
70
71     <p>There is one limitation to customizing entry types; certain
72     types have an and/or condition in their required fields. For
73     instance, a <em>book</em> entry is complete with either the
74     <em>author</em> or the <em>editor</em> field, or both. This
75     type of condition cannot be represented in a customized
76     entry.</p>
77 </body>
78 </html>