From 52cec0af5f9a65ce36d80c908754b74c0fedf8e1 Mon Sep 17 00:00:00 2001 From: Eng-YasminKotb Date: Thu, 3 Sep 2026 15:29:37 +0300 Subject: [PATCH 1/5] Fix grammar and typos in Getting Started page --- en/getting-started.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/en/getting-started.md b/en/getting-started.md index a554343a7..a70b283a8 100644 --- a/en/getting-started.md +++ b/en/getting-started.md @@ -14,7 +14,7 @@ Some videos to help you start using JabRef: ## Main Window of JabRef -Upon the first start of JabRef the main user interface is showing up the main elements are: +Upon the first start of JabRef, the main user interface appears. The main elements are: * Menu bar * Icon bar (shortcuts for most frequently used features) @@ -51,13 +51,13 @@ This opens a dialog where you can select the type of reference you want to store ![Screenshot of "new entry" dialog](.gitbook/assets/getting-started-new-entry.png) -For our running example we will select "Article". +For our running example, we will select "Article". -After clicking on the "Article" button, the dialog closes and the so called "Entry Editor" is opened for the newly created entry: +After clicking on the "Article" button, the dialog closes and the so-called "Entry Editor" is opened for the newly created entry: ![Main window now showing the entry editor](.gitbook/assets/getting-started-entry-editor.png) -The most important information about the reference to be added can now be entered in the "Main" tab. "Author", "Title", "Journal", and "Year" should be self-explanatory - however, a "citationkey", might not be familiar to you. Basically, the idea of the "citationkey" is coming from working with BibTeX, where it is necessary to have an unique identifier for each entry. This allows for referencing within a document you might be creating using the stored information in your library. Moreover, also within JabRef this "key" is used for example for cross-references to other related entries or to determine file names for full-text references. +The most important information about the reference to be added can now be entered in the "Main" tab. "Author", "Title", "Journal", and "Year" should be self-explanatory - however, a "citationkey", might not be familiar to you. Basically, the idea of the "citationkey" is coming from working with BibTeX, where it is necessary to have a unique identifier for each entry. This allows for referencing within a document you might be creating using the stored information in your library. Moreover, also within JabRef this "key" is used for example for cross-references to other related entries or to determine file names for full-text references. The key usually follows a global pattern and can be easily created automatically by clicking on the "generate" button next to the field. @@ -82,7 +82,7 @@ After creating the basic information the addition of all other bibliographical d ![Update information from web](.gitbook/assets/getting-started-entry-editor-update-from-web.png) {% hint style="info" %} -The found information is most accurate if an identifier like a "DOI" or "ISBN" is maintained. If you already know such an unique identifier, this can also be already the starting point to create a new entry without manual entering any information by using the "create from ID" feature in the Create entry dialog. For more information see: [Collect](https://docs.jabref.org/collect) > ["Add entry using an ID"](https://docs.jabref.org/collect/add-entry-using-an-id) +The found information is most accurate if an identifier like a "DOI" or "ISBN" is maintained. If you already know such a unique identifier, this can also be already the starting point to create a new entry without manual entering any information by using the "create from ID" feature in the Create entry dialog. For more information see: [Collect](https://docs.jabref.org/collect) > ["Add entry using an ID"](https://docs.jabref.org/collect/add-entry-using-an-id) {% endhint %} If additional information is found you will be asked in a dialog which information should be taken over: @@ -91,10 +91,10 @@ If additional information is found you will be asked in a dialog which informati ## Adding a full text document -Usually, you also want to attach a reference to the full-text of a reference. For this, you can use the "file" field in the "General" tab. Here you can either attach a file manually, search for an already existing local file matching the citationkey pattern, or trying to automatically download a matching full text from the web. +Usually, you also want to attach a reference to the full-text of a reference. For this, you can use the "file" field in the "General" tab. Here you can either attach a file manually, search for an already existing local file matching the citationkey pattern, or try to automatically download a matching full text from the web. {% hint style="info" %} -In order to use the automated feature, it is necessary to set-up a file directory first. To do so, please go to "Options" > "Preferences", go to "Linked files" section, and select there an existing folder as the "Main file directory": +In order to use the automated feature, it is necessary to set-up a file directory first. To do so, please go to "Options" > "Preferences", go to "Linked files" section, and select an existing folder there as the "Main file directory": {% endhint %} To test the automatic download of full texts you can click on the "Get full-text" icon next to the file field, or choose "Lookup" -> "Search full text documents online" from the menu. As soon as a full-text is found, the file will be stored in the local file directory and linked to the entry: @@ -107,15 +107,15 @@ To open the downloaded full text you can click on the "file" icon before the fil If you want to search for other references, it is also possible to directly trigger a search in many of the most common bibliographic databases. To start a search just use the "Web Search" feature of JabRef: First select one of the existing data sources, enter a search term and click on "search": -The search results will be shown in an window where you can select all the search hits to be added to your library. +The search results will be shown in a window where you can select all the search hits to be added to your library. ![Web Search: Trigger and result window](.gitbook/assets/getting-started-import-from-web.png) ## Next steps -After adding more and more entries, your library might be a bit too unstructured. In order to keep all you references organized JabRef is offering a lot of helpful features like grouping, consistency checks, etc. +After adding more and more entries, your library might be a bit too unstructured. In order to keep all your references organized, JabRef is offering a lot of helpful features like grouping, consistency checks, etc. -You can find more information on this topics in the "Organize" section of the documentation: +You can find more information on these topics in the "Organize" section of the documentation: {% content-ref url="finding-sorting-and-cleaning-entries/" %} [finding-sorting-and-cleaning-entries](finding-sorting-and-cleaning-entries/) From a5a597290e6cfd33143fdb09b83dd5ab19810c0c Mon Sep 17 00:00:00 2001 From: Eng-YasminKotb Date: Mon, 7 Sep 2026 19:09:02 +0300 Subject: [PATCH 2/5] Document moving entries between libraries feature --- en/advanced/main-window.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/en/advanced/main-window.md b/en/advanced/main-window.md index 3ead2f5b7..d3fa7ded5 100644 --- a/en/advanced/main-window.md +++ b/en/advanced/main-window.md @@ -17,3 +17,12 @@ This is the main window from where you work with your databases. Below the menub * Adjust the width of each column by dragging the borders between their headers. ![Adjust width of columns](../.gitbook/assets/adjust-width-of-columns.png) + +### Copying or Moving Entries Between Libraries + +You can copy or move entries between open library tabs: + +1. Select one or more entries in the source library. +2. Drag the entries to the target library's tab:
+ - By default, JabRef **copies** the entries to the target library.
+ - Hold `Shift` while dragging to **move** the entries. The entries are removed from the source library after they have been successfully added to the target library. From a4397a162e2322e2794753f64beb2829ad544015 Mon Sep 17 00:00:00 2001 From: Eng-YasminKotb Date: Tue, 8 Sep 2026 00:28:26 +0300 Subject: [PATCH 3/5] Fix Inline HTML error --- en/advanced/main-window.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en/advanced/main-window.md b/en/advanced/main-window.md index d3fa7ded5..fa85fb9da 100644 --- a/en/advanced/main-window.md +++ b/en/advanced/main-window.md @@ -23,6 +23,6 @@ This is the main window from where you work with your databases. Below the menub You can copy or move entries between open library tabs: 1. Select one or more entries in the source library. -2. Drag the entries to the target library's tab:
- - By default, JabRef **copies** the entries to the target library.
+2. Drag the entries to the target library's tab: + - By default, JabRef **copies** the entries to the target library. - Hold `Shift` while dragging to **move** the entries. The entries are removed from the source library after they have been successfully added to the target library. From 4445ce7fcee69665457f2abb6e08cd0f9ad7b7f3 Mon Sep 17 00:00:00 2001 From: Eng-YasminKotb Date: Sun, 1 Nov 2026 13:43:40 +0200 Subject: [PATCH 4/5] Document enhane drag and drop entries description --- en/advanced/main-window.md | 11 ++--------- 1 file changed, 2 insertions(+), 9 deletions(-) diff --git a/en/advanced/main-window.md b/en/advanced/main-window.md index fa85fb9da..8bc68848d 100644 --- a/en/advanced/main-window.md +++ b/en/advanced/main-window.md @@ -17,12 +17,5 @@ This is the main window from where you work with your databases. Below the menub * Adjust the width of each column by dragging the borders between their headers. ![Adjust width of columns](../.gitbook/assets/adjust-width-of-columns.png) - -### Copying or Moving Entries Between Libraries - -You can copy or move entries between open library tabs: - -1. Select one or more entries in the source library. -2. Drag the entries to the target library's tab: - - By default, JabRef **copies** the entries to the target library. - - Hold `Shift` while dragging to **move** the entries. The entries are removed from the source library after they have been successfully added to the target library. +* You can drag selected entries to another open library's tab to copy them. Hold `Shift` while dragging to move them instead. +* You can copy and paste entries between open libraries using `Ctrl+C` and `Ctrl+V` (Windows/Linux) or. From 08196988e340c17dc41266990dccaa8e30e2b3cd Mon Sep 17 00:00:00 2001 From: Eng-YasminKotb Date: Sun, 1 Nov 2026 14:17:25 +0200 Subject: [PATCH 5/5] Fix documented line --- en/advanced/main-window.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/advanced/main-window.md b/en/advanced/main-window.md index 8bc68848d..e1c59c42b 100644 --- a/en/advanced/main-window.md +++ b/en/advanced/main-window.md @@ -18,4 +18,4 @@ This is the main window from where you work with your databases. Below the menub ![Adjust width of columns](../.gitbook/assets/adjust-width-of-columns.png) * You can drag selected entries to another open library's tab to copy them. Hold `Shift` while dragging to move them instead. -* You can copy and paste entries between open libraries using `Ctrl+C` and `Ctrl+V` (Windows/Linux) or. +* You can copy and paste entries between open libraries using `Ctrl+C` and `Ctrl+V` (Windows/Linux).