Dry est un sur-ensemble du langage de création de modèles Liquid, avec une prise en charge de première classe des fonctionnalités d'héritage avancées, et bien plus encore.
Veuillez envisager de suivre l'auteur de ce projet, Jon Schlinkert, et envisager de mettre le projet en vedette pour montrer votre ❤️ et votre soutien.
Installez avec npm (nécessite Node.js >=14) :
$ npm install --save dry
Le moyen le plus simple de commencer consiste à utiliser la méthode render
, qui prend une chaîne de modèle et un objet de données (le « contexte »).
const { render } = require ( 'dry' ) ; // render is async
console . log ( await render ( 'Hello, {{ name }}!' , { name : 'Brian' } ) ) ; //=> Hello, Brian!
En utilisant le code ci-dessus, vous pouvez faire presque tout ce que vous devez faire avec Dry.
Balises, filtres, variables et plus encore !
Consultez la documentation de Shopify's Liquid pour en savoir plus sur toutes les fonctionnalités du langage de modèles Liquid. Si vous pouvez le faire avec Liquid, vous devriez pouvoir le faire avec Dry. (et si vous ne pouvez pas le faire avec Dry, c'est un bug, et nous vous demandons de bien vouloir créer un problème, merci !)
Les documents sont en route. En attendant, vous pouvez utiliser cette documentation Liquid pour en savoir plus sur toutes les fonctionnalités du langage et utiliser l'extrait de code ci-dessus pour afficher vos modèles !
? Cette sortie a pris du temps. Voici quelques faits marquants !
Tout d'abord
Je suis de retour! Je sais que je n'ai pas été beaucoup là ces derniers temps, mais tout cela est sur le point de changer ! Merci à @doowb tous mes sponsors et amis sur GitHub qui m'ont fourni les encouragements et le soutien dont j'avais besoin pour commencer à faire ce retour.
Veuillez envisager de me suivre ainsi que ce référentiel pour recevoir des mises à jour, et envisagez de contribuer à Dry afin que nous puissions en faire la bibliothèque de modèles la plus puissante de Node.js !
Pourquoi sécher ? React et Vue ne sont-ils pas l'avenir ?
Oui, oui, ils le sont. Dry ne les concurrence pas. Nous utilisons Dry de la même manière que Shopify et Jekyll utilisent Liquid, de nombreux utilisateurs finaux ne savent pas comment écrire du JavaScript et de nombreux développeurs préféreraient ne pas écrire du JavaScript - j'adore écrire du JavaScript et j'apprécie Vue et React, mais il y a quelque chose de satisfaisant dans le déploiement d'un site en 5 minutes à l'aide de modèles HTML en texte brut. Nous utilisons également Dry pour concevoir et afficher des modèles d'e-mails, des messages système basés sur la configuration, etc.
Qu'est-ce qui est différent chez Dry ?
Dry est un surensemble de Shopify's Liquid avec un support de première classe pour l'héritage de modèles (hum... donc vous n'avez pas à vous répéter. Donc c'est "dry". Je sais... c'est tout ce que j'ai pour le moment).
Points forts de ce PR
{% from 'fields' import input as input_field, textarea %}
Bien plus encore !
Les balises commençant par +
ont été ajoutées à Dry :
(Nous ajouterons bientôt d'autres balises ! J'aime section
et d'autres balises utilisées par Shopify)
+ Apply
Assign
+ Block
Break
Capture
Case
Comment
+ Content
Continue
Cycle
Decrement
Echo
+ Embed
+ Extends
For
+ From
If
Ifchanged
+ Import
Include
Increment
+ Layout
Liquid
+ Macro
+ Paginate
Raw
Render
+ Set
+ Switch
TableRow
Unless
+ Verbatim
+ With
Les demandes de tirage et les étoiles sont toujours les bienvenues. Pour les bogues et les demandes de fonctionnalités, veuillez créer un problème.
Veuillez lire le guide de contribution pour obtenir des conseils sur l'ouverture des problèmes, les demandes d'extraction et les normes de codage.
Exécuter et réviser des tests unitaires est un excellent moyen de se familiariser avec une bibliothèque et son API. Vous pouvez installer des dépendances et exécuter des tests avec la commande suivante :
$ npm install && npm test
(Le fichier readme.md de ce projet est généré par verbe, veuillez ne pas modifier le fichier readme directement. Toute modification du fichier readme doit être effectuée dans le modèle readme .verb.md.)
Pour générer le fichier Lisez-moi, exécutez la commande suivante :
$ npm install -g verbose/verb#dev verb-generate-readme && verb
Jon Schlinkert
Copyright © 2021, Jon Schlinkert. Publié sous la licence MIT.
Ce fichier a été généré par verb-generate-readme, v0.8.0, le 20 juillet 2021.