← Retour à la liste
BrewRecipes® v1.9 « j'ai rendez-vous »
Image
Guide d’utilisation et documentation — mode d’emploi

© 2026 Jean-Luc B. / BrassageAmateur.com

Ouvrir BrewRecipes — Importer une recette
Sommaire

Présentation

BrewRecipes® est l’application communautaire de BrassageAmateur.com pour partager des recettes de brassage au format BeerXML, intégrée au forum phpBB 3.3.

Cette page d’aide est servie par l’extension (BrewRecipes® v1.9 « j'ai rendez-vous ») : FAQ BrewRecipes. Elle est mise à jour avec le code — plus besoin d’une page phpBB Pages séparée à chaque release.

La bibliothèque regroupe 172 recettes partagées par les membres (après nettoyage de la base).

En résumé, BrewRecipes® permet de :
  • importer et publier des fichiers BeerXML (une ou plusieurs recettes par fichier)
  • comprendre le format BeerXML et les outils compatibles (chapitre Qu’est-ce que le BeerXML…)
  • réparer un export BeerXML incomplet et le réutiliser ailleurs (voir Réparation BeerXML)
  • voir l’astuce du jour sur la liste des recettes (v1.7)
  • consulter une bibliothèque avec recherche, filtres et tri
  • rechercher dans toute la recette avec l’option « chercher partout »
  • afficher des fiches détaillées (ingrédients, brassage, fermentation, photo)
  • obtenir une analyse BrewRecipes (synthèse + détail) calculée à partir des stats et du style
  • demander, à l’import ou à l’édition, une analyse IA complémentaire (Claude, Gemini ou ChatGPT)
  • consulter une timeline graphique du déroulé du brassage (membres connectés)
  • exporter un calendrier de brassage au format `.ics` depuis la timeline (v1.9 — voir section Calendrier)
  • imprimer une fiche recette (format A4 épuré) ou la timeline (paysage)
  • commenter et noter les recettes des autres membres
  • marquer des favoris et retrouver vos propres recettes
  • découvrir une recette au hasard depuis la bibliothèque
  • insérer une mini-fiche dans un message du forum (BBCode)
  • partager une fiche par MP, nouveau sujet, e-mail, WhatsApp ou copie d’URL
  • recevoir des alertes dans la cloche du forum (commentaire, favori, citation, partage)
  • préparer une étiquette de bière via un prompt IA (ChatGPT) et un QR code vers la fiche (auteur)
  • retrouver les styles des guides de référence (BJCP, ABC, BA, FADØL, etc.) avec liens vers le wiki
  • utiliser BrewRecipes en multilingue : interface en français ou en anglais (voir section Multilingue)
  • utiliser l’application sur ordinateur comme sur mobile.

Philosophie du projet

BrewRecipes® n’a pas vocation à remplacer les logiciels avancés de brassage (planification fine, inventaires, etc.).

L’objectif est une plateforme :
  • simple et rapide à utiliser
  • communautaire, au cœur du forum BrassageAmateur
  • centrée sur le partage et la découverte de recettes BeerXML
  • enrichie par une analyse pédagogique (BrewRecipes) et, si vous le souhaitez, un avis IA indicatif — jamais un jugement BJCP officiel.
Merci pour vos contributions, vos retours et le partage de vos brassins sur le forum.

Qu’est-ce que le fichier BeerXML et qui l’utilise ?

Le BeerXML est un format de fichier XML ouvert, conçu pour décrire et échanger des recettes de brassage : malts, houblons, levures, empâtage, fermentation, statistiques (OG, FG, IBU, couleur…), notes, etc. Un fichier `.xml` peut contenir une ou plusieurs recettes. C’est la « langue commune » entre la plupart des logiciels et services de brassage amateurs.

Le standard BeerXML 1.0 a été élaboré à partir des années 2000 par des auteurs de logiciels de brassage (dont Brad Smith pour BeerSmith) afin de permettre l’échange de recettes entre programmes. La spécification et des exemples sont publiés sur le site du standard (en anglais). L’adoption reste volontaire : chaque éditeur implémente l’import et l’export à sa manière, d’où parfois des fichiers incomplets — BrewRecipes peut les réparer (voir Réparation BeerXML).

Référence du standard Voici des exemples d’outils qui importent ou exportent du BeerXML — pour préparer une recette ailleurs ou réimporter un fichier issu de BrewRecipes. Après un export réparé, vérifie volumes, efficacité et houblons : chaque outil recalcule un peu différemment.

Logiciels bureau Solutions en ligne Automates de brassage et portails recette Cette liste n’est pas exhaustive : d’autres outils acceptent le BeerXML. BrewRecipes teste l’import depuis les sources ci-dessus — les exports partiels sont souvent réparables à l’import (voir Réparation BeerXML). Envoyez-moi un MP pour suggérer d’autres solutions compatibles.

Version desktop et version mobile

BrewRecipes s’adapte à la taille de votre écran. Selon que vous consultez l’application sur ordinateur ou smartphone, l’interface et les fonctions proposées diffèrent volontairement.

Version desktop (ordinateur, tablette en paysage ou fenêtre large)

Sur un écran large (typiquement 768 px et plus en mode bureau), vous disposez de l’ensemble des fonctionnalités de BrewRecipes® : bibliothèque avec filtres avancés, import BeerXML, réparation et export, fiche complète, analyses BrewRecipes et IA, timeline graphique (onglet Fiche / Timeline), impression fiche et timeline, édition auteur, étiquette IA, BBCode, partage, favoris, notifications, etc.

Version mobile (smartphone, largeur inférieure à 768 px)

Pour les téléphones, nous avons conçu une interface redessinée, plus lisible au toucher, centrée sur la consultation et les actions du quotidien :
  • liste des recettes et recherche
  • fiche résumé (style, verre EBC, auteur, statistiques clés)
  • accès aux détails (ingrédients, brassage, fermentation), notes et analyses
  • calendrier de brassage : bouton 📅 Ajout au calendrier sur la fiche résumé (v1.9 — voir section Calendrier de brassage)
  • favoris, partage et édition pour l’auteur de la recette
Correctif v1.9 : sur iOS Safari, la navigation entre résumé, détails, notes et analyses ne provoque plus de rechargement intempestif de la page.

Nous avons limité la version mobile aux fonctionnalités principales, faciles à utiliser sur un petit écran. Les actions plus complètes ou rares sur mobile — import multi-recettes, assistant de réparation BeerXML, impression, étiquette IA, etc. — restent accessibles via la version desktop.

Timeline en paysage

En faisant pivoter le smartphone en mode paysage sur une fiche recette, BrewRecipes affiche automatiquement la timeline graphique du brassage — la même vue que sur ordinateur, adaptée à la largeur de l’écran.

Portrait — fiche résumé
Portrait — fiche résumé
Paysage — timeline graphique automatique
Paysage — timeline graphique automatique


Bibliothèque, tri et filtres

La page Recettes partagées liste les recettes actives. Cliquez sur une ligne pour ouvrir la fiche complète.

Tri
  • Cliquez sur un en-tête de colonne pour trier : Recette, Brasseur, Publication, Style, IBU, ABV, EBC, Notes.
  • Un second clic sur la même colonne inverse l’ordre (▲ croissant / ▼ décroissant).
  • Il n’y a plus de menu déroulant « Trier par » : le tri se fait directement dans le tableau.
Indicateur « analysée par IA »
  • Une icône IA peut apparaître après le nom d’une recette lorsqu’une analyse IA a été enregistrée pour cette fiche.
  • L’en-tête de la colonne Recette rappelle la signification de cette icône : analysée par IA.
  • L’absence d’icône ne signifie pas qu’il n’y a pas d’analyse BrewRecipes : seule l’analyse IA est signalée dans la liste.
Filtres
  • Le panneau Filtres est ouvert par défaut au chargement de la page. Vous pouvez le replier ou le rouvrir avec le bouton 🔎 Filtres.
  • Affinez la liste avec :
    • Nom de recette : par défaut, seul le nom de la recette est pris en compte
    • case « chercher partout » (à côté du champ « Nom de recette ») : étend la recherche au nom et aux notes (brassage, dégustation), au brasseur, au style, aux ingrédients (malts, houblons, levures, divers), à l’empâtage, etc.
    • ingrédient (malt, houblon, levure, etc.)
    • style BJCP
    • brasseur (membre du forum) — liste triée A–Z, insensible à la casse (v1.7)
    • plages EBC, IBU et ABV (curseurs)
    • nombre de recettes affichées par page (10, 20, 50 ou 100).
  • Les recettes comportant des notes de brassage (saisies par l’auteur) peuvent afficher un extrait sous le titre dans la liste.
Astuce du jour (v1.7)
  • en haut de la liste des recettes, une courte astuce du jour (rotation pédagogique, contenu « Avec BrewRecipes, tu peux… ») change chaque jour.
Barre d’aide
  • Sous les filtres, une barre propose :
    • ❓ Aide et FAQ (cette page)
    • 💬 BrewRecipes sur le forum (sujet dédié aux retours)
    • 🎲 Une recette au hasard : ouvre directement une fiche recette choisie aléatoirement dans la bibliothèque.

Favoris et « Mes recettes »

Favoris
  • Sur la fiche recette, le symbole ♡ / ❤️ ajoute ou retire la recette de vos favoris.
  • Un filtre dédié sur la bibliothèque permet d’afficher uniquement vos favoris.
Mes recettes
  • Le bouton Mes recettes (filtres) n’affiche que les fiches dont vous êtes l’auteur (compte forum lié à la recette).

Importer une recette BeerXML

Pour partager une ou plusieurs recettes :
  1. Cliquer sur Ajouter une ou des recettes (import BeerXML)
  2. Sélectionner un fichier .xml exporté depuis votre logiciel de brassage
  3. Prévisualiser chaque recette détectée dans le fichier
  4. Choisir ou confirmer le style BJCP si nécessaire (guides proposés avec le plus récent d’abord, ex. BJCP 2021 avant 2015 — v1.7)
  5. Consulter l’aperçu de l’analyse BrewRecipes (sans appel IA à cette étape)
  6. À la confirmation d’enregistrement, choisir si vous souhaitez ajouter une analyse IA (Claude, Gemini, ChatGPT) ou aucune IA
  7. Valider l’enregistrement
Analyse à l’import
  • L’analyse BrewRecipes (rule-based) est calculée automatiquement lors de l’enregistrement si les données de la recette sont suffisantes.
  • L’analyse IA est optionnelle : vous choisissez explicitement le fournisseur ou « aucune IA ». Aucune IA n’est imposée par défaut.
  • Si l’analyse IA est demandée, un indicateur de chargement s’affiche pendant l’appel — l’enregistrement de la recette n’est pas bloqué.
  • Les notes d’import peuvent mentionner l’analyse IA demandée et la durée de l’appel.
Compatibilité et outils
  • voir le chapitre Qu’est-ce que le fichier BeerXML et qui l’utilise ? pour la présentation du format et la liste des logiciels, services en ligne et portails pour automates
  • logiciels et services de cette liste testés ou validés en export BeerXML vers BrewRecipes
  • exports partiels ou incomplets : réparation automatique à l’import (journal dans les notes — voir Réparation BeerXML)
  • fichiers très anciens avec balises `<HOUBLONS>` / `<HOUBLON>` au lieu de `HOPS` : reconnus à l’import (v1.9)
  • adjuvants d’eau sans balise `<USE>` : interprétés en empâtage (Mash) ou rinçage (Sparge) selon la recette — si un rinçage est inféré alors qu’un adjuvant d’empâtage existe déjà, un avis de correction automatique en rouge s’affiche à la prévisualisation (cas fréquent avec certains exports BeerSmith)
  • la majorité des outils supportant le format BeerXML.
Logiciels anciens ou peu fiables
  • BrewMate, Promash, QBrew (logiciels en fin de vie)
Fichier contenant plusieurs recettes
  • BrewRecipes® traite les recettes une par une : vous pouvez en enregistrer plusieurs à la suite ou ignorer celles qui ne vous intéressent pas.

Réparation BeerXML (import et export)

BrewRecipes répare les fichiers BeerXML des recettes — quelle que soit leur source — pour les rendre aussi complets et cohérents que possible au regard du standard BeerXML, afin qu’ils soient réutilisables dans vos solutions d’aide au brassage (logiciels, services en ligne, automates de brassage, etc.). Voir le chapitre Qu’est-ce que le fichier BeerXML et qui l’utilise ? pour la liste des outils avec liens.

Informations manquantes (import et fiche auteur)
  • BrewRecipes signale les lacunes sans bloquer l’enregistrement : empâtage (mash), planning de fermentation, statistiques (OG, FG, IBU…), ingrédients nommés, profil d’eau (informatif), etc.
  • la même liste apparaît en prévisualisation à l’import et sur la fiche auteur lorsque des données manquent pour un export logiciel confortable.
À l’import
  • lorsque le fichier est incomplet ou partiel, BrewRecipes applique des réparations structurelles (empâtage, fermentation, statistiques, normalisation des unités, etc.)
  • les adjuvants d’eau à `<USE>` vide peuvent être normalisés en Mash ou Sparge (même règle que l’affichage fiche et le calendrier) — mention dans le journal de réparation
  • un journal des changements peut apparaître dans les notes d’import
  • la recette est enregistrée en bibliothèque : vous pouvez la consulter, la commenter et la partager sur le forum même si certaines données restent absentes pour un export ultérieur.
Sur la fiche (auteur) — « Réparer la recette et exporter »
  • si des informations manquantes sont détectées, la fiche affiche la liste et le bouton Réparer la recette et exporter
  • l’assistant propose trois modes (un seul à la fois) :
    • Réparation seule — compléter les trous du fichier (mash, fermentation, unités, IBU/stats…) sans texte d’analyse
    • + BrewRecipes — idem + synthèse et recommandations dans le bloc NOTES du XML (`--- BrewRecipes ---`, journal des complétions)
    • + IA enregistrée — idem + introduction du fournisseur dans les NOTES — l’analyse IA complète reste visible en prévisualisation, sans copie intégrale dans le XML.
  • vous prévisualisez le BeerXML réparé (comme à l’import), puis téléchargez un fichier `…-by-BrewRecipes.xml`
  • la recette en base et le fichier d’origine sur le serveur restent inchangés tant que vous n’avez pas réimporté le fichier réparé via Remplacer le BeerXML.
Deux fichiers BeerXML distincts
  • Télécharger le BeerXML sur la fiche = export original stocké dans `beerxmls/` (non remplacé par l’assistant de réparation)
  • le fichier `…-by-BrewRecipes.xml` = version enrichie produite par l’assistant — c’est celui à réimporter pour mettre à jour la recette en bibliothèque.
Dry hop (durée de contact) (v1.7)
  • dans la timeline et le XML réparé, la durée de dry hop est normalisée en jours (minimum 1 jour), y compris si le fichier source utilisait des minutes BeerXML.

Mojibake — caractères mal encodés

Le mojibake (terme informatique, du japonais ; parfois appelé « brouillage de caractères ») désigne des lettres ou symboles incohérents quand un texte a été enregistré dans un alphabet moderne (souvent l’UTF-8, qui gère les accents) mais relu comme s’il était dans un autre. Exemple fréquent dans un BeerXML : **é** affiché **`é`**, ou **°** remplacé par **`°C`**. Voir aussi Mojibake sur Wikipédia.

BrewRecipes ne change pas votre fichier d’origine sur le serveur sans action de ta part. À l’import, lors d’un export réparé ou d’une resynchronisation admin, l’application repère ces suites de caractères suspectes dans le XML et réécrit les textes en forme lisible : elle teste comment le texte a pu être mal lu, garde la variante la plus plausible (accents, degrés, apostrophes…), puis enregistre le tout en UTF-8 correct. Tu n’as rien à régler dans un menu : si des `é` restent visibles après import, réimporte depuis le fichier `.xml` d’origine ou demande un resync admin à partir du BeerXML source (pas depuis une base déjà « doublement » abîmée).

Quand la correction s’applique
  • à l’import d’un fichier BeerXML vers BrewRecipes
  • lors d’un export réparé (`…-by-BrewRecipes.xml`)
  • lors d’une resynchronisation admin à partir du fichier XML stocké sur le serveur (si des textes en base étaient encore incorrects).
Le fichier réparé est une version enrichie par BrewRecipes, pas l’export officiel de l’outil d’origine du brasseur. Les champs complétés ou synthétisés sont documentés dans les notes du fichier téléchargé.

Prévisualisation et remplacement

Avant la première publication, la prévisualisation affiche notamment :
  • le nom de la recette
  • le style BJCP proposé ou à choisir
  • les fermentescibles, houblons, levures et ingrédients divers
  • les paramètres de brassage (volumes, OG, IBU, etc.)
  • les notes éventuellement présentes dans le BeerXML
  • un aperçu de l’analyse BrewRecipes (badge « Aperçu ») — sans appel IA tant que vous n’avez pas confirmé l’enregistrement.
Remplacer le BeerXML d’une recette déjà publiée (auteur uniquement) :
  • depuis la fiche : action Remplacer le BeerXML
  • les données techniques (ingrédients, brassage, volumes, IBU, ABV, etc.) sont rechargées depuis le nouveau fichier
  • le nom affiché est repris du BeerXML (modifiable ensuite via Modifier la recette)
  • le style BJCP peut être confirmé ou changé à l’import
  • l’analyse BrewRecipes est recalculée à partir du nouveau fichier
  • vous pouvez à nouveau choisir une analyse IA à l’enregistrement, ou conserver / supprimer l’analyse IA existante selon les options proposées
  • les notes de brassage, notes de dégustation, la photo et les commentaires / notes des autres membres sont conservés.

Analyse BrewRecipes

Depuis la version 1.5, chaque fiche recette peut afficher un bloc « L’analyse de BrewRecipes ».

Contenu
  • une phrase de synthèse visible directement sur la fiche
  • un lien « Voir le détail de l’analyse » pour déplier le détail : cohérence, qualités, suggestions
  • l’analyse est calculée côté serveur à partir des statistiques de la recette, du style BJCP et des ingrédients — ce n’est pas un texte générique.
Quand l’analyse est disponible
  • à l’import ou au remplacement BeerXML (recalcul automatique)
  • au premier affichage d’une recette plus ancienne qui n’avait pas encore d’analyse enregistrée.
Quand l’analyse n’est pas proposée
  • si des données cruciales manquent : au minimum des statistiques utilisables (OG, FG ou IBU) et au moins un ingrédient identifié (fermentescible, houblon ou levure)
  • un message « Analyse indisponible » explique la raison (données insuffisantes).
Important
  • L’analyse BrewRecipes est indépendante de l’analyse IA : les deux blocs peuvent coexister sur la même fiche.
  • L’analyse BrewRecipes ne remplace pas votre jugement ni une fiche de dégustation BJCP officielle.

Analyse IA (Claude, Gemini, ChatGPT)

En complément de l’analyse BrewRecipes, vous pouvez demander une analyse IA lors de l’import ou depuis Modifier la recette (auteur).

Fournisseurs disponibles
  • Claude (Anthropic)
  • Gemini (Google)
  • ChatGPT (OpenAI)
  • ou aucune IA — choix explicite, jamais imposé.
Affichage sur la fiche
  • bloc « L’analyse de {nom de l’IA} » sous l’analyse BrewRecipes
  • icône IA et lien vers la page Wikipédia du fournisseur
  • même principe que l’analyse BrewRecipes : synthèse + détail au clic (cohérence, qualités, suggestions).
À l’import BeerXML
  • l’aperçu montre l’analyse BrewRecipes sans appeler l’IA
  • le choix du fournisseur IA se fait uniquement à la confirmation d’enregistrement
  • le bloc de choix IA est mis en évidence (fond bleu) — un spinner indique l’appel en cours.
Modification de recette (auteur)
  • section Analyse IA dans le formulaire d’édition
  • relancer une analyse avec un autre fournisseur
  • conserver l’analyse IA actuelle
  • supprimer l’analyse IA de la recette
  • indicateur « Analyse en cours… » pendant l’appel.
Limites et garde-fous
  • mêmes conditions de données que l’analyse BrewRecipes : pas d’appel IA si la recette est trop incomplète
  • l’IA ne remplace pas l’analyse BrewRecipes : les deux analyses sont stockées séparément
  • pas d’analyse IA « au clic » sur la fiche pour les visiteurs : enrichissement à l’import ou à l’édition uniquement
  • disclaimer affiché : avis indicatif, pas un jugement BJCP officiel ni un conseil de brassage garanti
  • les clés API restent côté serveur (extension AI Labs du forum) : vous ne saisissez jamais de clé dans BrewRecipes.
En cas d’échec
  • l’enregistrement de la recette peut quand même aboutir — seule l’analyse IA peut manquer
  • réessayez depuis Modifier la recette ou contactez un administrateur si le problème persiste.

Timeline graphique

La timeline est une vue graphique du déroulé du brassage : phases (empâtage, filtration, ébullition, refroidissement, fermentation, conditionnement, garde), houblons, températures, légende et résumé.

Accès
  • depuis une fiche recette, bascule Fiche / Timeline en haut de page lorsque vous y avez droit
  • selon la configuration du forum : la timeline est ouverte à tous les membres connectés, ou réservée aux administrateurs du forum uniquement — sur BrassageAmateur.com elle est en principe admin-only (si vous ne voyez pas l’onglet Timeline, c’est normal pour un compte membre standard)
  • les visiteurs non connectés voient la fiche classique sans lien timeline.
Affichage
  • graphique chronologique interactif avec bandeau des phases et icônes dédiées
  • légende des couleurs et résumé textuel des étapes
  • sur smartphone : la timeline s’affiche automatiquement en paysage (voir section Version desktop et mobile)
  • sur fenêtre étroite en mode bureau (largeur inférieure à 980 px) : message indiquant que la timeline desktop n’est pas disponible — élargissez la fenêtre ou utilisez la timeline mobile en paysage sur téléphone.
Impression
  • la timeline peut être imprimée séparément en format paysage (voir section Impression)
  • la fiche recette reste en A4 portrait.
Données requises
  • sans ingrédients ni volume de brassin exploitables, la timeline affiche un message d’impossibilité
  • si le BeerXML ne contient pas d’informations de fermentation, un avertissement peut apparaître dans le résumé.
Calendrier de brassage (v1.9)

Calendrier de brassage (.ics)

La version v1.9 « j'ai rendez-vous » permet d’exporter les étapes d’une recette vers le calendrier de votre ordinateur ou smartphone (Apple Calendar, Google Agenda, Outlook, etc.) via un fichier `.ics` (format iCalendar).

Accès
  • sur ordinateur : onglet Timeline → bouton Ajouter au calendrier
  • sur mobile : fiche résumé → bouton 📅 Ajout au calendrier
  • conditions : recette complète, timeline disponible, droits utilisateur (voir ci-dessous)
  • les visiteurs non connectés n’ont pas accès au calendrier.
Parcours
  1. choisir la date de brassage (calendrier) et l’heure de début — les deux sont obligatoires avant l’aperçu
  2. consulter l’aperçu des événements, regroupés en trois blocs : Préparation (commande ingrédients, concassage, levure…), Jour de brassage (empâtage → ensemencement), Fermentation et suite (phases froides, dry hop, embouteillage, dégustation)
  3. si des données manquent dans le BeerXML, BrewRecipes applique des durées par défaut (empâtage, refroidissement, garde…) et affiche une alerte rouge listant les extrapolations — vérifiez l’aperçu avant d’exporter
  4. télécharger le fichier .ics en bas de page et l’ouvrir : votre application agenda propose d’importer tous les événements d’un coup
  5. chaque événement peut inclure une description avec lien vers la fiche recette sur BrassageAmateur.com.
Préparation — rappels commande
  • si la date de brassage est à plus de 15 jours : événement J−15 « Commander les ingrédients »
  • si elle est à plus de 8 jours : événement J−8 « Dernière limite pour commander des ingrédients manquants »
  • la veille du brassage : vérification des ingrédients, puis concassage / chauffage de l’eau et préparation de la levure selon la recette.
Divers et adjuvants d’eau
  • les ingrédients divers (épices, clarifiants, etc.) sont intégrés aux événements de la phase concernée (chauffage / empâtage, ébullition, fermentation, embouteillage…) — pas d’événements « divers » isolés dans le calendrier
  • les adjuvants d’eau sans balise `<USE>` explicite sont placés au rinçage lorsqu’un adjuvant d’empâtage est déjà présent dans la recette, sinon à l’empâtage — même règle que sur la fiche et à l’import BeerXML.
Droits et confidentialité
  • par défaut sur BrassageAmateur.com : export réservé à l’auteur de la recette et aux administrateurs du forum (réglage ACP BrewRecipes → Calendrier de brassage → Privé)
  • si l’administrateur décoche Privé, tout membre autorisé à voir la timeline peut générer le calendrier pour les recettes exploitables
  • l’export ne crée pas d’abonnement en ligne (`webcal://`) : c’est un fichier à télécharger et importer manuellement.
Compatibilité agendas
  • chaque titre d’événement dans le fichier `.ics` est préfixé par 🍺 et rappelle le nom de la recette (ex. `🍺 Commander les ingrédients — Ma bière`, `🍺 Empâtage — Ma bière`) pour repérer facilement les entrées BrewRecipes dans votre agenda ; l’aperçu à l’écran garde les icônes SVG sans modifier le texte
  • testez l’import sur votre appareil : le rendu des rappels et fuseaux horaires dépend de votre logiciel agenda.
Hors scope v1.9
  • pas d’export `.ics` direct depuis le résumé mobile sans ouvrir la page calendrier
  • pas de synchronisation automatique si vous modifiez la recette après import
  • pas de notifications phpBB liées aux rappels du calendrier personnel.

Fiche recette (auteur)

Chaque recette publiée propose une fiche détaillée : photo (ou verre coloré selon l’EBC), statistiques, ingrédients, profil de brassage, fermentation, téléchargement du fichier BeerXML d’origine, moyenne des notes.

Ingrédients — divers (v1.9)
  • les adjuvants d’eau (acides, sels…) s’affichent en g ou ml selon le fichier source
  • le type est traduit en français lorsque possible ; une indication d’usage utile peut apparaître sous le nom (ex. « pour abaisser le pH ») sans répéter le libellé du type
  • si la balise `<USE>` est absente pour un adjuvant d’eau : affichage en empâtage par défaut, ou en rinçage lorsqu’un autre adjuvant d’eau est déjà en empâtage dans la recette — aligné avec le calendrier et l’import.
Téléchargement BeerXML (v1.9)
  • sous le bouton Télécharger, un compteur « Téléchargé N fois » indique combien de fois le fichier a été téléchargé depuis la fiche — masqué tant que le compteur est à zéro.
Analyses
  • bloc « L’analyse de BrewRecipes » si les données le permettent (voir section Analyse BrewRecipes)
  • bloc « L’analyse de {IA} » si une analyse IA a été enregistrée (voir section Analyse IA).
Pour tous les visiteurs
  • Imprimer : bouton avec icône bleue, sur la même ligne que les dates (voir section Impression).
Si vous êtes l’auteur de la recette
  • Modifier la recette : nom affiché, notes de brassage, notes de dégustation, options Analyse IA (relancer, conserver ou supprimer)
  • Photo : envoi d’une image JPG ou PNG (taille limitée) — case supprimer la photo sous l’image ou dans le formulaire d’édition
  • Étiquette IA et QR code : voir section Étiquette IA et QR code
  • BBCode : code prêt à copier pour l’insérer dans un message du forum (voir section BBCode)
  • Remplacer le BeerXML ou supprimer la recette (suppression douce : masquée du site, conservée en base)
  • Réparer la recette et exporter : voir section Réparation BeerXML (lacunes détectées).
Pour tous les visiteurs
  • les citations forum en BBCode

    Code : Tout sélectionner

    [recette="id"]…[/recette]
    déclenchent toujours une notification pour l’auteur de la recette — l’affichage « citée N fois sur le forum » sur la fiche est reporté (recherche phpBB non fiable).
Pour tous les membres connectés
  • Partager : menu à côté du titre de la recette (voir section Menu Partager)
  • Favoris : symbole ♡ / ❤️ sur la fiche.
Navigation
  • Voir mes recettes : retour à la liste filtrée sur vos fiches
  • pour les autres visiteurs : Retour à la liste de toutes les recettes
  • bascule Fiche / Timeline pour les membres connectés (voir section Timeline).

Impression

Sur la fiche recette, le bouton Imprimer (icône bleue, même ligne que les dates de publication, mise à jour et brassage) ouvre l’impression du navigateur (Ctrl+P / Cmd+P).

Fiche recette — contenu imprimé
  • titre et style de la recette
  • synthèse : verre (ou photo) et statistiques principales
  • tableaux des ingrédients (fermentescibles, houblons, levures, divers)
  • notes de brassage et notes de dégustation.
Fiche recette — mise en page
  • format A4 portrait, mise en page épurée
  • pas de menu du forum, pas de boutons d’action
  • pas de téléchargement BeerXML ni de champ BBCode
  • pas de formulaire de commentaire
  • les blocs d’analyse peuvent être masqués à l’impression selon la feuille de styles dédiée.
Timeline
  • depuis la vue timeline, impression en format paysage
  • graphique, légende et résumé adaptés à l’impression.
Pied de page
  • chaque page imprimée affiche en bas : BrassageAmateur.com - BrewRecipes® v1.9 - 2026 (version et année selon la release en cours).

Menu Partager (MP, sujet, e-mail, WhatsApp, URL)

Depuis la version 1.6 (*sharing is caring*), chaque fiche recette (hors mode édition) propose un bouton Partager à côté du titre, pour les membres connectés.

Canaux disponibles
  • Message privé : ouvre la composition d’un MP phpBB avec un texte d’introduction et la mini-fiche BBCode de la recette
  • Nouveau sujet sur le forum : ouvre la composition d’un sujet avec le même contenu prérempli
  • E-mail : ouvre votre logiciel de messagerie (sujet et corps préremplis)
  • WhatsApp : ouvre WhatsApp Web ou l’application avec un message prérempli
  • Copier l’URL : copie le lien public de la fiche dans le presse-papiers (confirmation à l’écran).
Comportement
  • Le partage ne publie pas la recette à votre place : vous validez ensuite l’envoi du MP, du sujet ou de l’e-mail
  • l’auteur de la recette peut recevoir une notification dans la cloche du forum lorsque vous choisissez un canal (voir section Notifications) — ce n’est pas un MP automatique envoyé par BrewRecipes
  • pour citer une recette dans un message déjà rédigé, utilisez le BBCode (section suivante) ou le bouton de l’éditeur forum.

BBCode recette dans le forum

Un BBCode personnalisé est déclaré dans l’ACP phpBB (Messages → BBCode) :

Code : Tout sélectionner

[recette="{NUMBER}"]{TEXT}[/recette]
  • {NUMBER} = identifiant numérique de la recette dans BrewRecipes (affichage direct, sans recherche par nom)
  • {TEXT} = libellé visible (en pratique, le nom de la recette).
Deux façons d’insérer une recette dans un message
  1. Bouton de l’éditeur de message (icône recette BrewRecipes) :
    • saisir un mot-clé dans la fenêtre proposée
    • la recherche est automatique (AJAX)
    • 0 résultat : message d’erreur
    • 1 résultat : le BBCode est inséré automatiquement
    • plusieurs résultats : liste numérotée — saisir le numéro choisi pour insérer le BBCode.
  2. Copie depuis la fiche recette : champ BBCode du type

    Code : Tout sélectionner

    [recette="123"]Nom de la recette[/recette]
Rendu dans le message
  • À la lecture du sujet, la balise est remplacée par une mini-fiche : visuel, style, ABV / IBU / EBC / volume, ingrédients principaux, lien vers la fiche complète.
  • L’ABV affiché privilégie la valeur mesurée (abv) lorsqu’elle est renseignée, sinon la valeur estimée (est_abv).
Ancien format (messages historiques)

  • Code : Tout sélectionner

    [recette]Nom de la recette[/recette]
    = recherche par nom en base (insensible à la casse)
  • 1 seule recette avec ce nom exact → mini-fiche
  • plusieurs homonymes, nom proche sans correspondance exacte, ou aucun résultat → lien vers la bibliothèque BrewRecipes avec recherche préremplie (au lieu d’une mini-fiche ambiguë)
  • Préférez toujours le format avec ID pour un lien fiable dans les nouveaux messages.
Citation et notifications
  • Lorsqu’un membre insère votre recette avec

    Code : Tout sélectionner

    [recette="id"]…[/recette]
    dans un post ou un MP, vous pouvez être averti via la cloche (type « citation »), si vous avez activé cette notification.

Notifications BrewRecipes (cloche phpBB)

BrewRecipes s’appuie sur les notifications du forum (icône cloche en haut de page), groupe BrewRecipes dans vos préférences utilisateur.

Types d’alertes (pour l’auteur de la recette)
  • Commentaire ou note : un membre laisse un premier avis sur votre recette (pas de nouvelle alerte si ce membre modifie ensuite sa note ou son texte)
  • Favori : quelqu’un ajoute votre recette à ses favoris (pas de notification lorsqu’il la retire)
  • Citation : votre recette est citée en BBCode dans un message du forum ou en MP
  • Partage : quelqu’un ouvre le menu Partager et choisit un canal (MP, sujet, e-mail, WhatsApp ou copie d’URL) — l’alerte correspond au clic, pas à l’envoi effectif du MP ou du sujet.
Affichage
  • chaque notification affiche le pseudo (lien vers le profil du membre), le nom de la recette (lien vers la fiche) et, pour une citation, un lien vers le post ou le MP
  • pour un commentaire, le nom de la recette mène à la zone Commentaires de la fiche
  • les libellés sont en français ou en anglais selon la langue du forum.
Ce qui n’est pas prévu
  • pas de message privé automatique à l’auteur à chaque commentaire : seule la cloche est utilisée
  • pas d’e-mail BrewRecipes dédié en plus des réglages phpBB habituels.
Réglages (UCP phpBB)

Chaque membre choisit ce qu’il reçoit dans la cloche. BrewRecipes n’ajoute pas d’e-mail dédié : seules les notifications board du forum (cloche) sont proposées.

Où les régler
  1. Cliquez sur votre identifiant en haut du forum → Panneau de contrôle utilisateur (UCP).
  2. Préférences du forum → Modifier les paramètres de notification (libellés pouvant varier selon la langue du forum).
  3. Repérez le groupe BrewRecipes : quatre cases à cocher, une par type d’alerte.
  4. Cochez ou décochez, puis Enregistrer. Les changements s’appliquent aux prochains événements (pas aux notifications déjà reçues).
Les quatre types (libellés UCP)
  • Quelqu’un commente ou note une de mes recettes — commentaire ou première note sur votre fiche
  • Quelqu’un ajoute une de mes recettes à ses favoris — ajout aux favoris (pas de alerte si le favori est retiré)
  • Quelqu’un cite une de mes recettes sur le forum ou en MP — BBCode

    Code : Tout sélectionner

    [recette="id"]…[/recette]
    dans un post ou un MP
  • Quelqu’un partage une de mes recettes (MP, sujet, e-mail, WhatsApp ou copie d’URL) — ouverture du menu Partager et choix d’un canal (l’alerte suit le clic, pas l’envoi effectif du MP ou du sujet).
Rappels
  • seul l’auteur de la recette peut recevoir ces alertes (pas les autres visiteurs de la fiche)
  • désactiver un type dans l’UCP suffit : aucune alerte de ce type ne sera créée tant que la case reste décochée
  • si vous voyez des noms de variables du type

    Code : Tout sélectionner

    BREWRECIPES_NOTIFICATION_…
    au lieu des libellés : videz le cache forum (ACP → Maintenance) et rechargez la page — corrigé en extension 1.6+.

Étiquette IA et QR code

Réservé à l’auteur de la recette (membre connecté, fiche non supprimée).

Étiquette IA (*label craft*)
  • bouton Étiquette IA sur la fiche : BrewRecipes génère un prompt texte (en français par défaut, ou en anglais si l’interface BrewRecipes est en EN), prêt à coller dans votre compte ChatGPT (ou autre IA de votre choix, hors lien direct dans l’extension)
  • le prompt décrit une étiquette craft imprimable (nom, style, couleurs, ambiance visuelle, ingrédients principaux, etc.) à partir des données de la recette
  • aucune image n’est créée ni stockée par BrewRecipes : vous réalisez le visuel dans l’outil IA que vous utilisez
  • à l’ouverture : copie du prompt dans le presse-papiers et possibilité d’ouvrir chatgpt.com dans un nouvel onglet.
QR code
  • Voir le QR code : modale avec l’image pointant vers l’URL publique de la fiche
  • Télécharger le QR code : fichier PNG à coller sur une étiquette ou un support papier
  • connexion requise — si le serveur ne dispose pas de l’extension PHP GD (ou de la bibliothèque QR à la racine du forum), les boutons Voir le QR code / Télécharger ne sont pas affichés sur la fiche.
ACP (administrateurs)
  • réglages par fournisseur (ChatGPT, Claude, Gemini…) pour l’étiquette et les rappels affichés aux brasseurs.

Multilingue (français / anglais)

Depuis la version 1.6 (*sharing is caring*), l’interface BrewRecipes (menus, boutons, messages de l’application) peut s’afficher en français ou en anglais. Le pack en_us (libellés communs) est maintenu sur la branche v1.7.

Comment changer de langue
  • sur la bibliothèque, l’aide / FAQ, les fiches recette et la timeline : boutons FR et EN (en haut de page, à côté des autres actions)
  • le choix est mémorisé environ 7 jours (cookie navigateur) pour vos prochaines visites sur BrewRecipes.
Ce qui ne change pas
  • le texte des recettes (nom, notes de brassage, commentaires des membres) reste tel que saisi par les auteurs
  • les notifications de la cloche suivent en général la langue de votre compte forum
  • le prompt d’étiquette IA suit la langue de l’interface BrewRecipes (français ou anglais — voir section Étiquette IA)
  • une analyse IA déjà enregistrée dans une autre langue peut être régénérée depuis Modifier la recette (voir Analyse IA).

Référentiel de styles et Wiki

Les styles disponibles à l’import et sur les fiches proviennent de la table

Code : Tout sélectionner

brewxml_styles
. BrewRecipes® intègre notamment les guides suivants :
  • ABC 2010
  • BA 2011
  • BJCP 1999 à 2021
  • FADØL 2007
Lors de l’import, le style peut être proposé automatiquement à partir des informations BeerXML (numéro, lettre, guide). Les listes de guides à l’import sont triées avec le plus récent d’abord (ex. BJCP 2021 avant 2015 — v1.7).

Le nom du style sur la fiche (et dans la mini-fiche forum) peut ouvrir une recherche sur le wiki BrassageAmateur :
  • description du style
  • paramètres du guide concerné (BJCP, ABC, BA, FADØL, etc.)
  • exemples et recommandations.

Commentaires et notes

Les membres connectés peuvent :
  • laisser un commentaire
  • attribuer une note de 0 à 5 étoiles.
Règles
  • une seule évaluation (note + commentaire) par membre et par recette
  • l’auteur de la recette ne peut pas noter sa propre fiche
  • la note moyenne et le nombre d’avis sont visibles sur la fiche recette, la mini-fiche et dans la liste des recettes (colonne Notes).
Avertir l’auteur
  • lorsqu’un autre membre commente ou note pour la première fois, l’auteur peut recevoir une notification dans la cloche du forum (pas de MP automatique)
  • voir la section Notifications BrewRecipes.
Commentaires, suggestions, questions et bugs

Pour tout retour sur BrewRecipes® (idées, questions d’utilisation, signalement de bug), utilisez le sujet dédié du forum :
BrewRecipes® — commentaires, suggestions et bugs
© 2026 Jean-Luc B. — BrewRecipes® est une marque déposée.

BrewRecipes® v1.9 — j'ai rendez-vous
init · multi · timeline · one step beyond · sharing is caring · cherchez le mobile… · j'ai rendez-vous · french connection
© 2026 Jean-Luc B.