Тептар:Документация шаблонов: различия между версиями
Buto (обсуждение | вклад) Новая страница: «__NOTOC__ Тептар проект «Документирование шаблонов» создан для выработки общих правил пользования шаблонами (уместность применения, правила установки и снятия и т. д.). На данный момент многие шаблоны не имеют соответствующих отметок, что необходимо испр...» |
Buto (обсуждение | вклад) |
||
| Строка 39: | Строка 39: | ||
* Для описания параметров (полей) крупных шаблонов, кроме списков{{sp/}}таблиц, можно пользоваться хорошо оформленным шаблоном {{t|описание шаблона}}. | * Для описания параметров (полей) крупных шаблонов, кроме списков{{sp/}}таблиц, можно пользоваться хорошо оформленным шаблоном {{t|описание шаблона}}. | ||
* Для упоминания шаблонов используйте шаблон {{t|t}}: {{пример|t|пример}}. | * Для упоминания шаблонов используйте шаблон {{t|t}}: {{пример|t|пример}}. | ||
* Названия параметров обычно записываются со строчной буквы, при необходимости в них используются пробелы. Что касается названий самих шаблонов — дело вкуса, но вряд ли названия узкоспециальных шаблонов технического характера (как то: {{t|lang-en}}, {{t|примечания}}) стоит писать с прописной. В то же время в названиях шаблонов-карточек | * Названия параметров обычно записываются со строчной буквы, при необходимости в них используются пробелы. Что касается названий самих шаблонов — дело вкуса, но вряд ли названия узкоспециальных шаблонов технического характера (как то: {{t|lang-en}}, {{t|примечания}}) стоит писать с прописной. В то же время в названиях шаблонов-карточек устоялась первая прописная. | ||
* Ещё одна мелочь — как в коде включения многострочных шаблонов отбивать вертикальные черты от начала строк, а названия параметров — от вертикальных черт. В английском разделе часто либо нет отбития вовсе, либо отбиваются названия параметров от вертикальных черт на один символ. У нас в этом деле разнобой.{{pb | * Ещё одна мелочь — как в коде включения многострочных шаблонов отбивать вертикальные черты от начала строк, а названия параметров — от вертикальных черт. В английском разделе часто либо нет отбития вовсе, либо отбиваются названия параметров от вертикальных черт на один символ. У нас в этом деле разнобой.{{pb | ||
}}В свою очередь, в длинных однострочных шаблонах для лучшей читаемости целесообразно отбивать каждый следующий параметр пробелом. | }}В свою очередь, в длинных однострочных шаблонах для лучшей читаемости целесообразно отбивать каждый следующий параметр пробелом. | ||