Skip to content

Commit c3793bf

Browse files
authored
Add text from issue comment
Refs JabRef/jabref#459 (comment)
1 parent 2f944d2 commit c3793bf

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

en/FileLinks.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -36,27 +36,34 @@ The editor includes buttons for inserting, editing and removing links, as well a
3636

3737
## Directories for files
3838

39-
JabRef offers following directories:
39+
JabRef offers following directory settings:
4040

4141
1. Options → Preferences → File → External file links → Main file directory
4242
![Main file directory](images/Preferences-File-MainFileDirectory.png)
43-
2. File → Library properties → General file directory
43+
2. File → Library properties → General file directory.
4444
3. File → Library properties → User-specific file directory
4545
![Override default file directories](images/LibraryProperties-OverrideDefaultFileDirectories.png)
4646

47-
One of thes settings is required.
47+
One of these settings is required.
4848
Mostly the "Main file directory" is enough.
49+
50+
JabRef enables setting a directory per database.
4951
When sharing a library across multiple persons, each user might have a different directory.
5052
Either each user can set his directory in the "Main file directory".
5153
In case the group also shares papers and thus there are two directories (the private one and a group-shared one), one can set a directory within the library (the "General file directory").
5254
In case a user has a different location of the shared folder (e.g., different paths on Linux and Windows), he can use the "User-specific file directory".
5355
This settings is persisted in the `bib` file in a way that it does not overwrite the setting of another user.
54-
For this, JabRef uses the username of the currently logged in user.
56+
For this, JabRef uses the username of the currently logged in user (`-<loginname>` is used as suffix in the `jabref-meta` field).
5557
So, both `mary` and `aileen` can set a different user-specific file directory.
5658

59+
If JabRef saves an attached file and my loginname matches the name stored in the `bib` file, it chooses that directory.
60+
If no match is found, it uses the "General file directory" of the bib file.
61+
If that is not found, it uses the one configured at Options → Preferences → File → External file links ("Main file directory").
62+
5763
In some settings, the bib file is stored in **the same directory** as the PDF files.
5864
Then, one ignore all the above directories and enable "use the BIB file location as primary file directory".
5965
In this case, JabRef starts searching for PDF files in the directory of the `bib` file.
66+
It is also possible to achieve this result by setting `.` as "General file directory" in the library properties.
6067

6168
![Use the BIB file location as primary file directory](images/Preferences-File-UseTheBibFileLocationAsPrimaryFileDirectory.png).
6269

0 commit comments

Comments
 (0)