Редактирование: Шаблон:Cite web/doc (раздел)

== Описание параметров ==

=== Обязательные параметры ===
* '''url''': ссылка на цитируемый источник.
{{Правила для URL в MediaWiki}}
* '''title''': заглавие цитируемого источника (заголовок публикации, но не название сайта-издателя, для него см. ниже параметры '''website''' и '''publisher'''). Вокруг заглавия не нужны кавычки, в конце не должно быть точки.
: Если заглавие содержит специальные символы (перевод строки и |), их нужно заменять, иначе ссылка будет сформирована неверно:
{| class="wikitable" style="margin-left: 1.6em;"
! перевод строки !! &#124;
|-
| пробел || style="text-align: center;" | &amp;#124;
|}
: Оформление отдельных слов как вики-ссылок<nowiki>[[]]</nowiki> будет считаться Lint-ошибкой — заглавие целиком уже в ссылке.

=== Необязательные параметры ===
* '''author''': автор (или список авторов). Рекомендуется использовать этот параметр во всех случаях, когда известны авторы цитируемого источника. Это может быть как фамилия с именем, так и ник автора. Примеры: <code>Вирт,{{nbsp}}Никлаус</code>, <code>Вирт{{tl|nbsp}}Н.</code>. Рекомендуется оборачивать ФИО каждого автора в шаблон {{tl|автор}}, и по мере возможности указывать полное имя автора (например, <code><nowiki>{{автор|Иванов, Иван Иванович|Иванов, И. И.}}</nowiki></code> или хотя бы <code><nowiki>{{автор||Иванов, И. И.}}</nowiki></code>). При этом нет необходимости использовать [[Неразрывный пробел|неразрывные пробелы]] — шаблон {{tl|автор}} сделает всё сам.
: ''Данный параметр используется, только если не заполнены поля '''last''' и '''first''' (см.{{nbsp}}ниже); при заполненном поле '''last''' содержание этого поля будет проигнорировано.''
:* '''first''': личное имя автора, ''используется вместе с '''last''' (фамилия автора). При пустом поле '''last''' содержание этого поля будет проигнорировано''. В конце должна стоять точка.
:* '''last''': фамилия автора, используется вместе с '''first''' (личное имя автора).
* '''author-link''': название статьи Википедии, если такая существует, об авторе (без скобок <nowiki>[[]]</nowiki>). Используется с '''author''' либо с '''last''' и '''first''' для формирования ссылки на статью про автора.
* '''coauthors''': список остальных авторов.
* '''editor''': редактор (или список редакторов).
* '''subtitle''': подзаголовок статьи. Выводится мелким шрифтом непосредственно за заголовком.
* '''lang''': язык источника в формате [[ISO 639]]-1 или ISO 639-2, если язык отсутствует в ISO 639-1 (см. [[Коды_языков#Коды_языков_по_ISO_639_и_ГОСТ_7.75-97|список кодов]]). Примеры: '''en''' — английский, '''de''' — немецкий, '''ja''' — японский, '''eo''' — эсперанто. Если источник на русском языке, рекомендуется указать '''ru''', при этом метка языка для читателей отображаться не будет. Если язык не указан, страница попадает в категорию «[[:Категория:Википедия:Cite web (не указан язык)]]». В связи с этим для источников (особенно на языках, отличных от русского) настоятельно рекомендуется указывать код языка при простановке шаблона. Если текст в источнике написан на нескольких языках (например, в письменном договоре), то есть возможность указать их, используя в качестве разделителя символ «'''/'''» (например, '''lang=en/ru/fr'''). (связанные обсуждения: [[Обсуждение шаблона:Cite web/Архив/2016#lang по умолчанию|2016]] [[Обсуждение шаблона:Cite web/Архив/2018#Отключить отображение пометки русского языка|2018]])
* '''format''': формат источника, указанного в поле '''url''' (если это не '''HTML'''). Пример: '''PDF'''.
* '''website''' (прежнее название — '''work'''): название сайта, проекта, издания, например '''<nowiki>[[Лента.ру]]</nowiki>''' или '''<nowiki>Интернет-версия издания: Новая философская энциклопедия: {{nobr|в 4 т.}}</nowiki>'''.
* '''publisher''': издатель, например '''<nowiki>[[Коммерсант (издательский дом)|]]</nowiki>'''.
* '''date''': дата публикации (возможно указание в произвольном формате, например '''10 февраля 2007''', но желательно использование формата ГГГГ-ММ-ДД, ГГГГ-ММ или ГГГГ, например '''2007-02-10''', '''2005-10''', позволяющего автоматически переводить дату на язык, указанный в параметре '''lang'''. Если номер дня или месяца состоит из одной цифры, необходимо перед ним ставить «0», например: 1945-'''0'''5-'''0'''9).
* '''description''': дополнительное описание-комментарий, приводится в конце описания.
* '''quote''': цитата из источника. Приводится в конце описания в кавычках.
* '''pages''': конкретная страница или диапазон страниц в источнике, если, например, ссылка указывает на PDF-файл со статьёй. Пример: '''С.{{nbsp}}105''' — для русскоязычного источника, '''P.{{nbsp}}105''' — для англоязычного.
* '''location''': место издания, например '''Москва''' или '''Брюссель'''.
* '''doi''': {{abbr|{{lang-en2|DOI}}|Digital Object Identifier|0}} ([[идентификатор цифрового объекта]]) публикации. Пример использования: '''doi&nbsp;=&nbsp;10.1081/E-ELIS3-120044418'''
* '''access-date''': дата, когда последний раз было проверено, что источник подтверждает текст статьи (в формате ГГГГ-ММ-ДД). Пример: '''{{#time: Y-m-d}}'''.
* {{anchor|deadlink}}'''deadlink''' (устаревший, используйте '''url-status'''): ''yes'' или no. Если ссылка недоступна, либо не подтверждает текст статьи по причине изменений на сайте (см. access-date), устанавливается значение ''yes''. Если ссылка в порядке, устанавливается ''no''. При установке значения ''yes'' шаблон покажет ссылку на поиск информации в архиве.
* '''url-status''': ''live'', ''dead'' или ''unfit''. Если ссылка недоступна, устанавливается значение ''dead''. Если ссылка не подтверждает текст статьи по причине изменений на сайте (см. access-date), то устанавливается ''unfit''. Если ссылка в порядке, устанавливается ''live''. При установке значения ''dead'' или ''unfit'' шаблон покажет ссылку на поиск информации в архиве.
* Параметры для указания адреса архивированной копии документа, недоступного по основной ссылке. В случае использования должны присутствовать оба параметра:
** '''archive-url''': ссылка на сохранённую копию документа, обычно в «[[Архив Интернета|Архиве Интернета]]» или в другом сервисе хранения копий веб-страниц. Используется для борьбы с [[Википедия:Вымирание ссылок|вымиранием ссылок]].
** '''archive-date''': дата архивирования (в формате ГГГГ-ММ-ДД).
* '''ref''': идентификатор источника, используемый для последующей простановки коротких сносок на источники при помощи шаблона {{tl|sfn}}. Пример: при указанном '''ref&nbsp;=&nbsp;Иванов''' для ссылки на источник можно использовать {{tlp|sfn|Иванов}} либо, при указанной дате публикации ('''date&nbsp;=&nbsp;2020''' или '''date&nbsp;=&nbsp;2020-12-20'''), {{tlp|sfn|Иванов|2020}}. Подробнее см. документацию шаблона {{tl|sfn}}

=== Неименованные параметры ===
Шаблон не поддерживает неименованные ([[ВП:Параметры|нумерованные]]) параметры. В случае, если такие параметры обнаружены:
* Если первый неименованный параметр не пустой, то будет показана ошибка, а страница добавлена в [[:Категория:Википедия:Cite web (некорректное использование: непустой неименованный параметр)|отслеживающую категорию]]. Такие ошибки необходимо исправлять, так как зачастую это свидетельствует о неверном заполнении шаблона (например, заполнении <code>|lang+en</code> вместо <code>|lang=en</code> или использовании вертикальной черты в параметре <code>title</code> (см. [[#Обязательные параметры]])).
** <code><nowiki>{{cite web |title = Google |url = https://google.com |lang + en }}</nowiki></code> = {{cite web |title = Google |url = https://google.com |lang + en }}
** <code><nowiki>{{cite web |title = Main Page | Google |url = https://google.com }}</nowiki></code> = {{cite web |title = Main Page | Google |url = https://google.com }}
* Если неименованный параметр пустой, то при ''предпросмотре'' будет показана ошибка, а страница добавлена в [[:Категория:Википедия:Cite web (страницы с неверным параметром)|отслеживающую категорию]]. Это также желательно исправить, чтобы не замусоривать исходный код и избежать неопределённого поведения при возможных изменениях шаблона в будущем. Обратите внимание, что первая проверка работает только для первого параметра (соответственно, если первый неименованный параметр пустой, а второй — не пустой, то важная ошибка может быть пропущена).
** <code><nowiki>{{cite web ||title = Main Page | Google |url = https://google.com }}</nowiki></code> = {{cite web ||title = Main Page | Google |url = https://google.com }}