L'app de notes pour dev qui répare ce qu'Obsidian ne peut pas (SiYuan)

BBetter Stack
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00C'est peut-être la meilleure alternative à Obsidian et Notion que j'ai trouvée jusqu'ici.
00:00:05La plupart des développeurs pensent que leurs notes sont organisées jusqu'au moment où ils cherchent quelque chose.
00:00:10Les miennes sont un vrai désordre, mais pour moi, elles sont organisées.
00:00:14Des fichiers Markdown, des liens morts, des pages Notion balancées au hasard.
00:00:18Notre code a une structure, mais mes notes, non.
00:00:21Voici SiYuan.
00:00:23Un outil de connaissance personnelle open source qui permet de refactoriser vos pensées comme du code, avec
00:00:28des IDs de blocs permanents, des bases de données, du SQL intégré et un contrôle total
00:00:33en auto-hébergement local.
00:00:34Désormais, nos notes fonctionnent davantage comme notre code.
00:00:36Dans les prochaines minutes, je vais vous montrer pourquoi c'est sans doute le meilleur outil
00:00:40de prise de notes pour développeurs.
00:00:42SiYuan est une base de connaissances open source privilégiant le stockage local.
00:00:50La plupart des outils lient des fichiers, SiYuan lie des blocs.
00:00:53Chaque paragraphe, liste ou bloc de code possède son propre identifiant permanent.
00:00:59Ainsi, quand on déplace des éléments, rien ne se casse.
00:01:02C'est crucial pour rédiger de la doc, suivre des bugs ou organiser une architecture.
00:01:06En plus, vous avez des bases de données intégrées, des requêtes SQL, le mode hors ligne et l'auto-hébergement Docker.
00:01:13Au lieu de choisir entre puissance et propriété des données, on a les deux ici.
00:01:18Laissez-moi vous montrer à quoi cela ressemble concrètement.
00:01:20Si vous aimez les outils open source et les conseils de code, n'oubliez pas de vous abonner
00:01:24à la chaîne Better Stack.
00:01:25Nous publions des vidéos régulièrement.
00:01:27En gros, j'ai récupéré le repo, ajouté ce fichier Docker Compose, puis lancé
00:01:31avec Docker Compose.
00:01:33Tout était opérationnel en une minute, rien de bien sorcier.
00:01:37Avec un nouveau carnet de notes, je suis prêt à commencer.
00:01:40Je peux créer une note, ajouter un titre.
00:01:43Ça fonctionne exactement comme Notion.
00:01:46Et je peux maintenant ajouter un bloc de code.
00:01:48Je vais insérer un peu de Python.
00:01:50Je vais aussi intégrer ce bloc ailleurs.
00:01:54Et voici le moment clé.
00:01:55Je déplace le bloc d'origine et la référence fonctionne toujours.
00:01:59Plus jamais de liens brisés.
00:02:01Ça change radicalement notre façon de penser et de travailler.
00:02:04On ne s'inquiète plus de l'emplacement d'une info, mais de son utilité.
00:02:09Créons maintenant une petite base de données de tâches.
00:02:12Je vais ajouter un genre de bug.
00:02:14On peut lui assigner un statut et une priorité.
00:02:16Et comme le SQL est intégré, je peux l'interroger directement dans mes notes.
00:02:23Ensuite, je peux passer en vue graphique pour voir comment tout est connecté.
00:02:26Cette vue est incroyable, j'adore cette fonctionnalité.
00:02:30C'est l'idée principale à retenir.
00:02:31Des blocs stables, de vraies bases de données et une structure qui tient grâce à ce graphique
00:02:37interactif qui montre les connexions au sein de notre base de données.
00:02:43C'est vraiment très utile.
00:02:45Alors, en quoi est-ce différent de ce qu'on utilise déjà ?
00:02:47Avec Obsidian, tout repose sur les fichiers.
00:02:50Avec SiYuan, tout repose sur les blocs.
00:02:53Cela signifie qu'on ne lie pas une page.
00:02:55On lie l'élément de connaissance exact à l'intérieur.
00:02:58Que ce soit une décision, un bug ou un extrait de code.
00:03:00C'est là toute la différence.
00:03:01Obsidian ressemble à un dossier de notes très puissant.
00:03:04SiYuan ressemble plus à un système structuré avec bases de données et SQL
00:03:09sans avoir besoin de chercher des plugins.
00:03:10Comparons maintenant à Notion.
00:03:12Notion offre la structure, mais c'est sur le cloud.
00:03:16SiYuan offre la même structure en local, hors ligne et en open source.
00:03:21Et je ne paie rien.
00:03:22Les développeurs l'utilisent pour de la doc projet, des extraits de code, des wikis ou bases de connaissances.
00:03:29C'est un second cerveau local et open source, mais structuré comme un
00:03:34document de conception système.
00:03:35Alors, Notion ?
00:03:36Obsidian ?
00:03:37Pour être honnête, c'est un excellent outil.
00:03:40Les mises à jour sont rapides et l'auto-hébergement Docker prend deux minutes.
00:03:45Les références de blocs stabilisent les notes volumineuses dans cet écosystème fragile,
00:03:51et les bases de données offrent une vraie structure sans dépendre du cloud.
00:03:54Mais d'un autre côté, ou plutôt, parlons des inconvénients.
00:03:59L'inconvénient, c'est que SiYuan ne stocke pas tout en Markdown pur.
00:04:03Il utilise son propre format particulier, le .sy.
00:04:06C'est donc à prendre avec des pincettes.
00:04:08On peut exporter en Markdown, mais ce n'est pas natif au système.
00:04:11Le marché des plugins est bien plus petit, surtout en anglais car c'est basé en Chine.
00:04:17Certains trouvent l'interface un peu datée, mais franchement, ça ressemble à Notion.
00:04:21Et avec de très grands espaces de travail, il faut parfois lancer des optimisations.
00:04:25Voici le moyen le plus simple de décider de l'utiliser ou non.
00:04:29Si votre config repose sur des fichiers Markdown et des plugins, Obsidian reste logique.
00:04:34Mais si vos notes deviennent de la documentation, des systèmes et du savoir à long terme,
00:04:40SiYuan devient bien plus pertinent.
00:04:42Utilisez-le pour des données structurées, des liens solides et un contrôle total.
00:04:46Mon avis sur tout ça ?
00:04:47Si vous cherchez une nouvelle façon d'organiser vos notes sans être déjà
00:04:51trop investi dans Notion, alors foncez.
00:04:53Mais soyons réalistes.
00:04:54Si vous utilisez déjà Notion depuis longtemps, ce sera une galère
00:04:58de changer maintenant.
00:05:00À ce stade, mieux vaut probablement rester sur Notion ou Obsidian.
00:05:03Mais si votre système actuel commence à montrer ses limites, ça vaut le coup d'essayer.
00:05:06C'est vraiment top.
00:05:08Très utile, surtout avec ce graphique de base de connaissances.
00:05:11Si vous aimez les outils de code open source et les astuces comme celle-ci, abonnez-vous
00:05:15à la chaîne Better Stack.
00:05:16On se retrouve dans une prochaine vidéo.

Key Takeaway

SiYuan remplace la gestion de fichiers par une structure de blocs permanents et des bases de données SQL locales pour offrir aux développeurs un système de documentation robuste et auto-hébergé.

Highlights

  • SiYuan utilise des identifiants de blocs permanents pour chaque paragraphe, liste ou extrait de code afin d'empêcher la rupture des liens lors du déplacement d'informations.

  • L'outil intègre nativement des bases de données avec support des requêtes SQL pour organiser les tâches, les bugs ou la documentation sans dépendre de plugins tiers.

  • L'installation s'effectue en moins de deux minutes via un fichier Docker Compose pour un contrôle total des données en auto-hébergement local.

  • Le logiciel stocke les données dans un format propriétaire .sy plutôt qu'en Markdown natif, bien que l'exportation vers ce format reste possible.

  • Une vue graphique interactive permet de visualiser les connexions structurelles entre les différents éléments de la base de connaissances.

  • Le marché des plugins est principalement orienté vers la communauté chinoise, ce qui limite les options disponibles en langue anglaise ou française.

Timeline

Architecture par blocs et stabilité des liens

  • Chaque élément de contenu possède son propre identifiant permanent unique.
  • Le déplacement d'un bloc de code ou d'un paragraphe ne casse jamais les références croisées.
  • Le système privilégie le stockage local et l'open source pour garantir la propriété des données.

Les méthodes traditionnelles de prise de notes reposent sur la liaison de fichiers entiers, ce qui crée souvent des liens morts. Cette approche granulaire permet de refactoriser ses pensées comme du code source. Le système combine la flexibilité de Notion avec la confidentialité d'un outil local.

Déploiement technique et fonctionnalités de base

  • L'instance complète fonctionne en une minute via Docker Compose.
  • L'interface autorise l'insertion dynamique de code Python et d'autres langages.
  • Le SQL intégré permet d'interroger directement les bases de données de tâches ou de bugs.

L'utilisateur garde la main sur son infrastructure grâce à l'auto-hébergement Docker. Les fonctionnalités incluent la création de carnets de notes structurés où l'on assigne des statuts et des priorités aux éléments. La visualisation graphique affiche en temps réel l'interconnexion des informations.

Comparaison avec Obsidian et Notion

  • Obsidian se limite à une gestion de fichiers tandis que SiYuan gère des blocs de connaissances précis.
  • SiYuan offre gratuitement une structure de base de données locale là où Notion impose le cloud.
  • L'outil fonctionne intégralement hors ligne sans nécessiter de compte ou d'abonnement.

SiYuan se positionne entre la puissance brute d'Obsidian et l'organisation structurée de Notion. Il évite la recherche fastidieuse de plugins complexes en intégrant nativement les outils de gestion de données. C'est un second cerveau conçu pour ressembler à un document de conception système.

Limites techniques et critères de choix

  • Le format de stockage .sy s'éloigne du standard Markdown pur utilisé par d'autres outils.
  • L'écosystème de plugins est restreint en dehors du marché chinois.
  • Le coût de migration depuis un système établi comme Notion est élevé malgré les avantages techniques.

Le format de fichier propriétaire constitue un risque pour l'interopérabilité à long terme. L'interface peut paraître datée et nécessite des optimisations manuelles pour les bases de données volumineuses. Le choix de l'outil dépend de la complexité de la documentation à produire et du besoin de liens solides.

Community Posts

View all posts