J'ai commencé à utiliser Obsidian au début de 2023 et j'ai tout de suite accroché. Je voulais publier mes notes en ligne. J'avais déjà eu un blogue, mais cette fois, c'était différent. Avec Obsidian, j'avais l'impression d'avoir trouvé ce qu'il me fallait.
Des années plus tôt, j'avais commencé Calepin, une application de notes avec une interface et une API séparées. C'était une façon de créer un endroit pour mes notes. Cheap Publish répondait à une autre question : comment mettre sur le web les notes que j'avais déjà?
Ce texte décrit mon expérience de 2023. Ce n'est ni un comparatif actuel ni une garantie que ces projets fonctionnent encore de la même façon.
Pour l'installation ou l'état actuel du projet, commencez par la documentation du dépôt. Les changements et les listes de travaux ci-dessous sont ceux de 2023, pas une configuration que j'ai vérifiée aujourd'hui.
J'avais regardé le service officiel Publish d'Obsidian, mais en amateur de serveurs maison, pas question de payer pour héberger un site personnel. J'aime mieux passer des heures sans compter à bricoler quelque chose.
J'ai donc cherché « Obsidian Publish open source alternative » et trouvé plusieurs options :
- MindStone : une solution libre et gratuite pour remplacer Obsidian Publish.
- pubsidian : une autre option à Obsidian Publish, mais GRATUITE.
- TuanManhCao/digital-garden : pour publier gratuitement son jardin numérique.
- Markbase : pour synchroniser et publier ses documents, ses notes et son jardin numérique.
- Quartz : pour héberger gratuitement son deuxième cerveau et son jardin numérique.
- binnyva/gatsby-garden : un thème Gatsby qui produit une version HTML statique de notes Markdown.
- Obsidian to Github : pour créer et modifier un site Jekyll depuis Obsidian et le publier sur GitHub.
- ppeetteerrs/obsidian-zola : pour transformer ses notes Obsidian en site Zola sans se compliquer la vie.
Aucune n'était parfaite, pas plus que le service officiel. Mon préféré était obsidian-zola : assez simple, mais bien garni en fonctionnalités. Je l'ai essayé et j'ai rencontré quelques bogues. Comme le dépôt avait peu d'activité récente, j'ai regardé le graphe des forks pour en trouver un plus actif.
Je suis tombé sur Yarden-zamir/obsidian-zola-plus, qui ajoutait entre autres un aperçu au survol provenant d'un autre fork et les commentaires giscus, dont j'ignorais l'existence.
Puis j'ai trouvé d'autres bogues. Assez pour que ça m'agace. Cette fois, j'ai fait mon propre fork, parce que pourquoi pas. Je l'ai appelé Cheap Publish : ma mère m'a élevé pour être honnête.
Alors, qu'est-ce que j'ai changé?
Des métadonnées plus souples
J'ai ajouté les clés suivantes au frontmatter, maintenant appelé Properties dans Obsidian :
title: remplacer le titre de la page sans renommer le fichier.created: afficher la date de création, par exemplePosted February 13, 2023.modified: lorsqu'elle est présente et différente decreated, afficher les deux dates, par exemplePosted February 1, 2023, last updated February 5, 2023.
Pendant que j'étais dans cette section, j'ai réactivé le temps de lecture. L'en-tête de mon jardin affichait par exemple les dates de publication et de modification, suivies de « 1 min read ».
Extra
Je transmettais aussi toutes les clés extra du frontmatter à zola/templates/content/page.html. Pratique pour adapter le gabarit en fonction de ces valeurs.
Contourner la page d'accueil spéciale
Je n'avais pas beaucoup creusé le sujet, mais Zola traite la page d'accueil comme une « page spéciale ». Je voulais simplement y afficher une page normale provenant de mes notes.
Mon fork le permettait. Pour être parfaitement honnête, je n'étais pas certain à 100 % que la page d'accueil d'origine fonctionnait encore 😬.
Pour la contourner, je définissais REDIRECT_HOME dans netlify.toml avec le chemin de destination, par exemple REDIRECT_HOME = "README". Cela donnait cette valeur au paramètre redirect_to de la section principale. Voici la documentation des sections de Zola; l'exemple décrit ma configuration de 2023, pas nécessairement le fork actuel.
Redimensionner les images
Ce manque m'agaçait beaucoup, puisque c'est pris en charge directement dans Obsidian.
Voici les deux syntaxes que j'acceptais pour une image de 100 pixels de large :

or

L'URL est fictive. À l'époque, je faisais ça dynamiquement en JavaScript parce que j'étais paresseux, et seules ces syntaxes étaient prises en charge.
Quelques corrections et changements
- La barre latérale ne rechargeait plus toute la page quand on cliquait sur un lien ou une ancre.
- Le graphe ne sautait plus au premier survol. Il était aussi plus joli, avec une petite animation au chargement 😻.
- J'avais retiré le
/docsobligatoire : les pages étaient servies directement à/. - J'avais retiré
frontmatter=neverdelocal-run.sh(pourquoi!?). - J'avais corrigé la détection des URL d'aperçu à partir de l'hôte; ça ne réglait peut-être pas tous les cas.
- J'avais mis
obsidian-exportà la dernière version disponible à ce moment-là. - Les noms de fichiers pouvaient contenir un
., comme1. Start hereou2. Once Upon A Time. Utile pour une barre latérale triée par nom. - Le style des
blockquoteétait amélioré. - J'avais désactivé, en le mettant en commentaire, le dollar simple $ dans
renderMathInElementde LaTeX/KaTeX.
À faire
C'était ma liste de 2023, pas un état de ce qui reste à faire aujourd'hui :
- Écrire un vrai README avec les instructions d'utilisation.
- Documenter mes changements à la disposition des commentaires — j'utilisais Remark42 — ou retirer leur configuration pour laisser chacun choisir et se débrouiller.
- Corriger le graphe quand l'URL contient un
#: le nœud courant ne semblait pas défini. - Identifier les liens externes.
- Ouvrir les liens externes dans une nouvelle fenêtre.
Liste de souhaits
Encore un instantané de 2023, pas une feuille de route actuelle :
- Mieux prendre en charge le redimensionnement des images.
- Permettre de trier la barre latérale avec une clé du frontmatter.