Справка:Примечания и сноски
|
Эта страница является частью руководств Традиции. Рекомендуется следовать изложенным здесь правилам. Если есть сомнения, изложите их на странице обсуждения. |
| ||
|---|---|---|
| Тематические статьи | ||
| Техническая справка | ||
Тэги MediaWiki: | ||
| Общие правила | ||
Данный документ является развитой и традифицированной копией аналогичного документа из русского раздела Википедии.
Сноски[править код]
Сноска — это примечание, размещаемое внизу страницы документа, которое является комментарием к какому-либо месту основного текста. Причина вынесения таких комментариев из основного текста состоит в том, чтобы не перегружать его чрезмерными подробностями, не затруднять излишними отступлениями плавность течения его прозы. Связь между основным текстом и сноскою часто показывается цифрою (числом) или каким-либо значком (скажем, звёздочкою или несколькими звёздочками), которые одинаково ставятся и после фрагмента текста, и перед сноской.
Сноски нередко применяются для размещения текста, который, будучи вставленным в основной текст, мог бы отвлечь от основного предмета, но имеет ценность в объяснении какой-либо подробности. Сноски также часто используются для приведения сведений об источниках, ссылок на источники, которые цитируются в основном тексте или на которых основаны утверждения, излагаемые в основном тексте. Такое цитирование источников и приведение ссылок на источники важно для поддержки проверяемости информации, а проверяемость является основной причиной доверия читателя к любой энциклопедии. («Доверяй, но проверяй».)
Следует отметить, что часть содержания сноски со ссылкой на источник может не отражать позицию автора статьи по какому-либо вопросу; так, автор, сомневающийся в «фальшивости» Протоколов Сионских мудрецов, может по какому-то постороннему вопросу давать ссылки на противоположные источники вроде:
Кон Н. Благословение на геноцид. Миф о всемирном заговоре евреев и «Протоколах сионских мудрецов» / Пер. с англ. С. С. Бычкова; общ. ред. и послесл. Т. А. Карасовой, Д. А. Черняховского. — М.: Прогресс, 1990.
Следует также отметить, что сноска на источник может нести дополнительную функцию «ключа», то есть указывать автору статьи или читателю на иную любопытную информацию, сопутствующую тезису, к которому она приведена, а это означает, что не следует чураться проставления сразу нескольких сносок даже к тривиальным, общеизвестным утверждениям.
В механизме MediaWiki существует встроенная поддержка сносок. Сноски можно создавать в статье, используя теги <ref>, и эта страница расскажет вам (чуть ниже) об их использовании. Такой способ добавления сносок иногда называется «сноски через cite.php», поскольку cite.php — имя файла расширения MediaWiki, обеспечивающего эту возможность.
Нижеописанным способом можно вставлять текст сноски прямо в то место статьи, которое на него должно ссылаться, а в указанном месте статьи (обычно внизу её) автоматически выводить список всех сносок с обратными гиперссылками, ведущими к основному тексту статьи.
Использование[править код]
Определение сносок в месте сноски[править код]
Текст сноски записывается в том месте основного текста, сноскою к которому он является. В вики-коде статьи текст сноски следует заключать между тегами разметки <ref> (открывающим) и </ref> (закрывающим).
При отображении статьи на этом месте появится значок (номер) сноски. Сам же текст сноски появится под этим номером в списке сносок, который следует отдельно создать (тегом <references />) где-нибудь ниже (как правило, в конце статьи).
Если же вы забудете вставить тег <references />, то тексты всех сносок будут выведены в конце статьи.
Определение сносок в разделе сносок[править код]
Альтернативный способ задания сносок, полезный при импорте текстов из не-вики-источников заключается в том, что именованная сноска без содержимого ставится в месте сноски, а её определение — внутри тега <references>:
По данным науки, Солнце большое.<ref name="sun" /> А вот Луна не такая большая.<ref name="moon" /> == Примечания ==
<references> <ref name="sun">Иванов И. И. Солнце. — М.: Наука, 2005, с. 23.</ref> <ref name="moon">Сидоров В. В. Размер Луны. — Наука и жизнь, 1973, №5.</ref> </references>
Всплывающие подсказки[править код]
Энциклопедия «Традиция» автоматически показывает сноски не только в списке сносок, появляющемся на месте тега <references />, но также и во всплывающих подсказках, появляющихся при наведении курсора мыши на значок сноски, имеющийся в основном тексте (на месте тега <ref>...</ref>).
Эта вспомогательная функция весьма полезна: она может избавить читателя от необходимости переходить по гиперссылкам (проматывать страницу) к списку сносок и затем обратно к основному тексту статьи.
Наличие подсказок, однако, не может совершенно подменить собою тег <references /> и соответствующий список сносок; тому есть ряд причин, каждая из которых достаточно значительна:
- Всплывающие подсказки появляются по одной, появляются только в ответ на действия пользователя, появляются поверх основного текста статьи. Поэтому они не могут быть распечатаны (а если бы и могли, то закрывали бы куски основного текста статьи). Для читателей, использующих статьи Традиции в распечатанном виде, необходим список сносок.
- Если средство чтения не оборудовано мышью, то курсор мыши не может быть наведён на значок сноски. Это касается сенсорных экранов, которыми оборудованы многие мобильники и планшетные компьютеры: указательные устройства в них отсутствуют, и на гиперссылку нельзя навестись, а можно только ткнуть её пальцем или стилусом. Для читателей, использующих такие средства чтения, необходим список сносок.
- Реакция на наведение мыши описана на языке JavaScript. Она не сработает у тех читателей, которые сознательно отключили обработку джаваскриптов с целью избавления читаемых ими страниц Всемирной Паутины от активного содержимого. Она не сработает и у тех читателей, браузеры которых не способны воспринимать JavaScript в силу своих конструктивных особенностей (таковы, например, браузеры многих дешёвых мобильников, не располагающих значительными вычислительными ресурсами, а также браузер Arachne, рассчитанный на употребление на стародавних компьютерах, предшествовавших появлению «Пентиумов»). Такие читатели не обойдутся без списка сносок.
С учётом вышеизложенных соображений средство показа всплывающих подсказок, используемое в Традиции, было (для простоты, а также и для ускорения работы) устроено таким образом, что оно не занимается самостоятельной обработкой кода сноски, взятого из исходного кода статьи в Традиции, а попросту копирует отображение сноски, имеющееся в списке сносок. Следовательно, при отсутствии тега <references /> не будет ни списка сносок, ни всплывающих подсказок.
Как выглядит сноска[править код]
Эта страница и сама использует сноски — например, в конце этого предложения.[1]
Наведясь мышью на символ (номер) этой сноски, вы увидите пример всплывающей подсказки, если JavaScript у вас работает.
Просмотр исходного текста раздела «Как выглядит сноска» (открывающийся по гиперссылке «править» возле его заголовка) откроет вам действующий пример исходного кода простой сноски. Аналогичный пример (а также более сложные примеры) вы увидите далее в раскрашенном виде, облегчающем понимание.
Пример кода сносок[править код]
По данным науки, Солнце большое.<ref>Иванов И. И. Солнце. — М.: Наука, 2005, с. 23.</ref>
А вот Луна не такая большая.<ref>Сидоров В. В. Размер Луны. — Наука и жизнь, 1973, №5.</ref>
== Примечания ==
<references />
В случаях, когда список примечаний становится слишком длинным, можно использовать уменьшенный размер шрифта для сносок:
== Примечания ==
<div class="references-small">
<references />
</div>
Для этой цели можно использовать и шаблон {{примечания}}, с помощью которого также можно разбивать список примечаний на несколько столбцов (см. документацию к шаблону).
== Примечания ==
{{примечания}}
Если же примечаниям не нужен уменьшенный шрифт, используйте простой шаблон {{примечания в два столбца}}: он разделит список примечаний на два столбца, не привнося никаких других изменений внешнего вида.
== Примечания ==
{{примечания в два столбца}}
Повторное использование одной и той же сноски[править код]
Чтобы дать сноске уникальное имя, используйте тег <ref name="имя">. Это позволит вдругорядь ссылаться на ту же сноску по мере нужды, используя тег <ref name="..."> с тем же именем.
Текст внутри тега повторной (одноимённой) сноски не имеет никакого значения, поскольку текст этой сноски ужé был задан в первом теге этой сноски. Вы можете или скопировать всю сноску, или использовать другой текст (он будет проигнорирован и заменён на текст первой сноски с тем же именем), или использовать пустой тег <ref name="имя" /> для компактности.
В следующем примере одно и то же имя сноски используется три раза, и сноски получатся одинаковыми:
Это пример многократных ссылок на одну и ту же сноску.<ref name="multiple">Помните, что когда вы ссылаетесь на одну и ту же сноску несколько раз, используется текст из первой ссылки.</ref>
Такие ссылки полезны, например, для приведения разных цитат из одного и того же источника.<ref name="multiple">Этот текст — лишний, и нигде не будет показан. С тем же успехом можно было использовать пустой тег.</ref>
Краткий способ делать многократные ссылки — использовать пустые теги ref со слэшем в конце.<ref name="multiple" />
== Примечания ==
<references />
А вот так этот пример будет выглядеть в статье (см. также список сносок в конце страницы):
Это пример многократных ссылок на одну и ту же сноску.[2]
Такие ссылки полезны, например, для приведения разных цитат из одного и того же источника.[2]
Краткий способ делать многократные ссылки — использовать пустые теги ref со слэшем в конце.[2]
Рекомендации по размещению сносок[править код]
- Так как обозначение сноски состоит минимум из трёх символов (число и две квадратные скобки вокруг него), то оно создаёт под собой что-то вроде пробела. Поэтому[3] разумно ставить сноску непосредственно перед ужé существующим пробелом, следующим за той частью основного текста, которую сноска комментирует.
- Если та часть основного текста, которую сноска комментирует, стоит в сáмом конце абзаца, тогда уместно ставить сноску непосредственно перед концом абзаца.
- Если за той частью основного текста, которую сноска комментирует, стоит тире, тогда уместно ставить сноску непосредственно перед пробелом, предшествующим этому тире.
- Если та часть основного текста, которую сноска комментирует, стоит в скобках, тогда можно ставить сноску либо перед закрывающей скобкою (если это не создаст чрезмерного отступа перед скобкою), либо непосредственно перед первым же пробелом, после закрывающей скобки попавшимся (если это не создаст ненужных сомнений в том, относится ли сноска только к тексту внутри скобок или же к более обширной предшествующей части текста).
- Если за той частью основного текста, которую сноска комментирует, стоит перед пробелом некоторый знак препинания (вопросительный знак, восклицательный знак, точка, запятая, двоеточие, многоточие, закрывающая кавычка), тогда уместно ставить сноску непосредственно перед пробелом (после знаков препинания), чтобы сперва явствовала интонация основного текста, и лишь потóм явствовало наличие примечания к нему.[4]
- Если сноска стоит после запятой, то уместно искусственно уменьшить отступ от запятой, чтобы обозначение сноски встало над запятою,[5] встало ближе к предшествующему слову. Для этого заключите такую запятую в двойные фигурные скобки (то есть, иными словами, используйте шаблон
{{,}}вместо запятой).
- Если сноска стоит после точки, то уместно искусственно уменьшить отступ от точки, чтобы обозначение сноски встало над точкою, встало ближе к предшествующему слову.[6] Для этого замените такую точку на шаблон
{{тчк}}(в качестве имени шаблона приходится использовать телеграфный код «тчк» вместо простой точки: механизм шаблонов позволяет создать шаблон с именем, состоящим из запятой, как в предыдущем случае, но не позволяет создать шаблон с именем, состоящим из точки).
- Если сноска стоит после многоточия, то уместно искусственно уменьшить отступ от многоточия, чтобы обозначение сноски встало над многоточием, встало ближе к предшествующему слову...[7] Для этого замените такое многоточие на шаблон
{{мнгт}}(в качестве имени шаблона приходится использовать телеграфный код по тем же причинам, что и в случае с {{тчк}}). Для той же цели может использоваться шаблон-синоним {{…}} (но обязательно обратите внимание, что названием этого шаблона является символ многоточия, а не три подряд стоящих символа точки).
- Если автоматический перенос текста на новую строку может оторвать обозначение сноски от той предшествующей части основного текста, которую сноска комментирует, или от последующей скобки или тире, тогда уместно использовать шаблон {{nobr}}, который обеспечит неразрывность фрагмента основного текста (включающего обозначение сноски), если этот фрагмент сделать первым параметром этого шаблона:[8]
По сведениям литературы, человек смертен (и даже подчас внезапно смертен, вот в чём {{nobr|1=фокус!<ref>Булгаков М. А. Мастер и Маргарита.</ref>) —}} а вот насчёт вампиров это не столь {{nobr|1=достоверно{{тчк}}<ref>Аббат Кальне. Трактат о явлениях духов. 1698 г.</ref>}}
- В тексте между <ref> и </ref> можно использовать шаблоны, предназначенные для форматирования библиографических ссылок, см. Традиция:Шаблоны/Библиография. Однако, если вам проще набрать ссылку без такого шаблона, можете его не использовать.
Группировка сносок[править код]
В тег <ref> можно добавить параметр group: <ref group="N">...</ref>.
Тогда сноска будет показана в группе «N», выводящейся элементом <references group="N" />.
Технические ограничения[править код]
- Внутри сносок не работают викиссылки вида [[Название (область знаний)|]].
- Сноски нельзя вставлять внутри тегов <displaymap>, <displaypoint> и <displaypoints>.
- Чтобы отредактировать сноску, следует редактировать соответствующий раздел основного текста статьи (а не тот раздел примечаний, где сноски показываются всем скопом).
- Чтобы во время редактирования сноски использовать предварительный просмотр изменений, придётся использовать редактирование и предварительный просмотр всей статьи сразу (редактирование одного раздела основного текста не обеспечивает предпросмотра сносок, когда и поскольку сноски отображаются не в нём, а в другом разделе внизу).
- Расширение
cite.phpне является обязательной компонентою механизма MediaWiki, поэтому содержимое Традиции, будучи перенесено в другие вики, может там заместо сносок отображать сырой код с тегами <ref> до тех пор, пока расширениеcite.phpне будет установлено в те вики.
Как это работает?[править код]
Технические пояснения к шаблону см. на странице mw:Extension:Cite/Cite.php
Примечания[править код]
- ↑ Эта сноска является примером к подразделу «Как выглядит сноска».
- ↑ а б в Помните, что когда вы ссылаетесь на одну и ту же сноску несколько раз, используется текст из первой ссылки. Ошибка цитирования Неверный тег
<ref>: название «multiple» определено несколько раз для различного содержимого - ↑ Как ужé сказано выше, целью применения сносок является сбережение неразрывности течения прозы основного текста, поэтому недопустимо разрывать её абы где.
- ↑ Как ужé сказано выше, целью применения сносок является сбережение неразрывности течения прозы основного текста, поэтому и нарушение целостности интонаций её недопустимо.
- ↑ Это пример сноски, обозначение которой стоит над запятою, стоит ближе к предшествующему слову.
- ↑ Это пример сноски, обозначение которой стоит над точкою, стоит ближе к предшествующему слову.
- ↑ Это пример сноски, обозначение которой стоит над многоточием, стоит ближе к предшествующему слову.
- ↑ У шаблона {{nobr}} первый параметр в данном случае уместно нумеровать явно («1=»), а не то первый параметр останется пустым, если в его предполагаемом тексте (довольно обширном в случае сноски) нежданно встретится знак равенства (например, как часть вызова другого шаблона). Подробнее об этом см. Справка:Механизм шаблонов#Неопределённые и пустые параметры. Также обратите внимание, как внутри второго шаблона {{nobr}} применяется шаблон {{тчк}}, описанный выше. Это пример для подражания.