C'est certainement l'outil le plus inutile dans notre monde "moderne", mais pour les vieux cons comme moi qui :
- jurent encore par le BeerXML
- en ont une petite collection sur leur disque dur
- aiment avoir tout en local (parce que "si ce n'est pas chez toi ce n'est pas à toi")
- et que ça emm*rde de lancer un gros soft juste pour voir de quoi ça cause
- voire qui utilisent désormais une feuille LibreOffice/Excel par souci d'indépendance
A la base c'était pour fournir un substitut à la perte de l'outil "Vos recettes" du forum. Ca s'installe sur un serveur. En local (WAMP / LAMP / FrankenPHP/etc) ça fonctionne bien. Sur du distant, je ne sais pas du tout si ça marche (voir chapitre "important" en fin)
Tout ce dont vous avez besoin, c'est PHP (et 7-zip pour décompresser) et un vrai navigateur respectueux des standards (Firefox's fanboy forever)
Comment ça s'installe?
- dans le zip, il y a 3 fichiers (index.html, showrecipe.php et bxml.xsl)
- posez ces 3 fichiers dans un répertoire de votre serveur (sous WAMP en local, c'est dans WWW/nom_du_répertoire)
- voilà, c'est tout (oui oui ! pas de déploiement, pas de machin docker/kubernetes/node.js/etc.. ← que des mots que je ne sais pas ce que ça veut dire mais ça sonne bien
comment ça s'utilise ?
Faites pointer votre navigateur vers le fichier index.html (sur une install locale*, tapez dans la barre d'adresse "http://localhost/nom_du_répertoire/index.html)
Ensuite soit utiliser le bouton "Parcourir", soit faire un glisser-déposer du fichier xml sur ledit bouton, et cliquer sur "Afficher"
... bah quoi, vous vous attendiez à des trucs plus compliqués ?
IMPORTANT :
- de base il y a la création, dans le répertoire d'installation, d'un fichier html portant le nom de la recette (préfixé d'un underscore. Un underscore c'est ça : _ ["tiret du 8" vous diront vos grands-parents
]). Modifiez le php pour l'adapter à vos besoins et faire pointer le résultat sur un répertoire accessible en écriture - c'est livré tel-quel. Comme on dit : "ça marche chez moi"... (WAMP PhP 7.4 + Firefox). Je ne suis pas programmeur, j'ai juste un certain talent pour trier les réponses d'un moteur de recherche. Si ça marche pas chez vous... cherchez et réparez
(pour php 8, des adaptations sont à prévoir) - le fichier HTML généré est dispo ensuite sans avoir besoin de refaire la conversion à partir du XML. Avec une petite CSS, vous devriez réussir à produire un truc plus sexy sans trop de difficulté
- pour ceusses qui comme moi n'y connaissent rien : le format XSL n'a rien à voir avec un logiciel d'une firme dont le nom commence par Mi et se termine par Crosoft
- et si, en l'installant sur un serveur distant, vous vous demandez si c'est sécurisé : je n'en sais rien. Je suis thermicien/plombier/électricien, pas programmeur ni spécialiste réseau
- pour ceusses qui voudraient mettre les mains dans la machinerie : j'ai l'habitude de pas mal commenter les codes que je bidouille (Lazarus surtout) même s'ils sont à mon usage exclusif et y compris en indiquant les sources où j'ai puisé le savoir pour réussir à écrire ça. Donc pour toute modif, vous devriez vous en sortir.
- En tout état de cause, je n'assure AUCUN SAV (← version diplomatique d'un "dém*rdez-vous"
)
*note : il va de soi qu'en local, il faut démarrer le serveur avant ... Vous l'aviez déjà compris tout seul !
Enjoy !
.
Edit : screenshots →
