Marre de perdre vos recettes quand une application ferme du jour au lendemain ? Imaginez un fichier texte simple, lisible et pérenne qui garde vos secrets de cuisine à vie. Cooklang propose exactement cela : un format léger pour écrire, versionner et partager vos recettes sans dépendre d’un service propriétaire.
Voir le sommaire
Qu’est-ce que Cooklang ?
Cooklang est un langage de markup en texte brut conçu pour décrire des recettes. Vous écrivez une recette en français normal. Puis vous ajoutez quelques marqueurs simples pour les ingrédients, les ustensiles et les temps.
La syntaxe est courte et lisible. Par exemple : @farine{200%g} pour un ingrédient avec sa quantité, #fouet{} pour un ustensile, et ~{10%minutes} pour un temps. Même sans outil, le fichier reste compréhensible.
Pourquoi l’utiliser ? Avantages concrets
Cooklang mise sur la simplicité et la pérennité. Voici les gains que vous obtenez immédiatement :
- Fichiers texte stockables partout. Pas de comptes à créer.
- Format lisible par l’humain et exploitable par la machine.
- Écosystème complet et gratuit : CLI écrit en Rust, apps mobiles, plugins pour éditeurs.
- Possibilité de versionner avec Git pour suivre les modifications et retrouver quand vous avez changé la recette.
- Mise à l’échelle intelligente des quantités. L’outil adapte la plupart des ingrédients quand vous augmentez les portions.
- Conversion rapide de recettes en ligne via un préfixe cook.md qui transforme une page web au format Cooklang.
Ce que comprend l’écosystème
Selection👁 366 regardentLe projet fournit plusieurs outils pratiques. Une interface en ligne de commande permet de lancer un petit serveur web pour consulter vos recettes dans la maison. Il existe aussi des applications pour iOS et Android. Des plugins pour VS Code, Vim et Emacs facilitent l’édition pour les amateurs d’outils.
Un plugin pour Obsidian permet d’intégrer les recettes dans votre vault. Une édition spéciale fonctionne sur Raspberry Pi Zero. Vous pouvez ainsi héberger votre livre de recettes sur le réseau local sans dépendre du cloud.
Comment ça marche en pratique
Vous créez un fichier avec l’extension .cook dans votre éditeur favori. Vous y tapez la recette en langage courant et vous marquez ingrédients et temps avec la syntaxe spécifique. Ensuite, vous pouvez :
- Générer automatiquement la liste de courses.
- Lancer des minuteurs définis dans la recette.
- Voir un rendu lisible via le serveur local ou une app.
- Versionner le fichier avec Git pour tracer chaque modification.
Notez qu’il n’y a pas de collaboration en temps réel. Chaque recette est un fichier. La synchronisation se fait via des outils comme Syncthing, Git ou un simple partage réseau.
Exemple concret : recette et format Cooklang
Selection👁 365 regardentVoici un exemple court et pratique. D’abord la recette en français lisible, puis sa version Cooklang.
Gâteau au yaourt — pour 6 personnes
Ingrédients :
- 125 g de yaourt nature (1 pot)
- 250 g de sucre
- 375 g de farine
- 60 g d’huile neutre
- 3 œufs
- 10 g de levure chimique
- 1 sachet de sucre vanillé (8 g)
- 1 pincée de sel
Préparation :
- Préchauffez le four à 180°C.
- Mélangez tous les ingrédients jusqu’à obtenir une pâte homogène.
- Versez dans un moule et enfournez 35 à 40 minutes.
Version Cooklang (fichier gâteau_yaourt.cook) :
Gâteau au yaourt — pour 6 personnes
Ingrédients :
@yaourt{125%g} @sucre{250%g} @farine{375%g} @huile{60%g} @oeufs{3%pcs} @levure{10%g} @sucre_vanille{8%g} @sel{1%pinch}
Préparation :
Préchauffez le four à ~{180%°C}.
Mélangez @yaourt{125%g}, @sucre{250%g}, @farine{375%g}, @huile{60%g}, @oeufs{3%pcs}, @levure{10%g}, @sucre_vanille{8%g} et @sel{1%pinch} jusqu’à obtenir une pâte homogène.
Versez dans un moule et enfournez ~{35%minutes} à ~{40%minutes} selon la coloration.
Si vous doublez la recette, l’outil adapte la plupart des quantités automatiquement. Pour certains éléments comme les pincées d’épices, l’ajustement reste manuel. Le comportement dépend des règles du moteur qui interprète les unités.
Installer et démarrer
Pour commencer, installez le client officiel ou l’extension pour votre éditeur. Le CLI permet de lancer un serveur local en quelques commandes. Ensuite, créez un dépôt Git et ajoutez vos fichiers .cook pour garder un historique.
Le projet est open source sous licence MIT et existe depuis janvier 2021. La communauté développe des outils et des convertisseurs pour importer des recettes depuis le web.
En résumé, Cooklang est une solution simple et robuste si vous souhaitez garder vos recettes sous votre contrôle. Vous conservez la lisibilité, gagnez en automatisation et pouvez tracer chaque évolution grâce à Git. Si vous voulez tester sans risque, créez un fichier .cook et lancez le serveur local : vos recettes restent à vous, pour toujours.