From ac4113040576eeba9ccb40619be55d98a666bced Mon Sep 17 00:00:00 2001 From: Oliver Kopp Date: Fri, 25 Oct 2024 14:05:02 +0200 Subject: [PATCH 1/6] Update findunlinkedfiles.md --- en/collect/findunlinkedfiles.md | 63 ++++++++++++++++++++------------- 1 file changed, 39 insertions(+), 24 deletions(-) diff --git a/en/collect/findunlinkedfiles.md b/en/collect/findunlinkedfiles.md index 6ec5b6c66..74e9dfcdc 100644 --- a/en/collect/findunlinkedfiles.md +++ b/en/collect/findunlinkedfiles.md @@ -4,27 +4,49 @@ description: JabRef can create entries from PDF files. # Add entry using PDFs +## Adding using drag and rop + {% hint style="info" %} The simplest way to create a new entry based on a single PDF file is to drag & drop the file onto the table of entries (between two existing entries). JabRef will then analyze the PDF and create a new entry. {% endhint %} -This feature is available through **Lookup -> Search for unlinked local files**. +If you drop a PDF onto an entry in the main table or the entry preview in the entry editor, the PDF is simply attached to the entry. +To add a new entry based on the PDF meta data, drop it **between** two entries in the main table or onto the empty area in the maintable (available for small libraries). +The meta data of the PDF is then parsed and a new entry is added to the library. +The PDF file is moved and renamed to the library as default. +If you want to copy or just link it, hold the respective modifier keys. +On Windows, Ctrl is for copying and Alt is for linking. -{% hint style="warning" %} -This information is partially outdated. Please help to improve it ([how to edit a help page](../../contributing/how-to-improve-the-help-page.md#editing-help-pages-directly-in-the-browser)). -{% endhint %} +### Better filenames -The following description appeared first on [tex.stackexchange.com](http://tex.stackexchange.com/a/344310/9075). +JabRef changes the filenames automatically. +You can adapt the pattern at Preferences -> Import ![Preferences - Import](../.gitbook/assets/preferences-import.png) -## Preparation: Adjust the JabRef key generation pattern to fit your needs +Select "Choose pattern" and choose "bibtexkey - title" ![Preferences - Import - Choose pattern](<../.gitbook/assets/preferences-import-choose-pattern.png>). +This results in the setting `\bibtexkey\begin{title} - \format[RemoveBrackets]{\title}\end{title}`. -JabRef offers a BibTeX key generation and offers different patterns described at [BibtexKeyPatterns](../setup/citationkeypatterns.md). +This makes the filenames start with the citation key followed by the full title. +In the concrete case, `\bibtexkey` only may be the better option as the described bibtey key already contains the title. -## Link the PDFs to your bib library +More details are given at [Managing Linked Files](../finding-sorting-and-cleaning-entries/filelinks). + +## Adding files currently not linked in the library In case you have numerous PDF files and want to convert them into new entries, JabRef can search automatically for the PDF files, let you select the relevant ones, and convert them into new entries. -1. Create or open a `.bib` library. +This feature is available through **Lookup -> Search for unlinked local files**. + +### Preparation: Adjust the JabRef key generation pattern to fit your needs + +JabRef offers a BibTeX key generation and offers different patterns described at [BibtexKeyPatterns](../setup/citationkeypatterns.md). + +### Using the Wizard "Search for unlinked local files" + +{% hint style="warning" %} +This information is partially outdated. Please help to improve it ([how to edit a help page](../../contributing/how-to-improve-the-help-page.md#editing-help-pages-directly-in-the-browser)). +{% endhint %} + +1. Create or open a library (AKA a `.bib` file). 2. Go to **Lookup -> Search for unlinked local files**. (or press `SHIFT + F7`) ![FindUnlinkedFiles - Menu](<../.gitbook/assets/bildschirmfoto-2021-07-05-um-19.19.09.png>) ![FindUnlinkedFiles - Menu](<../.gitbook/assets/findunlinkedfiles-menu-5.2.png>) @@ -55,23 +77,16 @@ The imported entries may need some editing because all the information gathered ### PDFs for which it works -The importer based on the content has been written for IEEE and [LNCS](https://github.com/latextemplates/LNCS) formatted papers. Other formats are not (yet) supported. In case a DOI is found on the first page, the DOI is used to generate the BibTeX information. - -The next development step is to extract the title of the PDF, use the "Lookup DOI" and then the [Get BibTeX data from DOI](../finding-sorting-and-cleaning-entries/getbibtexdatafromdoi.md) functionality from JabRef to fetch the BibTeX data. - -We are also [thinking about](https://github.com/koppor/jabref/issues/169) replacing the code completely by using another library. This is much effort and there is no timeline for that. - -### Better filenames - -JabRef also offers to change the filenames. You can adapt the pattern at Preferences -> Import ![Preferences - Import](../.gitbook/assets/preferences-import.png) - -Select "Choose pattern" and choose "bibtexkey - title" ![Preferences - Import - Choose pattern](<../.gitbook/assets/preferences-import-choose-pattern.png>) This results in the setting `\bibtexkey\begin{title} - \format[RemoveBrackets]{\title}\end{title}`. - -This makes the filenames start with the bibtey key followed by the full title. In the concrete case, `\bibtexkey` only may be the better option as the described bibtey key already contains the title. +The importer works well if there is BibTeX on the first page of the PDF, based on the content has been written for IEEE and [LNCS](https://github.com/latextemplates/LNCS) formatted papers. +Other formats are not (yet) supported. +In case a DOI is found on the first page, the DOI is used to generate the BibTeX information. -### Mr.DLib +Background: -JabRef used to have support for [Mr.DLib](http://mr-dlib.org), which returned back a full BibTeX entry or a PDF. Due to unclear copyright situation of a used library, this service was removed. Further, Mr.DLib changes its focus and will provide literature recommendations. See [the realted articles tab](../advanced/entryeditor/#related-articles-tab). +- Embedding BibTeX inside PDFs is done by the [LaTeX authorarchive package](https://ctan.org/pkg/authorarchive) +- Having BibTeX on the first page is done by the [LaTeX CoverPage package](https://ctan.org/pkg/coverpage) +- Embedding BibTeX data [using XMP is available in JabRef](../advanced/xmp.md) +- Online parsing is enabled using the online service Grobid. ### Related questions on stack overflow From b8b10a03e554bec1952eadbc90e7ce041b701184 Mon Sep 17 00:00:00 2001 From: Christoph Date: Fri, 25 Oct 2024 14:31:47 +0200 Subject: [PATCH 2/6] Update en/collect/findunlinkedfiles.md --- en/collect/findunlinkedfiles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/collect/findunlinkedfiles.md b/en/collect/findunlinkedfiles.md index 74e9dfcdc..9a021fcf6 100644 --- a/en/collect/findunlinkedfiles.md +++ b/en/collect/findunlinkedfiles.md @@ -4,7 +4,7 @@ description: JabRef can create entries from PDF files. # Add entry using PDFs -## Adding using drag and rop +## Adding using drag and drop {% hint style="info" %} The simplest way to create a new entry based on a single PDF file is to drag & drop the file onto the table of entries (between two existing entries). JabRef will then analyze the PDF and create a new entry. From 8e8ef8345fe3916a4743035fc2ade24039ccb2b9 Mon Sep 17 00:00:00 2001 From: Oliver Kopp Date: Fri, 25 Oct 2024 15:06:23 +0200 Subject: [PATCH 3/6] Update findunlinkedfiles.md --- en/collect/findunlinkedfiles.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/en/collect/findunlinkedfiles.md b/en/collect/findunlinkedfiles.md index 9a021fcf6..8eb8b8597 100644 --- a/en/collect/findunlinkedfiles.md +++ b/en/collect/findunlinkedfiles.md @@ -81,7 +81,7 @@ The importer works well if there is BibTeX on the first page of the PDF, based o Other formats are not (yet) supported. In case a DOI is found on the first page, the DOI is used to generate the BibTeX information. -Background: +Background: - Embedding BibTeX inside PDFs is done by the [LaTeX authorarchive package](https://ctan.org/pkg/authorarchive) - Having BibTeX on the first page is done by the [LaTeX CoverPage package](https://ctan.org/pkg/coverpage) @@ -94,3 +94,5 @@ Background: * [Zotero: Extract references from PDF and create new library items from them](https://forums.zotero.org/discussion/16277/extract-references-from-pdf-and-create-new-library-items-from-them) * [Is there an open source tool for producing bibtex entries from paper PDFs?](http://academia.stackexchange.com/questions/15504/is-there-an-open-source-tool-for-producing-bibtex-entries-from-paper-pdfs) * [Extracting information from PDFs of research papers](http://stackoverflow.com/questions/1813427/extracting-information-from-pdfs-of-research-papers/3523416) + + From c56838a822b987171efc35584e75dc022df4a087 Mon Sep 17 00:00:00 2001 From: Oliver Kopp Date: Mon, 28 Oct 2024 14:17:18 +0100 Subject: [PATCH 4/6] Fix links --- en/collect/findunlinkedfiles.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/en/collect/findunlinkedfiles.md b/en/collect/findunlinkedfiles.md index 8eb8b8597..d2491a10c 100644 --- a/en/collect/findunlinkedfiles.md +++ b/en/collect/findunlinkedfiles.md @@ -28,13 +28,13 @@ This results in the setting `\bibtexkey\begin{title} - \format[RemoveBrackets]{\ This makes the filenames start with the citation key followed by the full title. In the concrete case, `\bibtexkey` only may be the better option as the described bibtey key already contains the title. -More details are given at [Managing Linked Files](../finding-sorting-and-cleaning-entries/filelinks). +More details are given at [Managing Linked Files](../finding-sorting-and-cleaning-entries/filelinks.md). ## Adding files currently not linked in the library In case you have numerous PDF files and want to convert them into new entries, JabRef can search automatically for the PDF files, let you select the relevant ones, and convert them into new entries. -This feature is available through **Lookup -> Search for unlinked local files**. +This feature is available through **Lookup -> Search for unlinked local files**. ### Preparation: Adjust the JabRef key generation pattern to fit your needs @@ -43,7 +43,7 @@ JabRef offers a BibTeX key generation and offers different patterns described at ### Using the Wizard "Search for unlinked local files" {% hint style="warning" %} -This information is partially outdated. Please help to improve it ([how to edit a help page](../../contributing/how-to-improve-the-help-page.md#editing-help-pages-directly-in-the-browser)). +This information is partially outdated. Please help to improve it ([how to edit a help page](../../contributing/how-to-improve-the-help-page.md#editing-help-pages-directly-in-the-browser.md)). {% endhint %} 1. Create or open a library (AKA a `.bib` file). From ecb319f8dbc739827057ce964037daf519c276d0 Mon Sep 17 00:00:00 2001 From: Oliver Kopp Date: Mon, 28 Oct 2024 14:24:47 +0100 Subject: [PATCH 5/6] Fix link --- en/collect/findunlinkedfiles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/collect/findunlinkedfiles.md b/en/collect/findunlinkedfiles.md index d2491a10c..cc86f9d64 100644 --- a/en/collect/findunlinkedfiles.md +++ b/en/collect/findunlinkedfiles.md @@ -43,7 +43,7 @@ JabRef offers a BibTeX key generation and offers different patterns described at ### Using the Wizard "Search for unlinked local files" {% hint style="warning" %} -This information is partially outdated. Please help to improve it ([how to edit a help page](../../contributing/how-to-improve-the-help-page.md#editing-help-pages-directly-in-the-browser.md)). +This information is partially outdated. Please help to improve it ([how to edit a help page](../contributing/how-to-improve-the-help-page.md#editing-help-pages-directly-in-the-browser.md)). {% endhint %} 1. Create or open a library (AKA a `.bib` file). From f7b6ca51b0d4bf3a0637ef7acb428aeb5cbf2bba Mon Sep 17 00:00:00 2001 From: Oliver Kopp Date: Mon, 28 Oct 2024 14:25:48 +0100 Subject: [PATCH 6/6] Fix link to LICENSE --- en/advanced/license.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/en/advanced/license.md b/en/advanced/license.md index 02175cae7..ab6ce190b 100644 --- a/en/advanced/license.md +++ b/en/advanced/license.md @@ -2,9 +2,9 @@ ## The license of the JabRef software -The JabRef software is under the [MIT License](https://github.com/JabRef/jabref/blob/main/LICENSE.md). In short, JabRef is free to use, even commercially. You can also redistribute and modify JabRef as long as you include the original copyright and license notice in any copy of the software/source. +The JabRef software is under the [MIT License](https://github.com/JabRef/jabref/blob/main/LICENSE). In short, JabRef is free to use, even commercially. You can also redistribute and modify JabRef as long as you include the original copyright and license notice in any copy of the software/source. ## The license of the JabRef documentation -The documentation of JabRef is under the [Creative Commons Attribution 4.0 International License](https://github.com/JabRef/user-documentation/blob/main/LICENSE.md). In short, you can make a commercial use of it, distribute it, modify it and rename it. You must give credit, include copyright, and state changes. And you cannot sublicense it. +The documentation of JabRef is under the [Creative Commons Attribution 4.0 International License](https://github.com/JabRef/user-documentation/blob/main/LICENSE). In short, you can make a commercial use of it, distribute it, modify it and rename it. You must give credit, include copyright, and state changes. And you cannot sublicense it.