Шаблон: Blockquote

Документация по шаблону [ просмотреть ] [ изменить ] [ история ] [ очистить ]

Этот шаблон использует TemplateStyles : Шаблон: Blockquote / styles.css

Этот шаблон используется на 149 000+ страницах . Чтобы избежать серьезных сбоев и нагрузки на сервер, любые изменения следует тестировать на подстраницах / sandbox или / testcases шаблона или на собственной подстранице пользователя . Протестированные изменения могут быть добавлены на эту страницу одним редактированием. Обсудите изменения на странице обсуждения, прежде чем внедрять их. Счетчик включений обновляется автоматически ( см. Документацию ).

В Руководстве по стилю руководства по блоку цитат рекомендуются форматировать блоки цитаты с помощью шаблона или HTML < BLOCKQUOTE > элемента, для которого этого шаблон обеспечивает обертку.{{Blockquote}}

• Цитаты лучше всего работают с короткими предложениями, а также в начале или конце раздела, как намек на содержание раздела или для того, чтобы подчеркнуть его содержание.
• Для типичных цитат, особенно длинных, чем остальная часть абзаца, в котором они цитируются (только для использования вне поля статьи), предоставляются кавычки без полей с декоративными кавычками и цитаты с рамками . Оба занимают ширину страницы.{{Cquote}}{{Quote frame}}
• Для очень коротких цитат (с декоративными кавычками, только для использования вне поля статьи) или (в рамке) можно использовать для установки цитаты вправо или влево, как на боковой панели журнала . Это может быть эффективно на страницах сочинений и домашних страницах WikiProject .{{Rquote}}{{Quote box}}

использование

{{Blockquote}}добавляет цитату блока на страницу статьи.

Его легче вводить, и он больше похож на вики, чем эквивалентные HTML- теги, и имеет дополнительные предварительно отформатированные параметры атрибуции для автора и источника (хотя они обычно не используются в статьях; см. § Ссылки на ссылки ниже ).<blockquote>...</blockquote>

Примечание. Блочные кавычки обычно не содержат кавычек (см. MOS: BLOCKQUOTE ) .

Этот шаблон предназначен только для актуальных предложений. Не используйте его для блочного отступа другого материала; см. для этой цели.{{Block indent}}

Примеры

Основное использование:

{{Цитата| text = Цитируемый материал.}}

С указанием авторства:

{{Цитата| text = Цитируемый материал.| author = Первый М. Последний}}

С дополнительной атрибуцией:

{{Цитата| text = Цитируемый материал.| author = Первый М. Последний| title = "Название статьи"| source = '' Название книги '' (дата)}}

Пример с «многострочным»:

Особенно полезно для переведенных цитат; см. примечания к этому параметру .

• с "многострочным" Y

{{цитата | текст ={{lang | fr | Ceci n'est pas une pipe.}}Это не труба.| многострочный = да| author = [[Рене Магритт]]| title = [[Предательство изображений]]}}

• для сравнения без "многострочного" N

{{цитата | текст ={{lang | fr | Ceci n'est pas une pipe.}}Это не труба.| author = [[Рене Магритт]]| title = [[Предательство изображений]]}}

Яркий пример:

{{Blockquote | text = Кричите "Хаос" и отпустите псов войны. | Character = Марк Антоний | author = [[Уильям Шекспир]] | title = '' [[Юлий Цезарь (пьеса) | Юлий Цезарь]] ' ' | source = акт III, сцена I}}

Параметры

Список параметров

{{Цитата| текст =| автор =| title =| источник =| характер =| многострочный =| style =}}

См. Также раздел #TemplateData .

Цитируемый текст

|text=aka |1=- цитируемый материал без кавычек. Всегда безопаснее дать этому параметру имя (а не использовать безымянный позиционный параметр), потому что в противном случае любое включение неэкранированного символа «=» (например, в URL-адрес в исходной цитате) нарушит шаблон.

Отображаемая атрибуция

Эти параметры предназначены для отображения информации об авторстве под цитатой; это не следует путать со ссылкой на источник (см. § Ссылки на источники ниже) . Эти параметры являются полностью необязательными и обычно используются с известными цитатами, а не с обычными цитатами, которые обычно берутся в конце вводной строки непосредственно перед цитатой с помощью обычного тега.<ref>...</ref>

|author=aka |2=- необязательная информация об авторстве / спикере, которая будет отображаться под цитатой, перед которой будет стоять тире с указанием авторства.

|title=aka |3=- необязательное название работы, в которой фигурирует цитата, для отображения под цитатой. Этот параметр следует сразу за выводом |author=(и автоматически сгенерированной запятой), если таковая имеется. Он не выделяется автоматически курсивом. Основные произведения (книги, пьесы, альбомы, художественные фильмы и т. Д.) Должны быть выделены курсивом; второстепенные произведения (статьи, главы, стихи, песни, телепередачи и т. д.) заключаются в кавычки (см. MOS: TITLES ) . Дополнительная информация о цитировании может быть предоставлена ​​в четвертом параметре |source=, ниже, который появится после заголовка.

|source=он же |4=- необязательно использоваться для дополнительного источника информации для отображения, после того, как |title=, например , так: ; запятая будет автоматически сгенерирована между двумя параметрами. Если используется без , он просто действует как . (Этот параметр был добавлен в первую очередь для облегчения преобразования из-за неправильного использования шаблона цитаты для цитаты блока, но он может помочь в более чистой реализации метаданных позже.)|title="The Aerodynamics of Shaved Weasels" |source=''Perspectives on Mammal Barbering'', 2016|source=|title=|title={{Quote frame}}

|character=ака |char=- для приписывания вымышленной речи вымышленному персонажу с другой информацией для цитирования. Может также использоваться для приписывания реальной речи конкретному говорящему из многих, например, в стенограмме круглого стола / панели, интервью группы и т. Д. Этот параметр выводит «[ Имя персонажа ], in» после тире атрибуции и перед выводом параметры выше, поэтому один или несколько из этих параметров также должны быть указаны. Если вам нужно процитировать вымышленного докладчика в статье об одном художественном произведении, где повторение информации об авторе и заголовке будет избыточным, вы можете просто использовать |author=параметр вместо |character=.

Технически всю информацию о цитировании можно указать в одном параметре, например: Но это немного беспорядочно и будет препятствовать дальнейшим попыткам генерировать метаданные из цитирования, как мы уже делаем с ссылками на источники. Это гораздо удобнее:|source=Anonymous interview subject, in Jane G. Arthur, "The Aerodynamics of Shaved Weasels", ''Perspectives on Mammal Barbering'' (2016), Bram Xander Yojimbo (ed.)

| character = Тема анонимного интервью| author = Джейн Г. Артур| title = "Аэродинамика бритой ласки"| источник = '' Перспективы млекопитающим бритья '' (2016 г.), Брэй Xander Телохранитель (ред.)

Позднее развитие может назначить CSS classи так далее этим отдельным параметрам, с которыми скрипты смогут работать (например, для поиска вещей в WikiQuote).

Редко используемые технические параметры

• |multiline= - сохранять принудительные переносы строк в выводе.
  

Примечания:

• • Будет применяться только тогда , когда по крайней мере , один из этих параметров или его псевдонимы не является пустым ( в том числе неявных, безымянных параметров):
    |author=, |title=, |source=, или |character=.
  • Значение не имеет значения, пока оно не пустое. Настоятельно рекомендуется использовать так называемый параметр разговора (например, trueили yes). Избегайте значений, которые могут удивить пользователей (например, falseили no).
• |style=- позволяет указать дополнительные стили CSS ( не классы) для применения к элементу. (См. # Вложенные цитаты ниже, где описан наиболее распространенный вариант использования.)<blockquote>...</blockquote>

Ссылки цитаты

Ссылка цитата может быть помещена перед цитатой, после цитаты, или в |source=параметре:

Пожалуйста, не помещайте цитату в параметр |author=или отдельно |source=, так как это приведет к бессмысленной строке атрибуции, которая выглядит примерно так:
     -  ^[1]
Пожалуйста, также не помещайте ее за пределами шаблона {{blockquote}} , так как это вызовет :
     ^[1]
в отдельной строке.

Ограничения

Если вы не предоставите текст, шаблон генерирует сообщение об ошибке парсера, которое будет отображаться красным текстом на отображаемой странице.

Если фактическое значение какого-либо параметра содержит знак равенства ( =), необходимо использовать именованный параметр (например , не позиционный параметр с пустым именем. В противном случае текст перед знаком равенства неверно интерпретируется как именованный параметр. Остерегайтесь URL-адресов, которые часто содержат этот символ. Именованные параметры всегда безопаснее, в этом и других шаблонах.|text="E=MC2" is a formula everyone knows but few understand

Если фактическое значение любого параметра содержит символы , используемые для вики разметки синтаксиса (например, трубы , скобки , одиночные кавычки и т.д.), вам может понадобиться , чтобы избежать его. Смотрите и друзья.{{!}}

Рядом с плавающими вправо ящиками

По состоянию на сентябрь 2015 года ^{[Обновить]}текст цитаты блока может редко переполнять (в Firefox или других браузерах Gecko) элемент, перемещаемый вправо (например, прямоугольник, когда этот элемент находится ниже другого элемента фиксированного размера, более узкого, плавающего вправо. В Safari и других браузерах Webkit (и еще реже в Chrome / Chromium) одно и то же условие может привести к смещению цитаты блока вниз. Обе эти проблемы можно устранить одним из следующих способов:{{Listen}}

1. удаление размера верхнего элемента и разрешение ему использовать его размер по умолчанию (например, удаление размера или с плавающего вправо изображения над более широким плавающим вправо объектом, который переполняется текстом цитаты; или###x###px|upright=
2. используя в шаблоне предложения.|style=overflow:inherit;

Могут быть другие решения, и будущие обновления браузера могут устранить проблему. Это вообще происходит из-за объявления CSS в Mediawiki: Common.css , которое само работает для решения других, более распространенных проблем с отображением. Решение, которое устраняет все проблемы, в настоящее время неизвестно.blockquote {overflow: hidden;}

Исчезающие цитаты

В редких случаях макета, например, когда кавычки зажаты между пользовательскими ящиками, в некоторых браузерах цитата может не отображаться. Чтобы решить эту проблему, добавьте к такому экземпляру шаблона.|style=overflow:inherit;

Разрывы строк

Этот шаблон устанавливает стиль текста, который может игнорировать одну пустую строку, поэтому шаблон должен заканчиваться разрывом (новой строкой), иначе следующая пустая строка может быть проигнорирована. В противном случае будьте осторожны при вставке:
     текст здесь {{blockquote | this is quoted}} Больше текста здесь
занимает пустую строку, если {{blockquote | ...}} не заканчивается разрывом строки, тогда следующая пустая строка может игнорировать и соединять два абзаца.

(Этот раздел включен из абзацев Template: Blockquote )

Элемент и все шаблоны , которые используют его не соблюдают новые строки:<blockquote>

< цитата >Строка 1Строка 2Строка 3Строка 4</ blockquote >

Простое решение - использовать шаблон {{ poem quote }} вместо <blockquote>...</blockquote>. Фактически это то же самое, что использовать тег внутри , который преобразует разрывы строк в теги:<poem><blockquote><br />

< цитата > < стихотворение >Строка 1Строка 2Строка 3Строка 4</ poem > </ blockquote >

Для разметки фактических абзацев внутри цитат блока можно использовать целые пустые строки между ними, которые будут преобразованы в теги:<p>...</p>

< цитата >Пункт 1Пункт 2Пункт 3</ blockquote >

Обратите внимание, что может потребоваться поставить разрыв строки в вики-тексте перед <blockquote> и после </blockquote>, чтобы абзацы отображались с предполагаемым разделением. (Это также упрощает чтение вики-текста.)

Этот стиль абзаца также работает с {{ blockquote }}, который заменяет его <blockquote>, также имеет параметры, чтобы сделать форматирование атрибуции более удобным и последовательным.

Цитата и шаблоны, которые ее вызывают и имеют отступ с двоеточия (:), помечены звездочкой (*) или пронумерованы цифрой (#), будут генерировать ошибки и некорректно отображать что-либо после символа новой строки.

: < blockquote > Параграф 1Пункт 2 </ blockquote >

* < цитата > Параграф 1Пункт 2 </ blockquote >

# < blockquote > Параграф 1Пункт 2 </ blockquote >

Вложенные цитаты

У элемента есть стили, изменяющие размер шрифта: на рабочем столе текст меньше; на мобильном телефоне он больше. Это изменение относится к охватывающему контексту, а это означает, что если вы цитируете источник, который сам использует блочную цитату, вы обнаружите, что внутренняя цитата либо очень крошечная и ее трудно читать, либо очень большая и едва умещается на экране. . Чтобы решить эту проблему, добавьте параметр во все внутренние шаблоны {{blockquote}} .<blockquote>...</blockquote>|style=font-size:inherit;

Технические проблемы с шаблонами блоков

Если содержание блока отформатирован начинается со списком (или любой другой WikiMarkup, которая зависит от характера конкретных разметки остающейся в начале строки) , то из - за ошибки в MediaWiki , должен существовать перед списком (или любой другой ) начинается . Сравнивать:<nowiki />

 {{Цитата | 1 = *Во-первых, ... *Во-вторых, ... *В-третьих, ... }}

Чтобы встроить таблицу в подобную разметку блока, параметр содержимого шаблона блока должен быть назван или пронумерован и включать самозакрывающийся noinclude - как в |1=<nowiki />- тогда каждый |символ в разметке таблицы должен быть экранирован . В качестве альтернативы можно использовать явное HTML , , и разметку.{{!}}<table><tr><th><td>

Ошибки

Страницы, на которых этот шаблон используется некорректно, неправильно заполняют Категория: Страницы с использованием шаблона цитаты . Категория отслеживает включения шаблона: цитата , в которых нет текста для цитаты или используется знак равенства в аргументе безымянного параметра. Он также отслеживает использование |class=, |id=, |diff=, |4=, или |5=.

Категория отслеживания

Статьи, использующие неподдерживаемые параметры, помещаются в Категория: Страницы с использованием шаблона цитаты с неизвестными параметрами  (10).

TemplateData