Въведение

Имайте предвид, че оригиналната реализация на шаблони за диета е заменена от пакета DietNG, който поддържа редица допълнителни функции. Актуализирана версия на спецификацията се намира в SPEC.md на хранилището на GitHub.

шаблони

Този документ е в процес на разработка - моля, използвайте документацията за Pug за всеки раздел, който не е запълнен със съдържание, шаблоните за диета се поддържат възможно най-съвместими с шаблоните за Pug.

Диетичните шаблони са HTML шаблони, които са статично компилирани до родния D код. По този начин динамичните страници нямат почти никакви режими на изпълнение и често са дори по-бързи от статичните страници на диска, тъй като те просто се записват директно от RAM в HTTP връзката.

Синтаксисът се равнява на този наPugtemplates, с изключение на някои от разширените функции на синтаксиса. Тъй като все още няма официална справка за синтаксис, можете да използвате документацията на Pug като заместител. Основната разлика е, че пишете D изрази и изрази вместо JavaScript.

Основна структура

Общата структура използва отстъп за управление на влагането на HTML тагове, подобно на това, което прави Python. Стилът на отстъп на документ се налага да бъде последователен и може да бъде или раздели или произволен брой интервали. Стилът на отстъп се извежда от първия ред, който е с отстъп. Имайте предвид, че нивата на отстъпите никога не могат да бъдат пропуснати, така че първият отстъпен ред винаги трябва да бъде отстъпен с точно един табулатор.

В момента е необходимо да започнете документа с HTML 5 заглавка. Това ограничение ще бъде премахнато в бъдеще.

Елементи на съдържанието

HTML елементи

Най-основните елементи са HTML таговете. Всеки елемент, който няма специално значение и започва с буква и съдържа само букви, цифри, двоеточия, тирета или долни черти, се третира като HTML таг. Тагове без съдържание като
или се разпознават и извеждат съответно. Името на маркера може също да бъде напълно пропуснато, в този случай a

След всеки таг може да последва идентификатор, множество имена на класове и списък с атрибути. Идентификаторите са с префикс „#“, а имената на класове с „.“. Списъкът на атрибутите е разделен със запетая списък или двойки ключ/стойност, разделени със скоби. Стойността на низа на атрибут може да съдържа низови интерполации.

Останалата част от реда съдържа съдържанието на текста на възлите. По подразбиране текстът се извежда в HTML кодиран и може да съдържа низови интерполации. Ако текстът е с префикс '=', той се интерпретира като D израз. Резултатът от този израз се преобразува в низ и HTML кодиран. Префиксът с '! =' Ще изведе голия низ без HTML кодиране.

Обикновен текст

Има специален възел с обикновен текст за случаите, когато искате да разделите текст на няколко реда, например защото извеждате предварително форматиран текст или защото искате да смесите текст с HTML възли. Етикетът се стартира с контур '|' и може да бъде последвано от '=' или '! =' точно като HTML възли. Последователните текстови възли се извеждат като отделни редове в HTML изхода с премахнати отстъпи.

Това е пример, съдържащ връзка, смесена с текст.

изрази И сурово HTML изход са възможни.