Présentation du plugin Gitlab Issues pour Obsidian | par Ben Robert

Intégrez automatiquement les problèmes de Gitlab dans votre coffre-fort de notes Obsidian

Si vous n’avez pas entendu parler Obsidienne pourtant, il s’agit d’un système de base de connaissances personnelles, qui fonctionne sur des fichiers texte brut au format Markdown.

Fondamentalement pour moi, c’est une application qui s’installe localement et qui fonctionne sur votre local fichiers qui se trouvent dans texte brut format.

Cela signifie qu’il n’y a pas de formats de documents propriétaires à gérer, je ne suis enfermé dans aucun fournisseur de cloud en ligne et, en fin de compte, si Obsidian disparaît un jour de la carte, toutes mes données importantes sont toujours accessibles dans ma plaine locale fichiers texte. Ce sont des facteurs critiques pour moi si je dois verser toutes mes notes dans n’importe quelle application.

Obsidian est disponible pour toutes les plateformes — Windows, Mac, Linux, Android et iOS.

Gitlab est un service qui fournit des services de code source tels que Git et Mercurial pour héberger le code et les artefacts associés. Il est disponible en tant que service cloud avec un niveau gratuit sur Gitlab.com mais peut également être installé en tant que solution privée sur site pour les grandes organisations.

Mon besoin du plugin Gitlab Issues pour Obsidian a commencé lorsque j’ai commencé à gérer toutes mes tâches dans Obsidian. Une fois que je l’ai configuré comme je le voulais, j’étais vraiment content, mais il manquait une chose – j’avais une deuxième source de tâches pour toutes les applications logicielles sur lesquelles je travaillais, et toutes ces tâches étaient dans Gitlab.

Donc, étant un programmeur compétent, j’ai fait ce que n’importe qui d’autre ferait et j’ai mis au point ma propre solution, pour importer des problèmes Gitlab, via l’API Gitlab, dans mon coffre-fort Obsidian.

Je suis heureux d’annoncer qu’hier, le plugin a été approuvé et est maintenant disponible dans la base de données officielle Obsidian Community Plugins. Cela signifie que vous pouvez l’installer directement depuis la zone des paramètres Obsidian.

Le principe du plugin est assez simple. Il interrogera le API Gitlab pour les problèmes, et créez des fichiers de notes Obsidian pour chaque problème renvoyé. Si un problème n’est plus renvoyé par l’API, la note Obsidian est supprimée.

Cela signifie que les notes elles-mêmes doivent certainement être considérées comme en lecture seule. Toutes les modifications que vous apportez seront perdues. Cependant, la source principale de connaissances pour ces problèmes se trouve sur Gitlab et doit rester sur Gitlab, donc cette nature éphémère des notes est intentionnelle et non accidentelle.

Pour commencer, accédez simplement à la section Community Plugins des paramètres Obsidian et recherchez «Obsidian Gitlab Issues». Installez le plugin.

Vous devez ensuite créer un jeton Gitlab avec API privilèges sur Gitlab. Ne le partagez avec personne.

De retour dans Obsidian, accédez à l’écran des paramètres du plug-in qui ressemble à ceci :

Entrez le jeton API dans le champ Jeton d’accès personnel, choisissez un dossier de sortie et vous êtes prêt à partir.

Si vous activez l’icône du ruban, cliquez dessus pour charger immédiatement tous les problèmes que vous avez en attente dans votre Gitlab. Sinon, les problèmes sont chargés 30 secondes après le démarrage d’Obsidian, puis toutes les 15 minutes.

La valeur par défaut consiste à charger les problèmes dont la date d’échéance se situe dans le mois suivant, mais cela peut être configuré à l’aide de l’un des paramètres de filtre fournis par le API des problèmes Gitlab.

Vous avez donc maintenant un ensemble de notes, chacune représentant un problème Gitlab. Vous pouvez les utiliser et les présenter comme bon vous semble, et les options d’Obsidian sont vastes.

Je suggère que la façon de commencer rapidement est avec l’excellent Plug-in DataViewComment pour créer des listes de problèmes à venir à intégrer où vous le souhaitez dans votre coffre-fort. Par exemple:

dataview  
TABLE WITHOUT ID file.link AS "Task", dueDate AS "Due Date" from "@Data/Gitlab Issues"  
SORT dueDate

Si vous fermez ensuite un problème sur Gitlab ou modifiez sa date d’échéance pour qu’elle soit plus éloignée dans le futur, le problème sera supprimé de votre coffre-fort et le DataView la liste n’affichera plus le problème.

Une fois que vous avez configuré et travaillé, vous pouvez vous amuser avec les choses à votre guise.

Le plugin est encore assez nouveau mais a été assez bien testé. Si vous rencontrez des problèmes ou avez d’autres questions, veuillez laisser un commentaire ici ou créer un problème sur le Référentiel GitHub où le code source est hébergé.