Шаблони дієт

Вступ

Зауважте, що оригінальна реалізація шаблонів Diet була замінена пакетом DietNG, який підтримує ряд додаткових функцій. Оновлена версія специфікації знаходиться в SPEC.md сховища GitHub.

Цей документ знаходиться в стадії розробки - будь-ласка, використовуйте документацію щодо мопсів для будь-якого розділу, не заповненого вмістом. Шаблони дієт зберігаються максимально сумісними з шаблонами мопсів.

Дієтні шаблони - це HTML-шаблони, які статично компілюються до рідного коду D. Таким чином, динамічні сторінки майже не мають накладних витрат і часто навіть швидші, ніж статичні сторінки на диску, оскільки вони просто записуються безпосередньо з оперативної пам'яті в з'єднання HTTP.

Синтаксис дорівнює синтаксисуPugtemplates, за винятком деяких розширених функцій синтаксису. Оскільки офіційного посилання на синтаксис ще не написано, ви можете використовувати документацію про мопс як заміну. Головна відмінність полягає в тому, що ви пишете вирази D та твердження замість JavaScript.

Базова структура

Загальна структура використовує відступ для управління вкладанням тегів HTML, подібно до того, як робить Python. Стиль відступу документа застосовується до послідовності та може мати вкладки або будь-яку кількість пробілів. Стиль відступу виводиться з першого рядка, який має відступ. Зверніть увагу, що рівні відступу ніколи не можна пропускати, так що перший рядок із відступом завжди повинен бути з відступом рівно на одній табуляції.

Зараз потрібно розпочати документ із заголовка HTML 5. Це обмеження буде скасовано в майбутньому.

Елементи вмісту

Елементи HTML

Найосновнішими елементами є теги HTML. Кожен елемент, який не має особливого значення і починається з літери і містить лише літери, цифри, двокрапки, тире або підкреслення, розглядається як HTML-тег. Теги без вмісту, такі як
або розпізнаються та виводяться відповідно. Ім'я тегу також можна повністю пропустити, і в цьому випадку a

Після кожного тегу може слідувати ідентифікатор, кілька назв класів та список атрибутів. Ідентифікатори мають префікс "#", а імена класів - ".". Список атрибутів - це розділений комами список або пари ключ/значення, розділені затискачами. Значення рядка атрибута може містити рядкові інтерполяції.

Решта рядка містить текстовий вміст вузлів. За замовчуванням текст виводиться у форматі HTML та може містити рядкові інтерполяції. Якщо текст має префікс '=', він інтерпретується як вираз D. Результат цього виразу перетворюється на рядок та кодується HTML. Префікс "! =" Видасть голою рядок без кодування HTML.

Простий текст

Існує спеціальний вузол простого тексту для випадків, коли ви хочете розділити текст на кілька рядків, наприклад, тому, що ви виводите попередньо відформатований текст, або тому, що ви хочете змішати текст із вузлами html. Тег починається з конвеєра "|" і може супроводжуватися '=' або '! =' так само, як і вузли HTML. Послідовні текстові вузли виводяться окремими рядками у вихідний код HTML із видаленим відступом.

Це приклад, що містить посилання, змішане з текстом.

вирази І сире HTML вихід можливий.