Dry — это расширенная версия языка шаблонов Liquid с первоклассной поддержкой расширенных функций наследования и многого другого.
Пожалуйста, рассмотрите возможность подписаться на автора этого проекта, Джона Шлинкерта, и рассмотрите возможность стать звездой проекта, чтобы выразить свои ❤️ и поддержку.
Установите с помощью npm (требуется Node.js >=14):
$ npm install --save dry
Самый простой способ начать — использовать метод render
, который принимает строку шаблона и объект данных («контекст»).
const { render } = require ( 'dry' ) ; // render is async
console . log ( await render ( 'Hello, {{ name }}!' , { name : 'Brian' } ) ) ; //=> Hello, Brian!
Используя приведенный выше код, вы можете делать с Dry почти все, что вам нужно.
Теги, фильтры, переменные и многое другое!
См. документацию Shopify’s Liquid, чтобы узнать обо всех функциях языка шаблонов Liquid. Если вы можете сделать это с Liquid, вы сможете сделать это и с Dry. (а если вы не можете сделать это с помощью Dry, это ошибка, и мы просим вас создать проблему, спасибо!)
Документы уже в пути. А пока вы можете использовать эту документацию Liquid, чтобы узнать обо всех функциях языка, и использовать приведенный выше фрагмент кода для визуализации ваших шаблонов!
? Этот выпуск занял некоторое время. Вот некоторые основные моменты!
Перво-наперво
Я вернулся! Я знаю, что в последнее время меня не было рядом, но скоро все изменится! Спасибо @doowb всем моим спонсорам и друзьям на GitHub, которые оказали мне поддержку и поддержку, необходимые для того, чтобы начать это возвращение.
Пожалуйста, рассмотрите возможность подписки на меня и этот репозиторий, чтобы получать обновления, а также рассмотрите возможность внести свой вклад в Dry, чтобы мы могли сделать эту самую мощную библиотеку шаблонов в Node.js!
Почему Сухой? Разве за React и Vue не будущее?
Да, да, они есть. Сухие с ними не конкурируют. Мы используем Dry так же, как Shopify и Jekyll используют Liquid, многие конечные пользователи не знают, как писать JavaScript, и многие разработчики предпочитают не писать JavaScript — я люблю писать JavaScript, мне нравятся Vue и React, но есть что-то приятное в развертывании сайта за 5 минут с использованием текстовых HTML-шаблонов. Мы также используем Dry для разработки и отображения шаблонов электронной почты, системных сообщений на основе конфигурации и т. д.
Чем отличается Dry?
Dry — это расширенный набор Shopify Liquid с первоклассной поддержкой наследования шаблонов (хм… так что вам не придется повторяться. Так что это «сухой». Я знаю… это все, что у меня есть на данный момент).
Основные моменты этого PR
{% from 'fields' import input as input_field, textarea %}
И многое другое!
В Dry добавлены теги с начальным +
:
(Скоро мы добавим больше тегов! section
«Нравится» и другие теги, используемые 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
Запросы на вытягивание и звезды всегда приветствуются. Для ошибок и запросов функций, пожалуйста, создайте проблему.
Пожалуйста, прочитайте руководство для участников, чтобы получить советы по открытию проблем, запросам на включение и стандартам кодирования.
Запуск и просмотр модульных тестов — отличный способ ознакомиться с библиотекой и ее API. Вы можете установить зависимости и запустить тесты с помощью следующей команды:
$ npm install && npm test
(Файл readme.md этого проекта создан командой verb. Не редактируйте файл readme напрямую. Любые изменения в файле readme необходимо вносить в шаблон файла readme .verb.md.)
Чтобы создать файл readme, выполните следующую команду:
$ npm install -g verbose/verb#dev verb-generate-readme && verb
Джон Шлинкерт
© 2021, Джон Шлинкерт. Выпущено по лицензии MIT.
Этот файл был создан verb-generate-readme, v0.8.0, 20 июля 2021 г.