REX 2 ans d'Obsidian

Nicolas BOSSARD.
Dev and Test days.
01 Oct 2024.

note: pres écrite avec :

• Obsidian
• Plugin Obsidian Advanced slides (reveal.js)
  • https://github.com/MSzturc/obsidian-advanced-slides
  • https://mszturc.github.io/obsidian-advanced-slides/
• Press the »S« key on your keyboard to open the notes window

Qui suis-je?

note:

• Startup interne Mahali

Au programme

• REX utilisation quotidienne
• licence et compatibilité
• construction 2ème cerveau, WTF...
• un programme extensible (plugins)

Impressions à l'utilisation Obisidian

depuis Noël 2022.

En perso...

...et en pro : repo documentation Mahali, puis Orange Money Business KPI.

Remplace les outils

• carte mentale (Freemind/freeplane)
• Anki

--

note:
Prb carte mentale : difficulté à communiquer le savoir pendant et après le projet.

--

--

note:
Prb Anki:

• au bout d'un moment trop de note, impossible à réviser
• et même si on ne révise pas, l'outil n'est pas prévu pour ça.

--

Clarifie mes besoins :

• prendre des notes
• les partager maintenant et plus tard
• les améliorer, les maintenir sans effort
• les retrouver à défaut de s'en souvenir

Impression générale

Outil très stable et rapide, très bien fini.

Pas de ralentissement quand le repo grossit.

Ecrire ou améliorer la doc est agréable (si si).

Outil extensible

• 27 plugins officiels
• 1895 community plugins validés (09-2024)

Les plugins validés sont très stables et bien finis.

note:

• https://help.obsidian.md/Plugins/Core+plugins (09-2024)
• Présentation de quelques plugins coups-de-coeur en fin de pres.
• les plugins validés le sont via une PR sur https://github.com/obsidianmd/obsidian-releases, une relecture auto et humaine

Ex de qualité : support Vim

• intégré,
• correcte sauf les buffers

--

"We want to make it possible for your digital notes to be preserved for generations to come"

(site web Obsidian)

Markdown et file system

Tout ce qu'on fait dans Obsidian repose sur du markdown et des fichiers.

Licence

"Obsidian is not open source software"

Effectivement problématique.
Free for personal use, not for commercial use.

--

Achat d'une licence "Catalyst license (Insider)"

Bénéfices supposés:

• Support development
• Early access to beta versions
• Special community badges
• Access to VIP channel

...ça n'a rien changé pour moi.

--

Payant pour "commercial use"

"Commercial use refers to using Obsidian for revenue-generating or work-related activities within a for‑profit company that has two or more people"

==> Achat de licences pour utilisation au sein du KPI business server, objectif d'évangélisation.

note:
Tarif $50 USD Per user, per year.
Autres sources revenu

• synchronisation fichiers
• publication web

configuration pour ce faire

...éviter l'obsidian spécifique :

• remplacement "[[" "]]" par le standard "[]()"
• donner des titres aux markdowns
• se forcer à faire des dossiers

note: replace "wikilink" by "markdownlink"

Changements de pratiques

Arrêter d'appeler les fichiers 'README.md'

===> rend difficile les recherches et les liens

Combien de vault (repos)?

Mon choix :

• un seul pour le perso et le pro
• un repo par projet pro

On peut faire des liens entre repos.

Comment gérer la redondance?

Objectif : construire un second cerveau

note: pas seulement un slogan commercial.
obsidian est axé sur les liens entre les notes qui permettent de retrouver des données et prendre du recul.

Le concept clé : les liens

Obsidian aide à facilement connecter les notes entre elles.
Ou des sous parties de notes.

Conseil :

• Faire de petites notes facilement linkable
• faire des liens à la volée, c'est ultra rapide
• laisser des liens vides pour plus tard

Connection 1er -2ème cerveau : les daily notes

template (+ plugins calendar??) ou simple lien auto entre les notes.

Connections 1er-2ème cerveau : multiplier les points d'entrées

par exemple :

• les personnes
• une carte géographique

Son 2ème cerveau dans sa poche?

Utilisation sur mobile très rapide également.

Synchronisation via plugin git (ci-dessous).

La plupart des plugins fonctionnent également, ils sont desactivables.

Réutilisation des notes

Quel réutilisation dans la pratique personnellement:

1. Surtout les personnes.
2. les procédures, les manuels utilisation logiciels.
3. repartir sur un projet mis en pause qque temps

Plugins

Note:

• comme vim ou taskwarrior, à la base ça fait pas grand chose
• concept plugin au coeur du logiciel : activer que ce qu'on souhaite utiliser
• core plugins et community plugins

Core Plugins : Graph view

Inutilisée, inutilisable? en global ou en local au document.
(De plus pas de sauvegarde de la config.)

Les linked mentions (aka backlinks) font aussi bien le job.
(mais attention les non obsidian ne les voient pas).

--

Plugin : Omnisearch

Recherche intégrée rapide... mais plugin omnisearch peut mieux faire :

• fusionne la recherche par texte ou par fichier
• supporte une orthographe imparfaite (ex "go-craft/gocrat")
• index les pdf (voir même les images)
• rapide
• intègre une API HTTP permettant de chercher dans le repo

--

note:
le résultat mélange ici des images et des fichiers texte

--

note:
ici le plugin tampermonkey exécute un script qui modifie la page d'accueil de Google pour y inclure les résultats trouvés dans le repo obsidian (sous le titre en jaune)

--

Plugin : GIT

ok sur pc, ✔

inutilisable sur mobile ☠

(lenteurs et gestion des conflits) utilisation en combinaison avec client git mgit (dispo sur f-droid).

Sur iOS utiliser working copy

--

Jusqu'à l'arrivée sur mon mobile de ...

note: Orange force intune... intune autorise seulement le playstore, le playstore bloque la seule application git... on a une bonne équipe de vainqueurs pour pourrir le quotidien.

--

Plugin : dataview

Faire des requêtes sur les "données" du repo.
Fonctionne parfaitement en combinaison avec :

• les templates
• plugin quick add
• les tags, les properties
• d'autres plugins de visualisation (ex : heatmap calendar)

--

--

Plugin : dataview - dataviewjs

dv.span("**🏋️ Sessions 🏋️**")
const calendarData = {
    colors: {
        red: ["#ff9e82"]
    },
    entries: []
}

for(let page of dv.pages('#session')){
    calendarData.entries.push({
        date: page.file.name.substring(0,10),
        intensity: 1,
    })
       
}

renderHeatmapCalendar(this.container, calendarData)

--

--

Et du coup on peut faire des scripts comme

 await dv.view("scripts/loaddailyimages")

pour ajouter les photos du smartphone du jour à la daily note.
Sans surcharger le repo git.

Plugin : Map View ❣

Nouvel axe de connexion entre premier cerveau et deuxième cerveau.

Indexe tous les lieux dans tous les fichiers et les rend visible sur une carte (openstreetmap, youhou)

--

--

--

Plugin : smart connect

Smart connect (interroger son repo avec Chatgpt et les embeddings)

--

Plugin : mais aussi

• Digital garden (publication sur site web Vercel)
• Smart connect (interroger son repo avec Chatgpt et les embeddings)

--

Export Mkdocs

Permet de générer un joli site web avec menus et barre de recherche à partir d'un ensemble de fichiers markdown.

Utile pour rendre la doc accessible aux non-utilisateurs d'Obsidian.

--

Mise en place dans un projet

Mise en place dans le fichier gitlab-ci en utilisant le template to be continuous "mkdocs" : https://gitlab.tech.orange/to-be-continuous/mkdocs

Utilisation ensuite des GitLab Pages pour rendre dispo le résultat.

Bref

• super outil pour survivre à l'infobésité:
  • léché
  • stable
  • addictif
  • riche en fonctionnalités
  • extensible
  • en développement rapide

...des questions ?

contact

@nbossard@mastodon.social

slides :

• Disponibles sur mon mini-site : https://nbossard-outils.vercel.app/

Historique de la présentation

• 2023-09-22 présentation en physique à David BLANCHET et Vincent MAHE, réorganisation des slides.
• 2023-10-09 présentation en distant à 15 personnes internes Orange.
• 2024-04-10 Présentation à Gi LENTE WANG et Laurent AUBERTIN
• 2024-09-18 Mise à jour pour le dev and test day 2024