diff --git a/.linkspector.yml b/.linkspector.yml index 7a463966b..8c426b298 100644 --- a/.linkspector.yml +++ b/.linkspector.yml @@ -3,3 +3,5 @@ dirs: useGitIgnore: true ignorePatterns: - pattern: '^https://arxiv\.org/' + # Automated access blocked by Cloudflare, see issue for context: https://github.com/JabRef/jabref/issues/13404 + - pattern: "onlinelibrary\\.wiley\\.com" diff --git a/en/.gitbook/assets/preferences-web-search-api-keys.png b/en/.gitbook/assets/preferences-web-search-api-keys.png new file mode 100644 index 000000000..e65a7bf58 Binary files /dev/null and b/en/.gitbook/assets/preferences-web-search-api-keys.png differ diff --git a/en/.gitbook/assets/preferences-wiley-tdm-token.png b/en/.gitbook/assets/preferences-wiley-tdm-token.png new file mode 100644 index 000000000..5466f26b4 Binary files /dev/null and b/en/.gitbook/assets/preferences-wiley-tdm-token.png differ diff --git a/en/collect/add-pdfs-to-an-entry.md b/en/collect/add-pdfs-to-an-entry.md index 0939222e6..38b6f63e0 100644 --- a/en/collect/add-pdfs-to-an-entry.md +++ b/en/collect/add-pdfs-to-an-entry.md @@ -15,3 +15,40 @@ Then, JabRef uses online services to find a PDF. (Implementation details are pro Result of the look up:

Look up result

+ +## Supported sources + +JabRef uses different publishers and services to find full text documents. When multiple sources find a PDF for the same entry, JabRef prefers results from higher-trust sources (e.g., a publisher's own site is preferred over a meta-search aggregator). + +## Configuring API keys + +Some publishers/services require an API key to work. You can configure API keys in **File > Preferences > Web search**. + +

Configuring API keys in Preferences > Web search

+ +For each publisher that supports an API key, click the **"Configure API key"** button next to it to enter your key. + +The following publishers require API keys: + +| Publisher | API key | +| --- | --- | +| Wiley TDM | **Required.** Without a token, Wiley PDF downloads will fail (Wiley blocks direct downloads). See [Wiley setup](#wiley-tdm-setup) below. | + +### Wiley TDM setup + +Wiley journals cannot be downloaded directly because Wiley blocks automated access with Cloudflare protection. Instead, JabRef uses Wiley's official [Text and Data Mining (TDM) API](https://onlinelibrary.wiley.com/library-info/resources/text-and-datamining) to retrieve PDFs. + +To set it up: + +1. Go to the [Wiley TDM page](https://onlinelibrary.wiley.com/library-info/resources/text-and-datamining) and sign in with your Wiley account. +2. Accept the click-through license agreement to receive your personal TDM API token. +3. In JabRef, go to **File > Preferences > Web search**. +4. Find **"Wiley TDM"** in the list, click **"Configure API key"**, paste your token, and check **"Save API key to use in future?"**. + +

Configuring the Wiley TDM token

+ +After configuring the token, **Lookup > Find full text documents online** will be able to download PDFs for Wiley DOIs. + +{% hint style="info" %} +The Wiley TDM token is personal and non-transferable. Each user needs to obtain their own token. You can only access articles that your institution subscribes to. +{% endhint %}