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