Skip to content

Commit a75131c

Browse files
kopporSiedlerchr
andauthored
Update findunlinkedfiles.md (#537)
Co-authored-by: Christoph <[email protected]>
1 parent 79e893d commit a75131c

File tree

2 files changed

+43
-26
lines changed

2 files changed

+43
-26
lines changed

en/advanced/license.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
## The license of the JabRef software
44

5-
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.
5+
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.
66

77
## The license of the JabRef documentation
88

9-
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.
9+
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.
1010

en/collect/findunlinkedfiles.md

Lines changed: 41 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -4,27 +4,49 @@ description: JabRef can create entries from PDF files.
44

55
# Add entry using PDFs
66

7+
## Adding using drag and drop
8+
79
{% hint style="info" %}
810
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.
911
{% endhint %}
1012

11-
This feature is available through **Lookup -> Search for unlinked local files**.
13+
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.
14+
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).
15+
The meta data of the PDF is then parsed and a new entry is added to the library.
16+
The PDF file is moved and renamed to the library as default.
17+
If you want to copy or just link it, hold the respective modifier keys.
18+
On Windows, <kbd>Ctrl</kbd> is for copying and <kbd>Alt</kbd> is for linking.
1219

13-
{% hint style="warning" %}
14-
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)).
15-
{% endhint %}
20+
### Better filenames
1621

17-
The following description appeared first on [tex.stackexchange.com](http://tex.stackexchange.com/a/344310/9075).
22+
JabRef changes the filenames automatically.
23+
You can adapt the pattern at Preferences -> Import ![Preferences - Import](../.gitbook/assets/preferences-import.png)
1824

19-
## Preparation: Adjust the JabRef key generation pattern to fit your needs
25+
Select "Choose pattern" and choose "bibtexkey - title" ![Preferences - Import - Choose pattern](<../.gitbook/assets/preferences-import-choose-pattern.png>).
26+
This results in the setting `\bibtexkey\begin{title} - \format[RemoveBrackets]{\title}\end{title}`.
2027

21-
JabRef offers a BibTeX key generation and offers different patterns described at [BibtexKeyPatterns](../setup/citationkeypatterns.md).
28+
This makes the filenames start with the citation key followed by the full title.
29+
In the concrete case, `\bibtexkey` only may be the better option as the described bibtey key already contains the title.
30+
31+
More details are given at [Managing Linked Files](../finding-sorting-and-cleaning-entries/filelinks.md).
2232

23-
## Link the PDFs to your bib library
33+
## Adding files currently not linked in the library
2434

2535
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.
2636

27-
1. Create or open a `.bib` library.
37+
This feature is available through **Lookup -&gt; Search for unlinked local files**.
38+
39+
### Preparation: Adjust the JabRef key generation pattern to fit your needs
40+
41+
JabRef offers a BibTeX key generation and offers different patterns described at [BibtexKeyPatterns](../setup/citationkeypatterns.md).
42+
43+
### Using the Wizard "Search for unlinked local files"
44+
45+
{% hint style="warning" %}
46+
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)).
47+
{% endhint %}
48+
49+
1. Create or open a library (AKA a `.bib` file).
2850
2. Go to **Lookup -> Search for unlinked local files**. (or press `SHIFT + F7`)
2951

3052
![FindUnlinkedFiles - Menu](<../.gitbook/assets/bildschirmfoto-2021-07-05-um-19.19.09.png>) ![FindUnlinkedFiles - Menu](<../.gitbook/assets/findunlinkedfiles-menu-5.2.png>)
@@ -55,27 +77,22 @@ The imported entries may need some editing because all the information gathered
5577

5678
### PDFs for which it works
5779

58-
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.
80+
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.
81+
Other formats are not (yet) supported.
82+
In case a DOI is found on the first page, the DOI is used to generate the BibTeX information.
5983

60-
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.
61-
62-
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.
63-
64-
### Better filenames
84+
Background:
6585

66-
JabRef also offers to change the filenames. You can adapt the pattern at Preferences -> Import ![Preferences - Import](../.gitbook/assets/preferences-import.png)
67-
68-
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}`.
69-
70-
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.
71-
72-
### Mr.DLib
73-
74-
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).
86+
- Embedding BibTeX inside PDFs is done by the [LaTeX authorarchive package](https://ctan.org/pkg/authorarchive)
87+
- Having BibTeX on the first page is done by the [LaTeX CoverPage package](https://ctan.org/pkg/coverpage)
88+
- Embedding BibTeX data [using XMP is available in JabRef](../advanced/xmp.md)
89+
- Online parsing is enabled using the online service Grobid.
7590

7691
### Related questions on stack overflow
7792

7893
* [Extract titles from each page of a PDF?](http://stackoverflow.com/q/18071127/873282)
7994
* [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)
8095
* [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)
8196
* [Extracting information from PDFs of research papers](http://stackoverflow.com/questions/1813427/extracting-information-from-pdfs-of-research-papers/3523416)
97+
98+
<!-- markdownlint-disable-file MD033 -->

0 commit comments

Comments
 (0)