Dry es un superconjunto del lenguaje de plantillas Liquid, con soporte de primera clase para funciones de herencia avanzadas y más.
Considere seguir al autor de este proyecto, Jon Schlinkert, y considere protagonizar el proyecto para mostrar su ❤️ y apoyo.
Instalar con npm (requiere Node.js >=14):
$ npm install --save dry
La forma más sencilla de comenzar es con el método render
, que toma una cadena de plantilla y un objeto de datos (el "contexto").
const { render } = require ( 'dry' ) ; // render is async
console . log ( await render ( 'Hello, {{ name }}!' , { name : 'Brian' } ) ) ; //=> Hello, Brian!
Usando el código anterior, puedes hacer casi todo lo que necesitas hacer con Dry.
¡Etiquetas, filtros, variables y más!
Consulta los documentos de Shopify's Liquid para conocer todas las funciones del lenguaje de plantillas Liquid. Si puedes hacerlo con Liquid, deberías poder hacerlo con Dry. (y si no puede hacerlo con Dry, es un error, y le rogamos que cree un problema, ¡gracias!)
Los médicos están en camino. Mientras tanto, puedes usar estos documentos de Liquid para conocer todas las funciones del lenguaje y usar el fragmento de código anterior para representar tus plantillas.
? Este lanzamiento tomó un tiempo. ¡Aquí hay algunos aspectos destacados!
Lo primero es lo primero
¡Ya estoy de vuelta! Sé que no he estado mucho últimamente, ¡pero todo eso está a punto de cambiar! Gracias a @doowb, a todos mis patrocinadores y amigos en GitHub que me brindaron el aliento y el apoyo que necesitaba para comenzar a hacer este regreso.
¡Considere seguirme a mí y a este repositorio para recibir actualizaciones, y considere contribuir a Dry para que podamos hacer de esta la biblioteca de plantillas más poderosa en Node.js!
¿Por qué seco? ¿No son React y Vue el futuro?
Sí, sí lo son. Dry no compite con ellos. Usamos Dry de la misma manera que Shopify y Jekyll usan Liquid, muchos usuarios finales no saben cómo escribir JavaScript y muchos desarrolladores preferirían no escribir JavaScript. Me encanta escribir JavaScript y disfruto de Vue y React, pero hay algo satisfactorio acerca de implementar un sitio en 5 minutos usando plantillas HTML de texto sin formato. También utilizamos Dry para diseñar y representar plantillas de correo electrónico, mensajes del sistema basados en configuración, etc.
¿Qué tiene de diferente Dry?
Dry es un superconjunto de Shopify's Liquid con soporte de primera clase para herencia de plantillas (ejem... para que no tengas que repetirte. Así que es "seco". Lo sé... es todo lo que tengo en este momento).
Aspectos destacados de este PR
{% from 'fields' import input as input_field, textarea %}
¡Mucho más!
Las etiquetas con +
inicial fueron agregadas a Seco:
(¡Pronto agregaremos más etiquetas! section
Me gusta y otras etiquetas utilizadas por 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
Las solicitudes de extracción y las estrellas siempre son bienvenidas. Para errores y solicitudes de funciones, cree un problema.
Lea la guía de contribución para obtener consejos sobre problemas de apertura, solicitudes de extracción y estándares de codificación.
Ejecutar y revisar pruebas unitarias es una excelente manera de familiarizarse con una biblioteca y su API. Puede instalar dependencias y ejecutar pruebas con el siguiente comando:
$ npm install && npm test
(El archivo Léame.md de este proyecto se genera mediante un verbo; no lo edite directamente. Cualquier cambio en el archivo Léame debe realizarse en la plantilla Léame .verb.md).
Para generar el archivo Léame, ejecute el siguiente comando:
$ npm install -g verbose/verb#dev verb-generate-readme && verb
Jon Schlinkert
Copyright © 2021, Jon Schlinkert. Publicado bajo la licencia MIT.
Este archivo fue generado por verb-generate-readme, v0.8.0, el 20 de julio de 2021.