notero
v0.6.7
Notero est un plugin Zotero permettant de synchroniser des éléments et des notes dans Notion. Pour l'utiliser :
Concept par @arhoff ???? | Construit avec ? par @dvanoni
Le plugin Notero surveille les éléments Zotero ajoutés ou modifiés dans les collections que vous spécifiez dans les préférences Notero. Chaque fois qu'un élément est ajouté ou modifié, Notero effectue plusieurs opérations :
notion à l'élément Zotero.En plus de fournir un moyen pratique d'ouvrir une page Notion depuis Zotero, la pièce jointe du lien sert également de référence pour Notero afin qu'il puisse mettre à jour la page Notion correspondante pour un élément Zotero donné.
Par défaut, Notero synchronisera les éléments de vos collections surveillées chaque fois qu'ils seront modifiés. Vous pouvez désactiver cette fonctionnalité en décochant l'option Synchroniser lorsque les éléments sont modifiés dans les préférences Notero.
Vous pouvez également synchroniser les éléments à partir des menus contextuels de la collection ou des éléments (clic droit) :
Note
Pour empêcher la fonctionnalité « synchronisation lors de la modification » d'être enregistrée plusieurs fois dans Notion, Notero n'informe pas Zotero lorsque la balise et le lien attachés sont ajoutés à un élément. Cela signifie qu'ils peuvent ne pas apparaître immédiatement dans Zotero et que vous devrez peut-être naviguer vers un autre élément et revenir en arrière pour les faire apparaître.
Les notes Zotero associées à un élément peuvent être synchronisées dans Notion en tant que contenu de la page correspondante pour cet élément. Comme pour les éléments normaux, vous pouvez synchroniser manuellement les notes à l'aide de l'option Sync to Notion dans le menu contextuel.
La synchronisation automatique des notes peut être activée via l'option Synchroniser les notes dans les préférences Notero. Lorsqu'elles sont activées, les notes seront automatiquement synchronisées chaque fois qu'elles seront modifiées. De plus, lorsqu'un élément standard est synchronisé, toutes ses notes seront également synchronisées si ce n'est pas déjà fait.
Pour synchroniser les annotations (notes et surlignages) d'un PDF, vous devez d'abord les extraire dans une note Zotero :
L'utilisation de Notero nécessite la configuration d'une base de données Notion, sa connexion à Notero et l'installation du plugin Notero dans Zotero. Les instructions de configuration détaillées sont ci-dessous.
Créez la base de données Notion dans laquelle vous souhaitez synchroniser les éléments Zotero.
Consultez les exemples ci-dessous que vous pouvez dupliquer dans votre espace de travail Notion.
Créez une intégration interne de Notion sur https://www.notion.com/my-integrations et activez toutes les « capacités de contenu ».
Prenez note du « secret d’intégration interne » de l’étape précédente.
Donnez à votre intégration l’accès à votre base de données.
À partir de la documentation du développeur Notion :
- Accédez à la page de la base de données dans votre espace de travail.
- Cliquez sur le menu ••• Plus dans le coin supérieur droit de la page.
- Faites défiler vers le bas et cliquez sur Se connecter à .
- Recherchez et sélectionnez votre intégration dans le menu Rechercher des connexions....
Configurez les propriétés de la base de données comme vous le souhaitez. Consultez la section Propriétés de la base de données ci-dessous pour plus de détails.
Notero peut synchroniser les données pour les propriétés répertoriées ci-dessous. La seule propriété requise par Notero est celle avec le type de propriété Title . Les autres propriétés sont facultatives, vous pouvez donc utiliser uniquement celles qui correspondent à vos besoins.
La propriété Title peut être nommée autrement que Name tant qu’elle n’entre en conflit avec aucun des autres noms de propriété. Le nom et le type des autres propriétés doivent être configurés exactement comme spécifié ici. Notez que les noms de propriétés sont sensibles à la casse, les majuscules doivent donc correspondre exactement.
La prise en charge de la personnalisation des propriétés est prévue à l'avenir ; voir le numéro 355.
| Nom de la propriété | Type de propriété | Remarques |
|---|---|---|
Name | Titre | Format configurable via l'option Notion Page Title dans les préférences Notero |
Abstract | Texte | |
Authors | Texte | |
Citation Key | Texte | Nécessite un meilleur BibTeX |
Collections | Sélection multiple | |
Date | Texte | |
Date Added | Date | |
Date Modified | Date | |
DOI | URL | |
Editors | Texte | |
Extra | Texte | |
File Path | Texte | |
Full Citation | Texte | Format basé sur le paramètre Zotero pour Exportation → Copie rapide → Format de l'élément |
In-Text Citation | Texte | Format basé sur le paramètre Zotero pour Exportation → Copie rapide → Format de l'élément |
Item Type | Sélectionner | |
Place | Texte | |
Proceedings Title | Texte | |
Publication | Texte | |
Series Title | Texte | |
Short Title | Texte | |
Tags | Sélection multiple | |
Title | Texte | |
URL | URL | |
Year | Nombre | |
Zotero URI | URL | Ouvre les éléments de la bibliothèque Web si vous êtes connecté à Zotero |
Important
.xpi ..xpi à partir de la section Actifs de la page de la dernière version..xpi soit :Pour plus de guides visuels sur la configuration et l'utilisation de Notero, consultez les ressources suivantes créées par de merveilleux membres de la communauté :
Si vous souhaitez partager comment vous utilisez Notero et que vous souhaitez être répertorié ici, n'hésitez pas à soumettre un PR ou à me contacter !
Même si ce serait bien, cela dépasse malheureusement la portée de ce plugin. Obtenir des mises à jour de Notion dans Zotero nécessiterait la configuration d'un service hébergé qui s'abonne aux webhooks de Notion, puis utilise l'API Zotero pour mettre à jour les éléments dans Zotero. Notion n'a pas encore publié le support officiel des webhooks, mais certains outils tiers peuvent être utilisés à cet effet. En théorie, c’est techniquement possible, mais ce serait un projet distinct.
Il n'existe actuellement aucun bon moyen de synchroniser des fichiers ou de créer des liens vers des fichiers locaux en raison des limitations suivantes avec Notion :
http: et https: il n'est donc pas possible de créer un lien direct vers le fichier à l'aide d'une URL file: :.Pour l'instant, les meilleures solutions de contournement sont :
File Path pour vous diriger vers l’emplacement du fichier local.Zotero URI , puis ouvrir le fichier à partir de là.Pour synchroniser plusieurs éléments qui se trouvent déjà dans une collection surveillée, vous pouvez le faire à partir des menus contextuels de la collection ou de l'élément. Voir la section Synchronisation des éléments ci-dessus.
Si vous recevez l'erreur suivante :
APIResponseError : Impossible de trouver la base de données avec l'ID : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Cela signifie très probablement que vous n'avez pas donné à Notero l'accès à votre base de données Notion. Assurez-vous de suivre toutes les étapes de la section Configurer Notion. En cliquant sur le bouton ••• dans le coin supérieur droit de votre base de données, vous devriez afficher une connexion pour l'intégration que vous avez créée pour Notero.
Si vous recevez l'erreur suivante :
APIResponseError : impossible de mettre à jour une page archivée. Vous devez désarchiver la page avant la mise à jour.
Cela peut se produire lorsque Notero tente de synchroniser un élément pour lequel une page Notion a déjà été créée à partir d'une synchronisation précédente, mais que cette page a depuis été supprimée. (Notez que la suppression d'une page Notion la déplace dans la corbeille, et l'API Notion l'appelle « archivée ».)
Comme décrit dans la section Comment fonctionne Notero, Notero associe les éléments Zotero aux pages Notion via un lien nommé Notion attaché à l'élément. Pour résoudre le problème, supprimez cette pièce jointe de lien sur le ou les éléments incriminés, puis effectuez à nouveau la synchronisation.
Si vous recevez l'erreur suivante :
APIResponseError : la propriété n'est pas une propriété qui existe
Cela peut se produire si vous avez déjà synchronisé des éléments dans une base de données Notion, puis modifiez vos préférences Notero pour spécifier une base de données différente. Notero essaie peut-être de mettre à jour les pages de l'ancienne base de données au lieu de créer des pages dans la nouvelle base de données, et cette erreur peut se produire si différentes propriétés ont été configurées dans les différentes bases de données.
Pour résoudre ce problème, vous devez supprimer l'ancienne base de données dans Notion, puis la supprimer définitivement de la corbeille dans Notion.
Nous fournissons quelques exemples de bases de données Notion qui ont été configurées avec toutes les propriétés synchronisées par Notero.
Une fois que vous avez ouvert l'un des exemples, cliquez sur le bouton Dupliquer dans le coin supérieur droit de la page pour le dupliquer dans votre espace de travail Notion.
Une base de données vide qui contient uniquement les propriétés synchronisées par Notero. Utile si vous souhaitez repartir de zéro et le personnaliser vous-même.
Une base de données avec plusieurs vues et quelques exemples d'entrées. Voir ci-dessous pour les descriptions de la façon dont vous pouvez utiliser les différentes vues.
DOI ou URL .Extra de Zotero.Zotero URI pour afficher/modifier l'entrée dans Zotero ou pour exporter l'entrée bibliographique dans un style de citation différent. Related References (par exemple, des articles dans le même numéro spécial, des chapitres de livre dans le même ouvrage édité, des études et des commentaires qui répondent ou prolongent d'autres ouvrages). Notero a été échafaudé avec le générateur-zotero-plugin et utilise des scripts de construction fortement inspirés de zotero-plugin. Un grand merci à @retorquere pour ces créations.
Les étapes ci-dessous sont basées sur la documentation de développement du plugin Zotero et devraient vous permettre de créer et d'exécuter Notero vous-même.
Pour éviter tout dommage potentiel à votre profil Zotero par défaut, vous pouvez créer un nouveau profil à des fins de développement.
Créez un fichier nommé zotero.config.json qui contiendra les options de configuration utilisées pour démarrer Zotero. Voir zotero.config.example.json pour un exemple de fichier contenant des descriptions de toutes les options de configuration disponibles.
Installer les dépendances :
npm ci
Construisez Notero et démarrez Zotero avec le plugin installé :
npm start
Alternativement, vous pouvez démarrer la version bêta de votre choix de Zotero :
npm run start-beta
Le script start effectue un certain nombre d'étapes :
Exécutez npm run build pour créer le plugin dans le répertoire build .
Si elle est définie, exécutez la commande scripts.prestart spécifiée dans zotero.config.json .
Écrivez un fichier contenant le chemin absolu du répertoire build dans le répertoire extensions du répertoire de profil Zotero.
Supprimez les lignes extensions.lastAppBuildId et extensions.lastAppVersion de prefs.js dans le répertoire de profil Zotero.
Démarrez Zotero avec le profil spécifié dans zotero.config.json et les arguments de ligne de commande suivants :
-purgecaches -ZoteroDebugText -jsdebugger -datadir profile
Si elle est définie, exécutez la commande scripts.poststart spécifiée dans zotero.config.json , en lui fournissant une variable d'environnement ZOTERO_PID .
Les versions sont effectuées via GitHub Actions. Le workflow release définit les tâches suivantes :
release-please Ce travail utilise l'action release-please pour créer des PR de version lorsque de nouveaux commits destinés aux utilisateurs sont poussés vers la branche main . Une version PR modifiera la version du package et mettra à jour le journal des modifications. Lorsque le PR est fusionné, cette tâche crée ensuite une nouvelle balise de version et une nouvelle version GitHub.
publish-artifacts Ce travail s'exécute lorsqu'une nouvelle version est créée par le travail release-please . Il crée le fichier .xpi et le publie dans la version. Il génère également un fichier manifeste mis à jour et le publie dans la version release .
