Imported Upstream version 2.10+ds
[debian/jabref.git] / src / help / EntryEditorHelp.html
index 2cb770ceec7bb01d84ac17770d68e1b56cc59c8a..5f0ca23deb2a848ce3b0f71d310c91a4da0c2b30 100644 (file)
-<html xmlns="http://www.w3.org/1999/xhtml">\r
-<head>\r
-<link rel="stylesheet" type="text/css" href="jabref_help.css"/>\r
-</head>\r
-\r
-<body>\r
-<h1>The entry editor</h1>\r
-\r
-    <p><em>Opened from main window by\r
-    double-clicking anywhere on the line of the entry, or selecting\r
-    the entry and pressing ENTER or CTRL-D. The panel is closed by pressing\r
-    ESC.</em></p>\r
-\r
-    <p>In this panel you can specify all relevant information on a\r
-    single entry. The entry editor checks the type of your entry,\r
-    and lists all the fields that are required, and the ones that\r
-    are optional, for referring the entry with <em>bibtex</em>. In\r
-    addition, there are several fields termed <em>General\r
-    fields</em>, that are common to all entry types.</p>\r
-\r
-    <p>You can fully customize which fields should be regarded as\r
-    required and optional for each type of entry, and which fields\r
-    appear in the General fields tabs. See\r
-    <a href="CustomEntriesHelp.html">Customizing entry types</a>\r
-    for more information about this.</p>\r
-\r
-    <p>For information about how the fields should be filled out,\r
-    see <a href="BibtexHelp.html">Bibtex help</a>.</p>\r
-\r
-    <h2>The entry editor's panels</h2>\r
-\r
-    <p>The entry editor contains six\r
-    panels: <em>Required fields</em>, <em>Optional fields</em>,\r
-    <em>General</em>, <em>Abstract</em>, <em>Review</em> and\r
-    <em>BibTeX source</em>, where <em>General</em>,\r
-    <em>Abstract</em> and <em>Review</em> can be customized (see\r
-    <a href="GeneralFields.html">Customizing general fields</a> for\r
-    details). Inside the three first panels, TAB and SHIFT-TAB are\r
-    used to switch focus between the text fields.</p>\r
-\r
-    <p>Switch panels by clicking on the tabs, or navigate to the\r
-    panel to the left or right using the following key\r
-    combinations: CTRL-TAB or CTRL-PLUS switch to the tab to the\r
-    right, and CTRL-SHIFT-TAB or CTRL-MINUS switch to the tab to\r
-    the left. You can also switch to the next or previous entry by\r
-    pressing CTRL-SHIFT-DOWN or CTRL-SHIFT-UP, respectively, or by\r
-    clicking the appropriate toolbar button.</p>\r
-\r
-    <p>The <em>bibtex source</em> panel shows how the entry will\r
-    appear when the database is saved in <em>bibtex</em> format. If\r
-    you wish, you can edit the <em>bibtex</em> source directly in\r
-    this panel. When you move to a different panel, press CTRL-S or\r
-    close the entry editor, JabRef will try to parse the contents\r
-    of the source panel. If there are problems, you will be\r
-    notified, and given the option to edit your entry further, or\r
-    to revert to the former contents. If <strong>Show source by\r
-    default</strong> is checked in the <strong>General\r
-    options</strong> tab of the <strong>Preferences</strong>\r
-    dialog, the source panel will be the one shown each time you\r
-    open the entry editor. If you prefer editing the source rather\r
-    than using the other four panels, you should check this\r
-    option.</p>\r
-\r
-    <p><strong>Tip:</strong> If your database contains fields\r
-    unknown to JabRef, these will be visible in the source\r
-    panel.</p>\r
-\r
-       <p><strong>Tip:</strong> the <i>pdf</i> and <i>url</i> fields\r
-    support Drag and Drop operations. You can drop there an url\r
-    from your browser. either a link to a pdf file (that JabRef can\r
-    download for you) or you can keep the link.</p>\r
-       \r
-    <h2>Field consistency checking</h2>\r
-\r
-    <p>When the contents of a field\r
-    is changed, JabRef checks if the new contents are acceptable.\r
-    For field types that are used by <em>bibtex</em>, the contents\r
-    are checked with respect to the use of the '#' character. The\r
-    hash symbol is <em>only</em> to be used in pairs (except in escaped\r
-    form, '\#'), wrapping the\r
-    name of a <em>bibtex</em> string that is referenced. Note that\r
-    JabRef does not check if the referenced string actually exists\r
-    (this is not trivial, since the <em>bibtex</em> style you use\r
-    can define an arbitrary set of strings unknown to JabRef).</p>\r
-\r
-    <p>If the contents are not accepted, the field will turn red,\r
-    indicating an error. In this case the change will not be\r
-    stored.</p>\r
-\r
-    <h2>Word/name autocompletion</h2>\r
-\r
-    <p>The entry editor offers autocompletion of words. In the Preferences dialog\r
-    you can enable or disable autocompletion, and choose for which fields\r
-    autocompletion is active.</p>\r
-\r
-    <p>With autocompletion, JabRef records all words that appear in\r
-    each of the chosen fields throughout your database. Whenever you write\r
-    the beginning of one of these words, it will be suggested visually. To\r
-    ignore the suggestion, simply write on. To accept the suggestion,\r
-    either press <em>ENTER</em> or use your arrow keys or other keys to\r
-    remove the selection box around the suggested characters.</p>\r
-\r
-    <p><em>Note:</em> the words considered for suggestion are only the ones\r
-    appearing in the same field in entries of the same database as the one you\r
-    are editing. There are many ways to realise this kind of feature, and if you feel\r
-    it should have been implemented differently, we'd like to hear your suggestions!</p>\r
-\r
-    <h2>Copy <em>bibtex</em> key including citation command.</h2>\r
-\r
-    <p>Pressing CTRL-K or the 'key' button causes the <em>bibtex</em> key for your entry\r
-    including the surrounding to be copied to the clipboard.</p>\r
-\r
-    <h2>Copy <em>bibtex</em> key</h2>\r
-\r
-    <p>Pressing CTRL-SHIFT-K causes the <em>bibtex</em> key for your entry\r
-    to be copied to the clipboard.</p>\r
-\r
-    <h2>Autogenerate <em>bibtex</em> key</h2>\r
-\r
-    <p>Press CTRL-G or the\r
-    'gen key' button (the magic wand) to autogenerate a\r
-    <em>bibtex</em> key for your entry based on the contents of its\r
-    required fields.</p>\r
-\r
-    <p>For more information on how JabRef generates <em>bibtex</em>\r
-    keys, see <a href="LabelPatterns.html">Customizing the BibTex\r
-    key generator</a>.</p>\r
-\r
-</body>\r
-</html>\r
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<link rel="stylesheet" type="text/css" href="jabref_help.css"/>
+</head>
+
+<body>
+<h1>The entry editor</h1>
+
+    <p><em>Opened from main window by
+    double-clicking anywhere on the line of the entry, or selecting
+    the entry and pressing ENTER or CTRL-D. The panel is closed by pressing
+    ESC.</em></p>
+
+    <p>In this panel you can specify all relevant information on a
+    single entry. The entry editor checks the type of your entry,
+    and lists all the fields that are required, and the ones that
+    are optional, for referring the entry with <em>bibtex</em>. In
+    addition, there are several fields termed <em>General
+    fields</em>, that are common to all entry types.</p>
+
+    <p>You can fully customize which fields should be regarded as
+    required and optional for each type of entry, and which fields
+    appear in the General fields tabs. See
+    <a href="CustomEntriesHelp.html">Customizing entry types</a>
+    for more information about this.</p>
+
+    <p>For information about how the fields should be filled out,
+    see <a href="BibtexHelp.html">Bibtex help</a>.</p>
+
+    <h2>The entry editor's panels</h2>
+
+    <p>The entry editor contains six
+    panels: <em>Required fields</em>, <em>Optional fields</em>,
+    <em>General</em>, <em>Abstract</em>, <em>Review</em> and
+    <em>BibTeX source</em>, where <em>General</em>,
+    <em>Abstract</em> and <em>Review</em> can be customized (see
+    <a href="GeneralFields.html">Customizing general fields</a> for
+    details). Inside the three first panels, TAB and SHIFT-TAB are
+    used to switch focus between the text fields.</p>
+
+    <p>Switch panels by clicking on the tabs, or navigate to the
+    panel to the left or right using the following key
+    combinations: CTRL-TAB or CTRL-PLUS switch to the tab to the
+    right, and CTRL-SHIFT-TAB or CTRL-MINUS switch to the tab to
+    the left. You can also switch to the next or previous entry by
+    pressing CTRL-SHIFT-DOWN or CTRL-SHIFT-UP, respectively, or by
+    clicking the appropriate toolbar button.</p>
+
+    <p>The <em>bibtex source</em> panel shows how the entry will
+    appear when the database is saved in <em>bibtex</em> format. If
+    you wish, you can edit the <em>bibtex</em> source directly in
+    this panel. When you move to a different panel, press CTRL-S or
+    close the entry editor, JabRef will try to parse the contents
+    of the source panel. If there are problems, you will be
+    notified, and given the option to edit your entry further, or
+    to revert to the former contents. If <strong>Show source by
+    default</strong> is checked in the <strong>General
+    options</strong> tab of the <strong>Preferences</strong>
+    dialog, the source panel will be the one shown each time you
+    open the entry editor. If you prefer editing the source rather
+    than using the other four panels, you should check this
+    option.</p>
+
+    <p><strong>Tip:</strong> If your database contains fields
+    unknown to JabRef, these will be visible in the source
+    panel.</p>
+
+       <p><strong>Tip:</strong> the <i>pdf</i> and <i>url</i> fields
+    support Drag and Drop operations. You can drop there an url
+    from your browser. either a link to a pdf file (that JabRef can
+    download for you) or you can keep the link.</p>
+       
+    <h2>Field consistency checking</h2>
+
+    <p>When the contents of a field
+    is changed, JabRef checks if the new contents are acceptable.
+    For field types that are used by <em>bibtex</em>, the contents
+    are checked with respect to the use of the '#' character. The
+    hash symbol is <em>only</em> to be used in pairs (except in escaped
+    form, '\#'), wrapping the
+    name of a <em>bibtex</em> string that is referenced. Note that
+    JabRef does not check if the referenced string actually exists
+    (this is not trivial, since the <em>bibtex</em> style you use
+    can define an arbitrary set of strings unknown to JabRef).</p>
+
+    <p>If the contents are not accepted, the field will turn red,
+    indicating an error. In this case the change will not be
+    stored.</p>
+
+    <h2>Word/name autocompletion</h2>
+
+    <p>The entry editor offers autocompletion of words. In the Preferences dialog
+    you can enable or disable autocompletion, and choose for which fields
+    autocompletion is active.</p>
+
+    <p>With autocompletion, JabRef records all words that appear in
+    each of the chosen fields throughout your database. Whenever you write
+    the beginning of one of these words, it will be suggested visually. To
+    ignore the suggestion, simply write on. To accept the suggestion,
+    either press <em>ENTER</em> or use your arrow keys or other keys to
+    remove the selection box around the suggested characters.</p>
+
+    <p><em>Note:</em> the words considered for suggestion are only the ones
+    appearing in the same field in entries of the same database as the one you
+    are editing. There are many ways to realise this kind of feature, and if you feel
+    it should have been implemented differently, we'd like to hear your suggestions!</p>
+
+    <h2>Copy <em>bibtex</em> key including citation command.</h2>
+
+    <p>Pressing CTRL-K or the 'key' button causes the <em>bibtex</em> key for your entry
+    including the surrounding to be copied to the clipboard.</p>
+
+    <h2>Copy <em>bibtex</em> key</h2>
+
+    <p>Pressing CTRL-SHIFT-K causes the <em>bibtex</em> key for your entry
+    to be copied to the clipboard.</p>
+
+    <h2>Autogenerate <em>bibtex</em> key</h2>
+
+    <p>Press CTRL-G or the
+    'gen key' button (the magic wand) to autogenerate a
+    <em>bibtex</em> key for your entry based on the contents of its
+    required fields.</p>
+
+    <p>For more information on how JabRef generates <em>bibtex</em>
+    keys, see <a href="LabelPatterns.html">Customizing the BibTex
+    key generator</a>.</p>
+
+</body>
+</html>