Шаблон:Cite web/doc: различия между версиями

Версия от 17:30, 22 июня 2023

Внимание! Это один из самых используемых шаблонов.

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

Файл:Lua-logo-nolabel.svg

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

Шаблон используется для оформления библиографических ссылок на публикации, размещённые в интернете.

Образцы для копирования

Рекомендуемый вариант

{{cite web |author= |url= |title= |lang= |website= |publisher= |date= |access-date=2024-11-10}}

Рекомендуемый вариант, многострочный

{{cite web
 |author      = 
 |url         = 
 |title       = 
 |lang        = 
 |website     = 
 |publisher   = 
 |date        = 
 |access-date = 2024-11-10
}}

Минимальный

{{cite web |url= |title= |website= |access-date=2024-11-10|lang=}}

Более полный вариант

{{cite web |author= |author-link= |coauthors= |url= |title= |subtitle= |lang= |format= |website= |publisher= |date= |description= |quote= |doi= |access-date=2024-11-10 |deadlink= |archive-url= |archive-date= }}

Более полный вариант, многострочный

{{cite web
 |author       = 
 |author-link  = 
 |coauthors    = 
 |url          = 
 |title        = 
 |subtitle     = 
 |lang         = 
 |format       = 
 |website      = 
 |publisher    = 
 |date         = 
 |description  = 
 |quote        = 
 |doi          = 
 |access-date  = 2024-11-10
 |deadlink     = 
 |archive-url  = 
 |archive-date = 
}}

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

Обязательные параметры

url: ссылка на цитируемый источник.

Если URL содержит определённые символы, ссылка не будет сформирована верно. Эти символы должны быть закодированы с использованием знака процента. К примеру, пробел должен быть заменён на %20. Чтобы закодировать URL, замените следующие символы:

пробел	"	'	<	>	[	]	{	\|	}
%20	%22	%27	%3C	%3E	%5B	%5D	%7B	%7C	%7D

Одиночные апострофы кодировать не нужно, однако несколько апострофов подряд будут считаться частью разметки. Одиночные фигурные скобки также не нуждаются в кодировании, однако пара таких символов будет считаться частью разметки, отвечающей за включение шаблона.

title: заглавие цитируемого источника (заголовок публикации, но не название сайта-издателя, для него см. ниже параметры website и publisher). Вокруг заглавия не нужны кавычки, в конце не должно быть точки.

Если заглавие содержит специальные символы (перевод строки и |), их нужно заменять, иначе ссылка будет сформирована неверно:

перевод строки	\|
пробел	\|

Оформление отдельных слов как вики-ссылок[[]] будет считаться Lint-ошибкой — заглавие целиком уже в ссылке.

Необязательные параметры

author: автор (или список авторов). Рекомендуется использовать этот параметр во всех случаях, когда известны авторы цитируемого источника. Это может быть как фамилия с именем, так и ник автора. Примеры: Вирт, Никлаус, Вирт{{nbsp}}Н.. Рекомендуется оборачивать ФИО каждого автора в шаблон {{автор}}, и по мере возможности указывать полное имя автора (например, {{автор|Иванов, Иван Иванович|Иванов, И. И.}} или хотя бы {{автор||Иванов, И. И.}}). При этом нет необходимости использовать неразрывные пробелы — шаблон {{автор}} сделает всё сам.

Данный параметр используется, только если не заполнены поля last и first (см. ниже); при заполненном поле last содержание этого поля будет проигнорировано.

first: личное имя автора, используется вместе с last (фамилия автора). При пустом поле last содержание этого поля будет проигнорировано. В конце должна стоять точка.
last: фамилия автора, используется вместе с first (личное имя автора).

author-link: название статьи Википедии, если такая существует, об авторе (без скобок [[]]). Используется с author либо с last и first для формирования ссылки на статью про автора.
coauthors: список остальных авторов.
editor: редактор (или список редакторов).
subtitle: подзаголовок статьи. Выводится мелким шрифтом непосредственно за заголовком.
lang: язык источника в формате ISO 639-1 или ISO 639-2, если язык отсутствует в ISO 639-1 (см. список кодов). Примеры: en — английский, de — немецкий, ja — японский, eo — эсперанто. Если источник на русском языке, рекомендуется указать ru, при этом метка языка для читателей отображаться не будет. Если язык не указан, страница попадает в категорию «Категория:Википедия:Cite web (не указан язык)». В связи с этим для источников (особенно на языках, отличных от русского) настоятельно рекомендуется указывать код языка при простановке шаблона. Если текст в источнике написан на нескольких языках (например, в письменном договоре), то есть возможность указать их, используя в качестве разделителя символ «/» (например, lang=en/ru/fr). (связанные обсуждения: 2016 2018)
format: формат источника, указанного в поле url (если это не HTML). Пример: PDF.
website (прежнее название — work): название сайта, проекта, издания, например [[Лента.ру]] или Интернет-версия издания: Новая философская энциклопедия: {{nobr|в 4 т.}}.
publisher: издатель, например [[Коммерсант (издательский дом)|]].
date: дата публикации (возможно указание в произвольном формате, например 10 февраля 2007, но желательно использование формата ГГГГ-ММ-ДД, ГГГГ-ММ или ГГГГ, например 2007-02-10, 2005-10, позволяющего автоматически переводить дату на язык, указанный в параметре lang. Если номер дня или месяца состоит из одной цифры, необходимо перед ним ставить «0», например: 1945-05-09).
description: дополнительное описание-комментарий, приводится в конце описания.
quote: цитата из источника. Приводится в конце описания в кавычках.
pages: конкретная страница или диапазон страниц в источнике, если, например, ссылка указывает на PDF-файл со статьёй. Пример: С. 105 — для русскоязычного источника, P. 105 — для англоязычного.
location: место издания, например Москва или Брюссель.
doi: DOI (идентификатор цифрового объекта) публикации. Пример использования: doi = 10.1081/E-ELIS3-120044418
access-date: дата, когда последний раз было проверено, что источник подтверждает текст статьи (в формате ГГГГ-ММ-ДД). Пример: 2024-11-10.
deadlink: yes или no. Если ссылка недоступна, либо не подтверждает текст статьи по причине изменений на сайте (см. accessdate), устанавливается значение yes. Если ссылка в порядке, устанавливается no. При установке значения yes шаблон покажет ссылку на поиск информации в архиве.
Параметры для указания адреса архивированной копии документа, недоступного по основной ссылке. В случае использования должны присутствовать оба параметра:
- archive-url: ссылка на сохранённую копию документа, обычно в «Архиве Интернета» или в другом сервисе хранения копий веб-страниц. Используется для борьбы с вымиранием ссылок.
- archive-date: дата архивирования (в формате ГГГГ-ММ-ДД).
ref: идентификатор источника, используемый для последующей простановки коротких сносок на источники при помощи шаблона {{sfn}}. Пример: при указанном ref = Иванов для ссылки на источник можно использовать {{sfn|Иванов}} либо, при указанной дате публикации (date = 2020 или date = 2020-12-20), {{sfn|Иванов|2020}}. Подробнее см. документацию шаблона {{sfn}}

Неименованные параметры

Шаблон не поддерживает неименованные (нумерованные) параметры. В случае, если такие параметры обнаружены:

Если первый неименованный параметр не пустой, то будет показана ошибка, а страница добавлена в отслеживающую категорию. Такие ошибки необходимо исправлять, так как зачастую это свидетельствует о неверном заполнении шаблона (например, заполнении |lang+en вместо |lang=en или использовании вертикальной черты в параметре title (см. #Обязательные параметры)).
- {{cite web |title = Google |url = https://google.com |lang + en }} = Все параметры шаблона {{cite web}} должны иметь имя. Google (неопр.).1 = lang ? en
- {{cite web |title = Main Page | Google |url = https://google.com }} = Все параметры шаблона {{cite web}} должны иметь имя. Main Page (неопр.).1 = Google
Если неименованный параметр пустой, то при предпросмотре будет показана ошибка, а страница добавлена в отслеживающую категорию. Это также желательно исправить, чтобы не замусоривать исходный код и избежать неопределённого поведения при возможных изменениях шаблона в будущем. Обратите внимание, что первая проверка работает только для первого параметра (соответственно, если первый неименованный параметр пустой, а второй — не пустой, то важная ошибка может быть пропущена).
- {{cite web ||title = Main Page | Google |url = https://google.com }} = Все параметры шаблона {{cite web}} должны иметь имя. Main Page (неопр.).1 = 2 = Google

Примеры

{{cite web
 |url        = http://www.citforum.ru/programming/digest/wirth/
 |title      = Хорошие идеи: взгляд из Зазеркалья
 |author     = Вирт, Никлаус
 |author-link= Вирт, Никлаус
 |date       = 2006
 |access-date= 2006-04-23
 |lang       = ru
}}

Вирт, Никлаус. Хорошие идеи: взгляд из Зазеркалья (рус.) (2006). Дата обращения: 23 апреля 2006.

{{cite web
 |url         = http://www.google.com
 |title       = Google
 |access-date = 2006-04-29
 |lang        = en
 |description = главная страница
}}

Google (англ.). — главная страница. Дата обращения: 29 апреля 2006.

{{cite web
 |url         = http://www.rg.ru/2007/03/07/dogovora-ogovorki-dok.html
 |title       = Федеральный закон РФ от 3 марта 2007 г. № 28-ФЗ
 |website     = «[[Российская газета]]»
 |date        = 2007-03-07
 |access-date = 2008-09-08
 |description = О снятии оговорок к некоторым международным договорам
 |lang        = ru
}}

Федеральный закон РФ от 3 марта 2007 г. № 28-ФЗ (рус.). «Российская газета» (7 марта 2007). — О снятии оговорок к некоторым международным договорам. Дата обращения: 8 сентября 2008.

{{cite web
 |url         = http://ru.wikipedia.org
 |title       = Main Page — Wikipedia
 |access-date = 2002-12-02
 |description = Архивная копия главной страницы русского раздела Википедии
 |archive-url = http://web.archive.org/web/20021202073511/http://ru.wikipedia.org/
 |archive-date= 2002-12-02
 |lang        = ru
}}

Main Page — Wikipedia (рус.). — Архивная копия главной страницы русского раздела Википедии. Дата обращения: 2 декабря 2002. Архивировано 2 декабря 2002 года.

{{cite web
 |url         = http://svpressa.ru/society/article/19349/
 |title       = Зиганшин-буги, Зиганшин-рок, Зиганшин съел второй сапог
 |subtitle    = Полвека назад четверо наших солдат потрясли мир, проведя в океане без питьевой воды и еды 49 суток
 |date        = 2010-01-08
 |author      = Ирина Смирнова
 |website     = Свободная пресса
 |archive-url = http://www.webcitation.org/665xkww03
 |archive-date= 2012-03-12
 |quote       = 49 суток провели эти люди в открытом море без воды и еды. Но они выжили!
 |lang        = ru
}}

Ирина Смирнова. Зиганшин-буги, Зиганшин-рок, Зиганшин съел второй сапог. Полвека назад четверо наших солдат потрясли мир, проведя в океане без питьевой воды и еды 49 суток (рус.). Свободная пресса (8 января 2010). — «49 суток провели эти люди в открытом море без воды и еды. Но они выжили!» Архивировано 12 марта 2012 года.

Служебные детали

Шаблон содержит два скрытых элемента: обозначение русского языка и обозначение отсутствующего языка. Вы можете включить их, добавив в свой личный css строки ниже:

/* Показать скрытые элементы шаблонов источников */
.hidden-ref { display: inline !important; }

Отслеживающие категории

Википедия:Cite web (некорректное использование)

Песочница и тестовая страница

Шаблон:Cite web/песочница — песочница
Шаблон:Cite web/тесты — тесты

См. также

Википедия:Ссылки на источники

Шаблоны

{{cite web 2}} — усовершенствованная версия шаблона {{cite web}}
{{книга}}
{{статья}}
{{публикация}}
{{АрхИ}}
{{cite news}}
{{cite book}}
{{cite journal}}
{{cite episode}}
{{cite mailing list}}
{{cite doi}} — автосоздание ссылки по DOI; реализовано через шаблон, что позволяет дооформлять ссылку на конкретный источник в одном месте, не трогая при этом множество статей, в которых эта ссылка используется.

Инструменты

Википедия:Гаджеты/refToolbar — гаджет для облегчения добавления сносок
DOI Wikipedia reference generator (генератор сноски по DOI)
Букмарклет для быстрого формирования кода шаблона (см. «Версия для {{cite web}}»)

Ссылки

TemplateData

Оформление библиографических ссылок на публикации, размещённые в сети Интернет. При использовании в сносках (ref) источник сам появится в разделе примечаний.

Параметры шаблона
Шаблон использует строчное форматирование параметров.
Параметр		Описание	Тип	Статус
язык источника	`lang` `language`	язык источника в формате ISO 639-1 или ISO 639-2, если язык отсутствует в ISO 639-1 (см. список кодов). Примеры: en — английский, de — немецкий, ja — японский, eo — эсперанто. Если источник на русском языке, то можно указать '''ru''', при этом язык отображаться не будет. Пример en, de, ja, eo, ru	Однострочный	предложенный
ссылка	`url`	ссылка на цитируемый источник.	URL	обязательный
заголовок	`title`	заглавие цитируемого источника (заголовок публикации, но не название сайта-издателя, для него см. ниже параметр publisher). Вокруг заглавия не нужны кавычки, в конце не должно быть точки. Если заголовок содержит специальные символы, например «\|», их нужно заменять на соответствующие &#nnn;-последовательности, например «\|»	Однострочный	обязательный
автор	`author`	автор (или список авторов). Рекомендуется использовать этот параметр во всех случаях, когда известны авторы цитируемого источника. Это может быть как фамилия с именем, так и ник автора. Примеры: Вирт, Никлаус, Вирт Н. Используется, если не заполнены поля last и first (см. ниже), при заполненном поле last содержание этого поля будет проигнорировано.	Однострочный	предложенный
имя автора	`first`	личное имя автора, используется вместе с last (фамилия автора). При пустом поле last содержание этого поля будет проигнорировано. В конце должна стоять точка.	Однострочный	необязательный
фамилия автора	`last`	фамилия автора, используется вместе с first (личное имя автора).	Однострочный	необязательный
статья об авторе	`author-link` `authorlink`	название статьи Википедии, если такая существует, об авторе (без скобок [[]]). Используется с author либо с last и first для формирования ссылки на статью про автора.	Имя страницы	необязательный
список соавторов	`coauthors`	список остальных авторов.	Однострочный	необязательный
редактор/редакторы	`editor`	редактор (или список редакторов).	Однострочный	необязательный
название сайта или проекта	`website` `work`	название сайта или иного проекта (например, книги), если источник — его часть.	Однострочный	предложенный
подзаголовок статьи	`subtitle`	подзаголовок статьи. Выводится мелким шрифтом непосредственно за заголовком.	Однострочный	необязательный
описание	`description`	дополнительное описание-комментарий, приводится в конце описания.	Несбалансированный вики-текст	необязательный
дата публикации	`date` `datepublished`	дата публикации (возможно указание в произвольном формате, например 10 февраля 2007, но желательно использование формата ГГГГ-ММ-ДД, ГГГГ-ММ или ГГГГ, например 2007-02-10, 2005-10, позволяющего автоматически переводить дату на язык, указанный в параметре lang. Если число месяца состоит из одной цифры, необходимо перед ним ставить «0», например: 1945-05-09). Пример 1945-05-09	Дата	предложенный
формат источника	`format`	формат источника, указанного в поле url (если это не HTML). Пример PDF	Однострочный	необязательный
страницы	`pages`	конкретная страница или диапазон страниц в источнике, если, например, ссылка указывает на PDF-файл со статьёй. Пример: С. 105 — для русскоязычного источника, P. 105 — для англоязычного. Пример С. 105, P. 105	Однострочный	необязательный
место издания	`location`	без описания Пример Москва, Брюссель	Однострочный	необязательный
издатель	`publisher`	без описания Пример [[Коммерсант (издательский дом)\|]]	Несбалансированный вики-текст	предложенный
DOI	`doi`	DOI (идентификатор цифрового объекта) публикации. Пример 10.1081/E-ELIS3-120044418	Однострочный	необязательный
URL архивной копии	`archive-url` `archiveurl`	ссылка на сохранённую копию документа, обычно в «Архиве Интернета» или в другом сервисе хранения копий веб-страниц. Используется для борьбы с вымиранием ссылок.	URL	необязательный
дата архивирования	`archive-date` `archivedate`	дата архивирования (в формате ГГГГ-ММ-ДД).	Дата	необязательный
дата последней проверки	`access-date` `accessdate`	дата, когда последний раз было проверено, что источник подтверждает текст статьи (в формате ГГГГ-ММ-ДД). Пример 2013-07-22	Дата	необязательный
мёртвая ссылка	`deadlink` `deadurl` `dead-url`	''yes'' или no. Если ссылка недоступна, либо не подтверждает текст статьи по причине изменений на сайте (см. accessdate), устанавливается значение ''yes''. Если ссылка в порядке, устанавливается ''no''. При установке значения ''yes'' шаблон покажет ссылку на поиск информации в архиве. Предлагаемые значения `yes` `no` `none`	Строковый (без форматирования)	необязательный
метка шаблона sfn	`ref`	имя ссылки для последующего использования в шаблоне {{sfn}}	Однострочный	необязательный
цитата	`quote`	цитата из источника. Приводится в конце описания в кавычках.	Строковый (без форматирования)	необязательный
last1	`last1`	без описания	Неизвестно	необязательный
first1	`first1`	без описания	Неизвестно	необязательный
last2	`last2`	без описания	Неизвестно	необязательный
first2	`first2`	без описания	Неизвестно	необязательный
last3	`last3`	без описания	Неизвестно	необязательный
first3	`first3`	без описания	Неизвестно	необязательный
last4	`last4`	без описания	Неизвестно	необязательный
first4	`first4`	без описания	Неизвестно	необязательный
last5	`last5`	без описания	Неизвестно	необязательный
first5	`first5`	без описания	Неизвестно	необязательный
page	`page`	без описания	Неизвестно	необязательный
year	`year`	без описания	Неизвестно	необязательный
month	`month`	без описания	Неизвестно	необязательный

@@ Строка 473: / Строка 473: @@
 		"citoid": {
 			"accessDate": "access-date",
-			"author": "author",
+			"author": [
+				[
+					"first",
+					"last"
+				],
+				[
+					"first2",
+					"last2"
+				],
+				[
+					"first3",
+					"last3"
+				],
+				[
+					"first4",
+					"last4"
+				],
+				[
+					"first5",
+					"last5"
+				]
+			],
 			"contributor": "coauthors",
 			"date": "date",
@@ Строка 482: / Строка 503: @@
 			"blogTitle": "website",
 			"publicationTitle": "website",
-			"forumTitle": "website"
+			"forumTitle": "website",
+			"DOI": "doi"
 		},
 		"proveit": {