內容簡介
Zotero Notes 外掛可在個別文章或頁面中插入編號引用及參考文獻列表，並透過 Zotero API 確保資料安全與穩定性，提供學術寫作的便利性。
【主要功能】
• 插入編號引用與參考文獻列表
• 使用 Zotero API 確保資料安全
• 自動快取與故障回退機制
• 設定快取更新間隔（1-168 小時）
• 支援手動清除快取
外掛標籤
開發者團隊
原文外掛簡介
Zotero Notes inserts numbered citations and a references list on individual posts or pages. It uses the Zotero API over verified HTTPS and stores a fresh cache and a last-known-good fallback for temporary outages.
Usage (the shortcode can be changed in Settings):
[zref]VP5PKI56[/zref]
[zref name="source"]VP5PKI56[/zref]
[zref name="source" /] (reuse an earlier named citation)
Configure the Zotero user ID and private API key under Settings > Zotero Notes. The API key is kept server-side; a blank key field during editing retains the saved key. The cache freshness interval defaults to 12 hours, and can be set between 1 and 168 hours. Temporary HTTP/network failures use the last valid response, if one exists; missing items and unauthorized access do not use a stale fallback. The cache may be purged manually from the settings page.
The plugin does not edit article content in the database and keeps the historical shortcode and option keys.
Cache and availability limitations
Zotero Notes requires access to the Zotero API and a valid Zotero user ID (plus an API key for private libraries) to fetch an item for the first time. An item that has never been fetched successfully cannot be displayed from the cache if Zotero is unreachable.
Successful responses are cached as fresh for 12 hours by default (configurable from 1 to 168 hours). After that interval, the plugin attempts to retrieve an updated response. If the request fails because of a temporary network/API problem, the last successfully retrieved response is displayed when available. That fallback can be outdated and is not a guarantee that the reference is current or still available in Zotero. Temporary failures are retried after a short delay (currently five minutes), not continuously on every page view.
HTTP 401, 403 and 404 responses do not use the stale fallback. A manual cache purge removes both fresh entries and their last-known-good backups. After a purge, Zotero must be reachable to retrieve references again. If Zotero is unavailable and no valid copy exists, the plugin cannot render the reference. The plugin does not synchronize changes from Zotero automatically.
Français : limites d’accès et de cache
La première récupération d’une référence nécessite un accès à l’API Zotero, un identifiant d’utilisateur valide et, pour une bibliothèque privée, une clé API autorisée. Sans première récupération réussie, aucune copie de secours n’est disponible.
Les réponses restent fraîches pendant 12 heures par défaut (durée réglable entre 1 et 168 heures). Passé ce délai, l’extension tente une actualisation. En cas d’échec temporaire de l’accès réseau ou de l’API, elle peut afficher la dernière réponse valide enregistrée. Cette copie peut être périmée : elle ne garantit ni l’actualité ni la présence de la référence dans Zotero. Les nouveaux essais sont temporairement espacés (actuellement cinq minutes).
Les réponses HTTP 401, 403 et 404 ne déclenchent pas ce repli sur la dernière valeur. Une purge manuelle supprime aussi les copies de secours : un nouvel accès à Zotero est alors nécessaire. Sans accès à Zotero et sans copie valide, la référence ne peut pas être affichée. Les modifications réalisées dans Zotero ne sont pas répercutées instantanément.
Français
Zotero Notes ajoute des appels de notes et une bibliographie à la fin des articles et pages consultés individuellement. Les références proviennent de l’API Zotero en HTTPS avec validation TLS. Le cache conserve les données fraîches (12 heures par défaut, durée configurable) ainsi que la dernière version valide en cas d’indisponibilité temporaire de Zotero. Une purge manuelle est disponible dans Réglages > Zotero Notes. La clé API reste côté serveur, et laisser le champ vide conserve la clé actuelle.
Syntaxe : [zref]VP5PKI56[/zref], [zref name="source"]VP5PKI56[/zref], puis [zref name="source" /] pour réutiliser la référence.
