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