Шаблон:HumanizeDate

Документация

[просмотр | править | история | обновить]

Этот шаблон использует некоторые чрезвычайно сложные и эзотерические свойства языка шаблонов.

Пожалуйста, не пытайтесь изменять его до тех пор, пока:

1. Вы до конца не поймёте, как он устроен.
2. Вы не будете готовы к устранению любых последствий в случае неожиданного результата.

Эксперименты следует проводить в песочнице или вашем личном пространстве.

Шаблон записывает дату, заданную по стандарту ISO 8601 (в форматах ГГГГ-ММ-ДД или ГГГГ-ММ), на естественном языке, а также форматирует её, соблюдая правила задания дат соответствующего языка. По умолчанию дата оформляется на русском. Если дата задана в произвольной форме или год меньше 1000, то шаблон возвращает её неизменной.

Параметры

{{HumanizeDate|дата


Этот шаблон  реализован на основе Lua с использованием функции onlyParams() из модуля Template call code.

Шаблон для выделения необязательных параметров в коде вызова шаблона серым (optp — optional parameters).



Этот шаблон  реализован на основе Lua с использованием функции withParams() из модуля Template call code.

{{HumanizeDate}} совмещает в себе функцию {{tc}} и {{pre}}. С его помощью удобно создавать примеры использования шаблонов в их документациях.
Например, чтобы показать синтаксис шаблона {{перенесено с}}, мы можем в его документации написать так:

{{tpre||''Вики-страница''{{optp|''подпись и/или текст в конце''|текст{{=}}''Текст вместо «Перенесено со страницы»''}}}}
{{optp/comment}}
и получим:

Шаблон:Tpre шаблонэн сузьет шедьтэмын
Серым показаны необязательные параметры.

Про такой стиль оформления синтаксисов шаблонов в документациях см. | вместо использования специального параметра -->
| Шаблон:Tc § В оформлении документации
| Шаблон:Tc#В оформлении документации
}}.
Между тем в многострочных примерах этот шаблон лучше не использовать по причине съедания пробелов до вертикальных черт, прибегая вместо него к оформлению при помощи пробела в начале строк. Это тоже позволяет включать разметку в код. Например (в начале каждой строки — пробел):

 {{((}}main
  |''Статья 1''
  |''Статья 2''
  |l1=''Отображаемый текст ссылки 1''
  |l2=''Отображаемый текст ссылки 2''
 }}

который даст:

{{main
 |Статья 1
 |Статья 2
 |l1=Отображаемый текст ссылки 1
 |l2=Отображаемый текст ссылки 2
}}

Настройки
Если задать |_spaced=1, параметры шаблона будут отбиты пробелами:

{{HumanizeDate|ш|параметр 1{{=}}значение|параметр 2{{=}}значение|_spaced=1}}
 ↓ ш
См. также
{{*tpre}} — то же самое с маркером списка (иначе его нельзя использовать напрямую)
{{sp↓}} — отбитая от левого края стрелка вниз, чтобы оформить ею результат обработки того, что показано в шаблоне {{tpre}}
{{пример}} — код вызова шаблона → результат; см. там стиль pre
{{pre}}
{{между pre}}
Документировать карон понна шаблонъёс
Шаблонъёс 





простая ссылка

без ссылки

subst:

подст:

любое ПИ

другой текст

другой раздел

для навигации


обычный

{{tl}} (без параметров)
{{tlp}} (с параметрами)

-

{{subst:tls}}

{{подст:шсп}}

{{tlu}}

{{tla}}

{{flt}}
{{ent}} (для англовики)

{{tnav}}


<code>

{{tcl}}

{{tc}}

{{subst:tcls}}

-

-

-

-

-


<pre>

-

Шаблон:Tpre шаблонэн сузьет шедьтэмын

-

-

-

-

-

-


{{mwmw|PAGENAME}} → {{PAGENAME}}
{{msgnw|пример}} → {{msgnw:пример}}
{{ub|Таблица}} → {{User:Box~udmwiki/Таблица}}
Параметръёс 
{{para|пример}} → |пример=
{{optp|пример1|пример2}} →
{{param|пример}} → {{{пример}}}
{{tpa|пример}} → {{{пример}}}
Тегъёс 
{{tag|пример}} → <пример></пример>
{{tagr|пример}} → <пример></пример>
{{tago|пример}} → <пример>
{{tagor|пример}} → <пример>
{{tagc|пример}} → </пример>
{{xtag|nowiki}} → <nowiki>
Примеръёс 
{{пример}}
{{стопка примеров}}
{{таблица примеров}}
{{demo}} (может показывать результат обработки любого вики-текста)
{{строка таблицы примеров}}
{{пример с именами параметров}}
{{заготовка шаблона}}
{{пример шаблона}}
{{markup}}
{{markup2}}
{{markupv}}

Шаблонъёсты документировать каронъя дэмланъёс
Категории
Шаблоны:Для документирования шаблонов
Шаблоны:Ссылки на шаблоны

↓
{{переход|#Раздел или #якорьШаблон:Optp шаблонэн сузьет шедьтэмын}}

Серым показаны необязательные параметры.
Про такой стиль оформления синтаксиса шаблона в документациях см. Шаблон:Tc#В оформлении документации.
Детали
По адресу {{optp/comment}} находится строка: Серым показаны необязательные параметры.
 Её можно давать под синтаксисом.
Чтобы в списке параметров под синтаксисом использовать серый цвет для указания, что параметр является необязательным, используйте класс ts-templateCallCode-weak, например: <code class="ts-templateCallCode-weak">''тип значка''</code> → тип значка
Документировать карон понна шаблонъёс
Шаблонъёс 





простая ссылка

без ссылки

subst:

подст:

любое ПИ

другой текст

другой раздел

для навигации


обычный

{{tl}} (без параметров)
{{tlp}} (с параметрами)

-

{{subst:tls}}

{{подст:шсп}}

{{tlu}}

{{tla}}

{{flt}}
{{ent}} (для англовики)

{{tnav}}


<code>

{{tcl}}

{{tc}}

{{subst:tcls}}

-

-

-

-

-


<pre>

-


Этот шаблон  реализован на основе Lua с использованием функции withParams() из модуля Template call code.

{{HumanizeDate}} совмещает в себе функцию {{tc}} и {{pre}}. С его помощью удобно создавать примеры использования шаблонов в их документациях.
Например, чтобы показать синтаксис шаблона {{перенесено с}}, мы можем в его документации написать так:

{{tpre||''Вики-страница''{{optp|''подпись и/или текст в конце''|текст{{=}}''Текст вместо «Перенесено со страницы»''}}}}
{{optp/comment}}
и получим:

Шаблон:Tpre шаблонэн сузьет шедьтэмын
Серым показаны необязательные параметры.

Про такой стиль оформления синтаксисов шаблонов в документациях см. | вместо использования специального параметра -->


Шаблон:Tc § В оформлении документации

Шаблон:Tc#В оформлении документации
}}.
Между тем в многострочных примерах этот шаблон лучше не использовать по причине съедания пробелов до вертикальных черт, прибегая вместо него к оформлению при помощи пробела в начале строк. Это тоже позволяет включать разметку в код. Например (в начале каждой строки — пробел):

 {{((}}main
  |''Статья 1''
  |''Статья 2''
  |l1=''Отображаемый текст ссылки 1''
  |l2=''Отображаемый текст ссылки 2''
 }}

который даст:

{{main


Статья 1

Статья 2

l1=Отображаемый текст ссылки 1

l2=Отображаемый текст ссылки 2
}}

Настройки
Если задать |_spaced=1, параметры шаблона будут отбиты пробелами:

{{HumanizeDate|ш|параметр 1{{=}}значение|параметр 2{{=}}значение|_spaced=1}}
 ↓ ш
См. также
{{*tpre}} — то же самое с маркером списка (иначе его нельзя использовать напрямую)
{{sp↓}} — отбитая от левого края стрелка вниз, чтобы оформить ею результат обработки того, что показано в шаблоне {{tpre}}
{{пример}} — код вызова шаблона → результат; см. там стиль pre
{{pre}}
{{между pre}}
Шаблон:Шаблоны для документирования шаблонэн сузьет шедьтэмын


-

-

-

-

-

-


{{mwmw|PAGENAME}} → {{PAGENAME}}
{{msgnw|пример}} → {{msgnw:пример}}
{{ub|Таблица}} → {{User:Box~udmwiki/Таблица}}
Параметръёс 
{{para|пример}} → |пример=
{{optp|пример1|пример2}} →
{{param|пример}} → {{{пример}}}
{{tpa|пример}} → {{{пример}}}
Тегъёс 
{{tag|пример}} → <пример></пример>
{{tagr|пример}} → <пример></пример>
{{tago|пример}} → <пример>
{{tagor|пример}} → <пример>
{{tagc|пример}} → </пример>
{{xtag|nowiki}} → <nowiki>
Примеръёс 
{{пример}}
{{стопка примеров}}
{{таблица примеров}}
{{demo}} (может показывать результат обработки любого вики-текста)
{{строка таблицы примеров}}
{{пример с именами параметров}}
{{заготовка шаблона}}
{{пример шаблона}}
{{markup}}
{{markup2}}
{{markupv}}

Шаблонъёсты документировать каронъя дэмланъёс
Категории
Шаблоны:Для документирования шаблонов
Шаблоны:Ссылки на шаблоны
}}

, где:

дата — дата по стандарту ISO 8601 в форматах ГГГГ-ММ-ДД или ГГГГ-ММ (например, 1605-11-05 для 5 ноября 1605 года или 1976-04 для апреля 1976-го);
язык — необязательный параметр кода языка в формате ISO 639-1 или ISO 639-2, если язык отсутствует в ISO 639-1 (см. список кодов; например, en для английского или fr для французского, а по умолчанию используется русский язык).

Примеры

Код	Результат
`{{HumanizeDate\|1975-08-14}}`	14 гудырикошконэ 1975
`{{HumanizeDate\|1975-03}}`	южтолэзь 1975
`{{HumanizeDate\|1997-08-29\|en}}`	29 August 1997
`{{HumanizeDate\|2007-07\|en}}`	July 2007
`{{HumanizeDate\|1997-08-31\|fr}}`	31 août 1997
`{{HumanizeDate\|1984-10-29\|de}}`	29 Oktober 1984
`{{HumanizeDate\|2004-04-19\|es}}`	19 abril 2004
`{{HumanizeDate\|1001-01-01\|ru}}`	1 января 1001
`{{HumanizeDate\|2003-07-05\|ar}}`	٥ يوليو ٢٠٠٣
`{{HumanizeDate\|1453-12-31\|el}}`	31 Δεκεμβρίου 1453
`{{HumanizeDate\|1656-03-18\|uk}}`	18 березня 1656

См. также

{{TranslateDate}} — используемая в этом шаблоне строгая версия с заданием даты по частям
{{+года}} — добавляет слово «года», если его нет (это уместно, если дата используется в предложении)