Шаблон:Coquote/Документация

Материал из свободной русской энциклопедии «Традиция»
Перейти к навигации Перейти к поиску

Шаблон {{coquote}} предназначен в первую очередь для компактного размещения цитаты отдельным абзацем с указанием источника на языке оригинала (или без такового). Целью создания шаблона была компактность и максимальная гибкость применения. Практически все параметры (цвет фона, рамки, отступы и т. п.) могут быть настроены стандартными средствами.

Быстрый старт[править код]

Начните использовать шаблон просто указав цитируемый текст:

{{coquote|О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.}}


Quote.png
О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.


В случае необходимости добавьте автора:

{{coquote|О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.|[[Григорий Сковорода]]}}


Quote.png
О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.
Григорий Сковорода


Приведите версию на оригинальном языке и его код:

{{coquote|О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.|[[Григорий Сковорода]]
|Подяка блаженному Богові за те, що потрібне зробив нетрудним, а трудне — непотрібним.|uk}}


Quote.png
О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.
Григорий Сковорода
 


Закройте кавычки и центрируйте текст:

{{coquote|О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.|[[Григорий Сковорода]]
|Подяка блаженному Богові за те, що потрібне зробив нетрудним, а трудне — непотрібним.|uk|1|1}}


Quote.png
О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.
Quote background transparent (dark).png
Григорий Сковорода
 


Уберите что-нибудь ненужное:

{{coquote|О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.|[[Григорий Сковорода]]|||1|1}}


Quote.png
О Господи! Благодарю Тебя за то, что Ты сделал все нужное простым, а все сложное ненужным.
Quote background transparent (dark).png
Григорий Сковорода


Заготовки для быстрой вставки[править код]

Стандартный вариант[править код]

Все варианты использования эквивалентны, выберите удобный для вас.

Английский Русский Цифры Позиция
{{coquote
 |text             = 
 |source           = 
 |original-text    = 
 |original-lang    = 
}}
{{coquote
 |текст            = 
 |источник         = 
 |оригинал         = 
 |язык             = 
}}
{{coquote
 |1 = 
 |2 = 
 |3 = 
 |4 = 
}}
{{coquote
|текст
|источник
|оригинал
|язык
}}
{{coquote|text=|source=|original-text=|original-lang=}}
{{coquote|текст=|источник=|оригинал=|язык=}}
{{coquote|1=|2=|3=|4=}}
{{coquote|текст|источник|оригинал|язык}}

Расширенный вариант[править код]

В расширенном варианте для удобства копирования предустановлены закрывающиеся скобки (bq, закрыть, 5; по мнению некоторых участников так правильно и красиво) и центрирование текста (center, центр, 6; удобно для коротких цитат). В случае отсутствия необходимости эти поля можно удалить.

Английский Русский
{{coquote
 |text             = 
 |source           = 
 |original-text    = 
 |original-lang    = 
 |bq               = yes
 |center           = yes
}}
{{coquote
 |текст            = 
 |источник         = 
 |оригинал         = 
 |язык             = 
 |закрыть          = да
 |центр            = да
}}
{{coquote|text=|source=|original-text=|original-lang=|bq=yes|center=yes}}
{{coquote|текст=|источник=|оригинал=|язык=|закрыть=да|центр=да}}
Цифры Позиция
{{coquote
 |1 = 
 |2 = 
 |3 = 
 |4 = 
 |5 = 5
 |6 = 6
}}
{{coquote
|текст
|источник
|оригинал
|язык
|1
|1
}}
{{coquote|1=|2=|3=|4=|5=5|6=6}}
{{coquote|текст|источник|оригинал|язык|1|1}}

Полный вариант[править код]

В полном варианте можно произвольным образом заменять названия полей на русские или соответствующие цифры, как описано выше.

{{coquote
 |background-color = 
 |border           = 
 |margin-left      = 
 |padding          = 
 |text             = 
 |source           = 
 |original-text    = 
 |original-source  = 
 |original-lang    = 
 |bq               =
 |center           =
}}

Использование шаблона[править код]

Стандартное использование шаблона[править код]

Если вы хотите разместить в тексте статьи цитату со ссылкой на источник и оригинальной версией используйте следующий формат:

{{coquote
 |text             = В этом поле размещается текст цитаты на русском языке. Единственное обязательное поле.
 |source           = Сюда помещается имя автора, наименование источник и прочая исходная информация на русском языке. Необязательное поле.
 |original-text    = Используйте это поле для текста цитаты на языке оригинала. Необязательное поле.
 |original-source  = Поле, для указания информации об источнике на языке оригинала. Необязательное поле.
 |original-lang    = Код ISO 639-1 (2002) для языка. Обязательное поле при указании оригинального текста.
}}

Например, если вы используете шаблон подобным образом:

{{coquote
 |text             = Мы — анонимы. Имя нам — легион. Мы не прощаем. Мы не забываем. Ждите нас.
 |source           = &nbsp;&nbsp;[[Хакер (журнал)]], 11 июля 2011 года<ref name="xakep.ru">[http://www.xakep.ru/post/57422/ Имя нам — легион: Анонимус не прощает] // [[Хакер (журнал)]]. 11.06.2011.</ref>.
 |original-text    = We are Anonymous. We are Legion. We do not forgive. We do not forget. Expect us.
 |original-source  = &nbsp;&nbsp;''Yale Law and Technology'', 
Nov, 2 2009<ref name="yalelawtech.org">[http://www.yalelawtech.org/anonymity-online-identity/we-are-anonymous-we-are-legion/ We Are Anonymous, We Are Legion],
''Yale Law and Technology'', November 9, 2009</ref>.
 |original-lang    = en
}}

В статье появится:

Quote.png
Мы — анонимы. Имя нам — легион. Мы не прощаем. Мы не забываем. Ждите нас.
 — Хакер (журнал), 11 июля 2011 года[1].
 

Использование закрывающихся кавычек[править код]

Для появления закрывающихся кавычек используйте свойство bq с любым значением. Например, bq = 1 или bq=yes.

Пример:

{{coquote
|text = Когда я был ребёнком, казалось, что у меня нет никакого будущего. Политическое происхождение моей семьи было хуже некуда: мой отец и оба его старших брата были гоминьдановскими офицерами, [выпускниками] Академии Ванпу. Во время „[[Культурная революция в Китае|культурной революции]]“ мой отец был заклеймён как гнуснейший тип контрреволюционера — „двойной контрреволюционер“, это значило, что он был контрреволюционером в прошлом и остаётся им в настоящем. Такие люди, как он, были главными мишенями политических кампаний… . В то время у меня не было каких-либо надежд, я жил в мире полном отчаяния.
|original-text = When I was a child, it seemed as if there was really no future for me. I had a bad family background because my father and his two older brothers had all been Nationalist officers at the Huangpu Military Academy. So our family's political background was especially bad. During the Cultural Revolution my father was labeled the worst kind of counterrevolutionary—a "double counterrevolutionary," which meant he was both a historical counterrevolutionary (lishi fangeming) and an acting counterrevolutionary (xianxingfangeming). The crime of being an acting counterrevolutionary was especially serious. People like him were the principal targets of political oppression. So during the Cultural Revolution our entire family found itself in terrible straits. That era is filled with tragic memories of having our house ransacked and being sent to the countryside for reeducation. For me, that was an era without hope — I lived in a world of desperation. 
|original-lang = en
|bq=1
}}

В статье появится:

Quote.png
Когда я был ребёнком, казалось, что у меня нет никакого будущего. Политическое происхождение моей семьи было хуже некуда: мой отец и оба его старших брата были гоминьдановскими офицерами, [выпускниками] Академии Ванпу. Во время „культурной революции“ мой отец был заклеймён как гнуснейший тип контрреволюционера — „двойной контрреволюционер“, это значило, что он был контрреволюционером в прошлом и остаётся им в настоящем. Такие люди, как он, были главными мишенями политических кампаний… . В то время у меня не было каких-либо надежд, я жил в мире полном отчаяния.
Quote background transparent (dark).png


Использование центрирования[править код]

Если вы хотите привести короткую цитату, эстетичней её разместить по центру (необходимо указать любое значение в поле center или центр или 6). В этом случае закрывающие скобки также настоятельно рекомендуются (необходимо указать любое значение в поле bq или закрыть или 5).

Пример:

{{сoquote|text=''Знание — сила!''|source=[[Френсис Бэкон]]|bq=yes|center=yes}}


Quote.png
Знание — сила!
Quote background transparent (dark).png
Френсис Бэкон

или:

{{coquote|текст=''Знание — сила!''|источник=[[Френсис Бэкон]]|закрыть=да|центр=да}}


Quote.png
Знание — сила!
Quote background transparent (dark).png
Френсис Бэкон

Полнофункциональное использование шаблона[править код]

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

{{coquote
 |background-color = Поле для указания цвета фона.
 |border           = Поле для определения рамок.
 |margin-left      = Отступ от левого края.
 |padding          = Отступы между рамкой и внутренним текстом.
 |text             = В этом поле размещается текст цитаты на русском языке. Единственное обязательное поле.
 |source           = Сюда помещается имя автора, наименование источник и прочая исходная информация на русском языке. Необязательное поле.
 |original-text    = Используйте это поле для текста цитаты на языке оригинала. Необязательное поле.
 |original-source  = Поле, для указания информации об источнике на языке оригинала. Необязательное поле.
 |original-lang    = Код ISO 639-1 (2002) для языка. Обязательное поле при указании оригинального текста.
 |bq               = Признак, указывающий на необходимость закрывающихся кавычек (любое ненулевое значение). Необязательное поле.
 |center           = Признак, указывающий на необходимость центрирования текста (любое ненулевое значение). Необязательное поле.
}}

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

Например, для подобного использования:

{{coquote
 |background-color = yellow
 |border           = solid red 2px
 |margin-left      = 20em
 |padding          = 10px 20px 30px 40px
 |text             = '''Мы — анонимы. Имя нам — легион. Мы не прощаем. Мы не забываем. Ждите нас.'''
 |source           = &nbsp;&nbsp;[[Хакер (журнал)]], 11 июля 2011 года<ref name="xakep.ru" />.
 |original-text    = ''We are Anonymous. We are Legion. We do not forgive. We do not forget. Expect us.''
 |original-source  = &nbsp;&nbsp;''Yale Law and Technology'', Nov, 2 2009<ref name="yalelawtech.org" />.
 |original-lang    = en
}}

вы получите следующий условно безобразный результат:

Quote.png
Мы — анонимы. Имя нам — легион. Мы не прощаем. Мы не забываем. Ждите нас.
 — Хакер (журнал), 11 июля 2011 года[1].
 

Дополнительные замечания[править код]

  • Вы можете выделять или не выделять кавычками цитату в поле text по своему усмотрению. В общем случае, при графическом оформлении цитаты, такое выделение не требуется.
  • Во всех полях шаблона, предусматривающих текстовый ввод (text, source, original-text, original-source) допустимо использование любых стандартных элементов вики-разметки (полужирное и курсивное начертание, списки, сноски, вложенные шаблоны и т. п.) и HTML тегов (<div>, <span> и т. п.).
  • В общем случае, предпочтительным следует признать стиль, когда цитата вводится предыдущим предложением («как сказал тот-то там-то тогда-то»). В подобном случае, поля source и original-source можно не использовать или использовать избирательно.

Встроенная помощь[править код]

Если вы забыли, как использовать шаблон, просто включите его в страницу: {{coquote}}

Ссылка на страницу документации будет выведена автоматически:

Quote.png
См. помощь по использованию шаблона на странице {{coquote}}.

Песочница для тестирования[править код]

Вы можете экспериментировать с использованием шаблона {{coquote}} в специально созданной для этих целей песочнице: Шаблон:Coquote/test.

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

См. также[править код]

  • Пара типовых шаблонов {{начало цитаты}} / {{конец цитаты}}. Допускают возможность вставки оригинального текста с помощью шаблона {{oq}}.
  • {{cquote}} — шаблон цитаты, который часто используется в иноязычных разделах.
  • {{oq}} — переведённая цитата с оригиналом.

Примечания[править код]