Dry é um superconjunto da linguagem de modelagem Liquid, com suporte de primeira classe para recursos avançados de herança e muito mais.
Considere seguir o autor deste projeto, Jon Schlinkert, e estrelar o projeto para mostrar seu ❤️ e apoio.
Instale com npm (requer Node.js >=14):
$ npm install --save dry
A maneira mais simples de começar é com o método render
, que usa uma string de modelo e um objeto de dados (o "contexto").
const { render } = require ( 'dry' ) ; // render is async
console . log ( await render ( 'Hello, {{ name }}!' , { name : 'Brian' } ) ) ; //=> Hello, Brian!
Usando o código acima, você pode fazer quase tudo o que precisa com o Dry.
Tags, filtros, variáveis e muito mais!
Consulte a documentação do Liquid do Shopify para aprender sobre todos os recursos da linguagem de modelagem Liquid. Se você pode fazer isso com Liquid, você deve conseguir fazer isso com Dry. (e se você não consegue fazer isso com o Dry, é um bug, e pedimos que você crie um problema, obrigado!)
Os documentos estão a caminho. Enquanto isso, você pode usar a documentação do Liquid para aprender sobre todos os recursos da linguagem e usar o trecho de código acima para renderizar seus modelos!
? Este lançamento demorou um pouco. Aqui estão alguns destaques!
As primeiras coisas primeiro
Voltei! Eu sei que não tenho estado muito presente ultimamente, mas tudo isso está prestes a mudar! Obrigado a @doowb todos os meus patrocinadores e amigos no GitHub que me deram o incentivo e o apoio que eu precisava para começar esse retorno.
Considere seguir a mim e a este repositório para receber atualizações e considere contribuir com o Dry para que possamos tornar esta a biblioteca de modelos mais poderosa em Node.js!
Por que secar? React e Vue não são o futuro?
Sim, sim, eles são. Dry não compete com eles. Usamos Dry da mesma forma que Shopify e Jekyll usam Liquid, muitos usuários finais não sabem escrever JavaScript e muitos desenvolvedores preferem não escrever JavaScript - adoro escrever JavaScript e gosto de Vue e React, mas há algo satisfatório em implantar um site em 5 minutos usando modelos HTML de texto simples. Também usamos o Dry para projetar e renderizar modelos de e-mail, mensagens de sistema baseadas em configuração e assim por diante.
O que há de diferente no Dry?
Dry é um superconjunto do Liquid do Shopify com suporte de primeira classe para herança de modelos (ahem... então você não precisa se repetir. Então está "seco". Eu sei... é tudo que tenho no momento).
Destaques deste PR
{% from 'fields' import input as input_field, textarea %}
Muito mais!
As tags com início +
foram adicionadas ao Dry:
(Adicionaremos mais tags em breve! section
Curtir e outras tags usadas pelo 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
Solicitações pull e estrelas são sempre bem-vindas. Para bugs e solicitações de recursos, crie um problema.
Leia o guia de contribuição para obter conselhos sobre problemas de abertura, solicitações pull e padrões de codificação.
Executar e revisar testes unitários é uma ótima maneira de se familiarizar com uma biblioteca e sua API. Você pode instalar dependências e executar testes com o seguinte comando:
$ npm install && npm test
(O readme.md deste projeto é gerado por verbo, por favor, não edite o readme diretamente. Quaisquer alterações no readme devem ser feitas no modelo readme .verb.md.)
Para gerar o leia-me, execute o seguinte comando:
$ npm install -g verbose/verb#dev verb-generate-readme && verb
Jon Schlinkert
Copyright © 2021, Jon Schlinkert. Lançado sob a licença MIT.
Este arquivo foi gerado por verbo-generate-readme, v0.8.0, em 20 de julho de 2021.