Synchronisation de ma liste de tâches de l'obsidienne à une base de données de notion

J'ai beaucoup commencé à utiliser l'obsidienne, car c'est un utilitaire de prise de notes fantastique avec beaucoup de fonctionnalités avancées, de plugins et de soutien communautaire.

I've started using Obsidian quite a lot, as it's a fantastic note-taking utility with a lot of advanced features, plugins, and community support. I know others who use Notion, and while I've been trying to get to grips with it, there are some things I'd like to keep in both services at all times. That's why I wrote a Python script that allows me to synchronize my to-do list from Obsidian to a Notion database.

J'ai beaucoup commencé à utiliser l'obsidienne, car c'est un utilitaire de prise de notes fantastique avec beaucoup de fonctionnalités avancées, de plugins et de soutien communautaire. Je connais d'autres personnes qui utilisent la notion, et même si j'ai essayé de les saisir, il y a des choses que je voudrais garder dans les deux services à tout moment. C'est pourquoi j'ai écrit un script Python qui me permet de synchroniser ma liste de tâches de l'obsidienne à une base de données de notion.

In order to use this script, you'll need to follow the instructions outlined below in order to generate an integration token for your Notion database. You can then give your integration access to your selected database, and it will be able to read and write to it as it needs to. Notion has a lot of different integrations readily available, but we're going to be creating our own combined with a pre-made template.

Afin d'utiliser ce script, vous devrez suivre les instructions décrites ci-dessous afin de générer un jeton d'intégration pour votre base de données de notion. Vous pouvez ensuite donner à votre intégration un accès à votre base de données sélectionnée, et il pourra le lire et l'écrire comme il en a besoin. La notion a beaucoup d'intégrations différentes facilement disponibles, mais nous allons créer notre propre combiné avec un modèle préfabriqué.

As well, this is mostly a proof of concept. While it may be useful to some in its current state, this article is designed to help you get to grips with the Notion API and build your own integrations.

De plus, il s'agit principalement d'une preuve de concept. Bien qu'il puisse être utile à certains dans son état actuel, cet article est conçu pour vous aider à saisir l'API de notion et à construire vos propres intégrations.

Setting up API access in Notion

Configuration de l'accès à l'API en notion

Notion's API is easy to use

L'API de la notion est facile à utiliser

First and foremost, Notion's API is really easy to use and quite well-documented. It can be quite hard to get started if you're not too familiar, so we'll walk you through the steps in order to create your own integration. The pictures above can also be used as a reference to ensure that you are creating the integration correctly.

D'abord et avant tout, l'API de Notion est vraiment facile à utiliser et assez bien documentée. Il peut être assez difficile de commencer si vous n'êtes pas trop familier, donc nous vous guiderons à travers les étapes afin de créer votre propre intégration. Les images ci-dessus peuvent également être utilisées comme référence pour vous assurer que vous créez correctement l'intégration.

Next, we'll need to create the Notion database that your notes will be stored in. We're going to use the To-do List template on Notion, though we'll need to remove some additional fields. This template turns each task into its own page so that you can enter additional information.

Ensuite, nous devrons créer la base de données de notion dans laquelle vos notes seront stockées. Nous allons utiliser le modèle de liste de tâches sur la notion, bien que nous devons supprimer des champs supplémentaires. Ce modèle transforme chaque tâche en sa propre page afin que vous puissiez saisir des informations supplémentaires.

Now that we have our template ready, click the "..." button (to the left of "New") and click "Customize To-dos". Click "Tasks" to remove it from the database. This will allow us to modify the fields in the template, where we can remove the "Assign" and "Due" fields. I also renamed "Task name" to simply "Name".

Maintenant que nous avons notre modèle prêt, cliquez sur le bouton "..." (à gauche de "Nouveau") et cliquez sur "Personnaliser les tâches". Cliquez sur "Tâches" pour le supprimer de la base de données. Cela nous permettra de modifier les champs dans le modèle, où nous pouvons supprimer les champs "attribuer" et "dû". J'ai également renommé le "nom de la tâche" pour simplement "nom".

Finally, we'll finish by adding our integration to the page, so that it can edit the page. Go to the very top right of the page, where there's another "..." button. Click that, hover over "Connections" and scroll down to the integration that we created. Click it, and confirm that you want to give it access to the page.

Enfin, nous terminerons en ajoutant notre intégration à la page, afin qu'elle puisse modifier la page. Allez en haut à droite de la page, où il y a un autre bouton "...". Cliquez sur cela, survolez les "connexions" et faites défiler vers l'intégration que nous avons créée. Cliquez dessus et confirmez que vous souhaitez lui donner accès à la page.

Now with our page set up, we can move on to deploying the script to synchronize our Obsidian notes with Notion!

Maintenant, avec notre page configurée, nous pouvons passer au déploiement du script pour synchroniser nos notes d'obsidienne avec notion!

Setting up our script

Configuration de notre script

You need your database ID, integration token, and Markdown file name

Vous avez besoin de votre ID de base de données, de votre jeton d'intégration et de votre nom de fichier Markdown

The script that I've written can be found on GitHub, and it's pretty easy to get set up. You'll need to have Python installed on your machine, and you'll need to place the downloaded script in the same folder as your Obsidian notes. The only required Python library that doesn't already come preinstalled is the requests library, which you can install with the following command:

Le script que j'ai écrit peut être trouvé sur GitHub, et il est assez facile de mettre en place. Vous devrez installer Python sur votre machine et vous devrez placer le script téléchargé dans le même dossier que vos notes d'obsidienne. La seule bibliothèque Python requise qui n'est pas déjà préinstallée est la bibliothèque de requêtes, que vous pouvez installer avec la commande suivante:

pip3 install requests

PIP3 Installer les demandes

Next, you'll need to replace the NOTION_TOKEN, DATABASE_ID, and TASKS variables defined at the start of the file with your details. The token is the integration token that we created earlier, and the database ID is found in the URL of the Notion database we created. The database ID is everything after "notion.so/" and everything before "?v=..." For example, a database ID might look like the following:

Ensuite, vous devrez remplacer les variables Notion_token, Database_ID et les tâches définies au début du fichier avec vos coordonnées. Le jeton est le jeton d'intégration que nous avons créé précédemment, et l'ID de base de données se trouve dans l'URL de la base de données de notion que nous avons créée. L'ID de la base de données est tout après "notion.so/" et tout avant "? V = ..." Par exemple, un ID de base de données peut ressembler à ce qui suit:

1bd1ef8871068079b3f7e7a515dc292b

1BD1EF8871068079B3F7E7A515DC292B

Finally, replace "tasks.md" with the actual name of the markdown file that you use to track your tasks. I used tasks.md to test this script, but if you already have a daily tracker, you can change the name to match the file where they're stored.

Enfin, remplacez "tasks.md" par le nom réel du fichier Markdown que vous utilisez pour suivre vos tâches. J'ai utilisé des tâches.md pour tester ce script, mais si vous avez déjà un tracker quotidien, vous pouvez modifier le nom pour correspondre au fichier où ils sont stockés.

Running the script

Exécuter le script

Now that we have everything in place, we can run the script! Simply open a terminal in the folder and run the following command:

Maintenant que nous avons tout en place, nous pouvons exécuter le script! Ouvrez simplement un terminal dans le dossier et exécutez la commande suivante:

python3 synctasks.py

python3 syctasks.py

This will then connect to your Notion database with your integration token, read your markdown file, and synchronize its contents with the server. You can also automate the running of the script so that it synchronizes multiple times a day. It will remove tasks that you delete from your notes, and it will also update the status if you change them from incomplete to completed (or vice versa).

Cela se connectera ensuite à votre base de données de notion avec votre jeton d'intégration, lira votre fichier Markdown et synchronisera son contenu avec le serveur. Vous pouvez également automatiser l'exécution du script afin qu'il se synchronise plusieurs fois par jour. Il supprimera les tâches que vous supprimerez de vos notes, et il mettra également à jour le statut si vous les modifiez de l'incomplet à terminé (ou vice versa).

This is a very basic script that will get you started with the Notion API, and you can expand on its functionality to do a lot more than just manage

Il s'agit d'un script très basique qui vous permettra de démarrer avec l'API de notion, et vous pouvez développer ses fonctionnalités pour faire bien plus que simplement gérer