Справка:Структурированные цитаты

Структурированные цитаты — инструмент, который позволяет работать с большим количеством цитат, быстро добавлять их в статьи, использовать разное оформление цитат, выводить цитаты на страницы по определённым параметрам.

Важно замечание. На данный момент синтаксис шаблона структурированных цитат и ряд других параметров работает только на английском языке, о чём отдельно будет упомянуто в данной статье. Возможно, это изменится в будущем, и структурированные цитаты будут оптимизированы для других языков.

Шаблон структурированных цитат

На каждую вики был добавлен шаблон, который по умолчанию называется Шаблон:StructuredQuote.

Этот шаблон является ключевым для использования структурированных цитат. Его можно переименовать, но обязательно оставляйте перенаправление с исходного шаблона. Без этого переименованный шаблон структурированной цитаты работать не будет. Также весь синтаксис шаблона будет работать только, как указано ниже. Переименование исходного шаблона не влияет на это.

Использование шаблона структурированных цитат

Для использования шаблона, вы должны добавить на страницу следующий синтаксис:

{{#SQuote:
|id=<уникальный идентификатор цитаты>
|text=<текст цитаты>
|speaker=<чья цитата (ссылка или ссылки, разделённые запятыми)>
|receiver=<тот, к кому цитата обращена (ссылка или ссылки, разделённые запятыми)>
|attribution=<атрибуция, автор произведения/источника цитаты (ссылка или ссылки, разделённые запятыми)>
|source=<источник цитаты (ссылка)>
|template=<название шаблона (не обязательно, по умолчанию будет использован шаблон "StructuredQuote")>
}}

Пояснения и замечания для использования шаблона структурированных цитат:

• В id могут использоваться только буквы латинского алфавита и цифры, разрешены тире и нижние подчёркивания; параметр чувствителен к регистру (например, id=QWER это не то же самое, что id=QWEr). Если вы присвоили новой цитате id уже существующей цитаты, то вы не сможете сохранить страницу с кодом шаблона.
• В параметрах speaker, receiver, attribution и source разрешены только вики-ссылки или несколько вики-ссылок, разделённых запятыми без пробелов. Вы не можете использовать обычный текст для этих параметров, но можете использовать ссылки на несозданные страницы.
• Шаблон будет работать, если заполнить только id и text, но шаблон всё равно отобразит текст цитаты и "-" ниже, поэтому добавление любого другого параметра, кроме текста цитаты, желательно. Либо вы можете отредактировать шаблон, чтобы удалить ненужные для вас параметры.
• Параметр receiver добавляет в текст вывода англ. предлог "to". Чтобы изменить это, отредактируйте исходный шаблон, заменив "to", например, на "к".
• Быстро добавлять синтаксис структурированных цитат на страницу можно, нажав "Дополнительно" на панели редактирования и далее кнопку .

Свой шаблон и существующие шаблоны цитат на вики

Вы можете свободно редактировать исходный шаблон структурированных цитат, не изменяя его исходные параметры. Это можно сделать, если вы хотите внести изменения в дизайн шаблона, в том числе, с помощью вики-текста, CSS, TemplateStyles, Lua и встроенных стилей, и/или добавить в шаблон новые параметры, например, иконки персонажей или смену фонового цвета. Однако новые параметры не будут внесены в базу данных (см. раздел "Список цитат").

Вы можете сделать так, что шаблон структурированных цитат будет использовать код уже существующих шаблонов вики. Для этого в параметр template нужно прописать название (без приставки Шаблон) существующего на вики шаблона. Однако в данный шаблон необходимо включить все или часть параметров исходного шаблона структурированных цитат. Например, заменить "текст" на "text" и "автор" на "speaker" и т.д. Чтобы это не затронуло цитаты, которые уже есть на вики, рекомендуем сделать дубликат текущего шаблона с другим названием. Однако при таком использовании шаблон структурированных цитат не будет считывать дополнительные параметры из вашего шаблона, поэтому более выгодно вносить правки в исходный шаблон структурированных цитат, а дополнительные шаблоны использовать для разного дизайна шаблона, если это необходимо.

Вызов цитаты на странице вики

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

{{#SQuoteGet:
|id=<уникальный идентификатор цитаты>
|template=<название шаблона (не обязательно, по умолчанию будет использован шаблон "StructuredQuote")>
}}

То есть, имея на вики множество цитат, вы можете использовать их повторно без необходимости каждый раз записывать полный текст шаблона, цитаты, авторов и пр.

Список цитат

Ещё одна функция структурированных цитат - простой вывод списка цитат с определённым параметром. Например, можно вывести цитаты от одного автора (speaker) или из одного источника, или от одного автора из конкретного источника. Для этого используется следующий синтаксис:

{{#SQuoteQuery:
|limit=<количество цитат на странице (если необходимо)>
|speaker=<чья цитата (ссылка или ссылки, разделённые запятыми)>
|receiver=<тот, к кому цитата обращена (ссылка или ссылки, разделённые запятыми)>
|attribution=<атрибуция, автор произведения (ссылка или ссылки, разделённые запятыми)>
|source=<источник цитаты (ссылка)>
|template=<название шаблона (не обязательно, по умолчанию будет использован шаблон "StructuredQuote")>
}}

Можно выводить списки, добавляя параметры, но нельзя исключать их. Например, можно вывести цитаты Персонажа1 из серии 22, когда он обращается к Персонажу2, но нельзя вывести цитаты Персонажа1 из серии 22, где он обращается к любому другому персонажу, кроме Персонажа2.

Если вы редактировали исходный шаблон структурированных цитат и добавляли в него новые параметры, эти параметры не будут внесены в базу данных и вы не сможете использовать их при выводе списка цитат. Например, если вы добавили параметр "файл" для иконок "злой" и "добрый" персонаж, вы не сможете с помощью "файл" в #SQuoteQuery вывести цитаты только злых или только добрых персонажей.

Советы

Как и в случае с любыми другими базами данных, структурированные цитаты выгодно использовать в том случае, когда у вас много цитат и вы регулярно используете их на страницах вашей вики. В связи в этим вот несколько советов по использованию структурированных цитат:

• Если в основе вашей вики лежит телесериал, фильмы, книги, то советуем для каждой серии, фильма, книги сделать подстраницу со списком цитат из них с помощью шаблона структурированных цитат. Вы можете использовать простые id для таких цитат. Например, 0504Naruto01 - цитата 01 Наруто из 5 серии четвёртого сезона, или SM3-2007-SpiderMan01 - цитата 01 Человека-паука из фильма "Человек-паук 3" 2007 года, и так далее. Затем на странице Наруто или Человека-паука вы можете вызывать любые цитаты из этих списков, если вам, например, нужно добавить цитату к разделу на странице, или вывести все цитаты персонажа на отдельной подстранице списком.
• Если основа вашей вики состоит из 1-3 источников, то можно все цитаты собрать на отдельной странице, а затем вызывать их на страницах персонажей и других страницах. Или собрать списки цитат для конкретных персонажей, а уже оттуда вызывать их на другие страницы вики.
• Структурированные цитаты интересно использовать для блока на Заглавной странице вики. Если у вас уже есть страницы с цитатами, вы можете легко поместить на Заглавную страницу несколько цитат одного персонажа, а в следующем месяце заменить их на цитаты другого персонажа.

Для создания собственного шаблона структурированных цитат вам нет необходимости редактировать исходный шаблон. Просто скопируйте параметры ниже, вставьте его вместо исходного шаблона и добавьте необходимый вики-текст.

:"''{{{text}}}''"
:— {{{speaker|speaker}}}{{#if:{{{receiver|}}}|, к {{{receiver|}}}}}{{#if:{{{attribution|}}}|, {{{attribution|}}}}}{{#if:{{{source|}}}|, {{{source|}}}}}