Differences

This shows you the differences between two versions of the page.

--- devel:misc:jabref [2016/01/27 12:13] – [Including references] boemer
+++ devel:misc:jabref [2016/01/27 13:50] – [Including references] boemer
@@ Line 13: / Line 13: @@
 ===== Why JabRef? =====
-  * **Efficient reference management**: usually PDF references are saved in different folders indicating the topic of the article.  For instance, all the articles about Topic 1 are saved in a folder called Topic 1 and all the articles about Topic 2 in a folder called Topic 2.  References about Topic 1 and Topic 2 at the same time, would therefore have to be duplicated.  In JabRef, keywords, like Topic 1 and Topic 2, are simply added to the respective entry in the BibTex database and the references can be searched for them; therefore no duplicates have to exist.  Besides adding these keywords, more //properties//, like the author, the read-status, ranking, ... can be added to each reference.  Hence, it is possible to //search// for much more information than simply the file name in the classical "folder/file" management structure.
+  * **Efficient reference management**: usually PDF references are saved in different folders indicating the topic of the article.  For instance, all the articles about Topic 1 are saved in a folder called Topic 1 and all the articles about Topic 2 in a folder called Topic 2.  References about Topic 1 and Topic 2 at the same time, would therefore have to be duplicated.  In JabRef, keywords, like Topic 1 and Topic 2, are simply added to the respective entry in the BibTeX database and the references can be searched for them; therefore no duplicates have to exist.  Besides adding these keywords, more //properties//, like the author, the read-status, ranking, ... can be added to each reference.  Hence, it is possible to //search// for much more information than simply the file name in the classical "folder/file" management structure.
-  * **Easy BibTeX file editing**: references are commonly saved in the BibTeX file format to include them in a LaTeX document.  Theses files can easily become difficult to read and to edit because of their length.  JabRef simplifies this task by offering a clear //graphical user interface// to the user.
+  * **Easy BibTeX file editing**: references are commonly saved in the BibTeX file format to include them in a LaTeX document.  Theses files can easily become difficult to read and to edit because of their length.  JabRef simplifies this task by offering a clear //graphical user interface//.
-  * **Free of charge**: unlike Mendeley, Endnote, Refworks, Zotero, Citavi, ... JabRef is //free of charge//.
+  * **Free of charge**: unlike Mendeley, EndNote, RefWorks, Zotero, Citavi, ... JabRef is //free of charge//.
   * **Open source**: the JabRef source code is available at [[https://github.com/JabRef/jabref|JabRef Source Code]].
@@ Line 34: / Line 34: @@
 {{ :devel:jabref:reference_organization.png?direct&600 }}
-<note tip> It might be interesting to use the following naming syntax of reference files, like PDF articles: "Name of the first author + date of publication", e.g. Monaghan1992.  If the authour published several articles in the same year, simply add "b", "c", ..., e.g. Monaghan1992, Monaghan1992b, Monaghan1992c, ... Using the letter "a" for the first article of an author in the same year is an unnecessary burden; more than one article of the same first author in the same year is rather rare. </note>
+<note tip> It might be interesting to use the following naming syntax of reference files, like PDF articles: "Name of the first author + date of publication", e.g. Monaghan1992.  If the authour published several articles in the same year, simply add "b", "c", ..., e.g. Monaghan1992, Monaghan1992b, Monaghan1992c, ... Using the letter "a" for the first article of an author in the same year is an unnecessary burden since more than one article of the same first author in the same year is rather rare. </note>
@@ Line 44: / Line 44: @@
 ==== Creating the database ====
-A new database is simply created by clicking on ''File->New Database''.  Make sure that the database encoding is UTF-8 by clicking on ''File->Database properties'' and by selecting ''UTF-8'' in the ''Database encoding'' field.
+A new database is simply created by clicking on ''File->New Database''.  Make sure that the database encoding is //UTF-8//, i.e. the most widely used character encoding, by clicking on ''File->Database properties'' and by selecting ''UTF-8'' in the ''Database encoding'' field.
@@ Line 50: / Line 50: @@
 References can mainly be included in two different ways: either the BibTeX file of the reference is directly downloaded from the //online database//, like ScienceDirect, Springer, … or the reference is added //manually//.
+=== Including references from online databases ===
 {{ :devel:jabref:sciencedirect.png?direct&600 }}
@@ Line 75: / Line 78: @@
+=== Including references manually ===
+References are included manually by clicking on the ''New BibTeX'' entry button.  The entry type is then selected and the different fields are filled out.  It might be interesting to respect the guidelines of the previous section, i.e. use a standardized key and author format, add a link to the corresponding PDF reference, ...
+{{ :devel:jabref:add_manually.png?direct&600 }}
 ==== Citing references ====
+Citing references in LaTeX is simplified by JabRef since the reference key has not to be extracted manually.  In fact, the corresponding references can be selected and a right click makes it possible to ''Copy \cite{BibTeX key}''.
 ==== Creating groups ====
+Besides searching references by the search bar, they can be classified in groups based on keywords.  This feature eliminates the need to duplicate articles in a "file/folder" structure, if a references is relevant in two different domains.  Groups are created by clicking on ''Groups->Toogle groups interface'' and then on ''+'' in the Groups menu.  A group based on keywords is created by selecting the ''Dynamically group entries by searching a field for a keyword'' option.
 ==== Additional properties ====
+Additional properties can be associated with a reference, like a //rating// variable, a //not-printed/printed// boolean or a //not read/skimmed/read indicator//, … These options are available at ''Options->Preferences->Entry table columns''.