Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update findunlinkedfiles.md #537

Merged
merged 6 commits into from
Oct 28, 2024
Merged

Update findunlinkedfiles.md #537

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
ac41130
Update findunlinkedfiles.md
koppor Oct 25, 2024
b8b10a0
Update en/collect/findunlinkedfiles.md
Siedlerchr Oct 25, 2024
8e8ef83
Update findunlinkedfiles.md
koppor Oct 25, 2024
c56838a
Fix links
koppor Oct 28, 2024
ecb319f
Fix link
koppor Oct 28, 2024
f7b6ca5
Fix link to LICENSE
koppor Oct 28, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions en/advanced/license.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

65 changes: 41 additions & 24 deletions en/collect/findunlinkedfiles.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,27 +4,49 @@ description: JabRef can create entries from PDF files.

# Add entry using PDFs

## 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.
{% 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, <kbd>Ctrl</kbd> is for copying and <kbd>Alt</kbd> 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.

More details are given at [Managing Linked Files](../finding-sorting-and-cleaning-entries/filelinks.md).

## Link the PDFs to your bib library
## 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 -&gt; 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.md)).
{% 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>)
Expand Down Expand Up @@ -55,27 +77,22 @@ 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 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.

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
Background:

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.

### Mr.DLib

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

* [Extract titles from each page of a PDF?](http://stackoverflow.com/q/18071127/873282)
* [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)

<!-- markdownlint-disable-file MD033 -->
Loading