Справка:Примечания и сноски

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

КДП

Написание статей

Тематические статьи

Техническая справка

Тэги MediaWiki:

Функции парсера:

Lua (LPeg и Re, cosmo)

Функции Lua:

Общие правила

Список правил и руководств Справка

Данный документ является развитой и традифицированной копией аналогичного документа из русского раздела Википедии.

СноскиПравить

Сноска — это примечание, размещаемое внизу страницы документа, которое является комментарием к какому-либо месту основного текста. Причина вынесения таких комментариев из основного текста состоит в том, чтобы не перегружать его чрезмерными подробностями, не затруднять излишними отступлениями плавность течения его прозы. Связь между основным текстом и сноскою часто показывается цифрою (числом) или каким-либо значком (скажем, звёздочкою или несколькими звёздочками), которые одинаково ставятся и после фрагмента текста, и перед сноской.

Сноски нередко применяются для размещения текста, который, будучи вставленным в основной текст, мог бы отвлечь от основного предмета, но имеет ценность в объяснении какой-либо подробности. Сноски также часто используются для приведения сведений об источниках, ссылок на источники, которые цитируются в основном тексте или на которых основаны утверждения, излагаемые в основном тексте. Такое цитирование источников и приведение ссылок на источники важно для поддержки проверяемости информации, а проверяемость является основной причиной доверия читателя к любой энциклопедии. («Доверяй, но проверяй».)

Следует отметить, что часть содержания сноски со ссылкой на источник может не отражать позицию автора статьи по какому-либо вопросу; так, автор, сомневающийся в «фальшивости» Протоколов Сионских мудрецов, может по какому-то постороннему вопросу давать ссылки на противоположные источники вроде:

Кон Н. Благословение на геноцид. Миф о всемирном заговоре евреев и «Протоколах сионских мудрецов» / Пер. с англ. С. С. Бычкова; общ. ред. и послесл. Т. А. Карасовой, Д. А. Черняховского. — М.: Прогресс, 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]

Группировка сносокПравить

В тег <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}} применяется шаблон {{тчк}}, описанный выше. Это пример для подражания.

[1] Эта сноска является примером к подразделу «Как выглядит сноска».

[multiple-2] а ^б ^в Помните, что когда вы ссылаетесь на одну и ту же сноску несколько раз, используется текст из первой ссылки. Ошибка цитирования Неверный тег <ref>: название «multiple» определено несколько раз для различного содержимого

[3] Как ужé сказано выше, целью применения сносок является сбережение неразрывности течения прозы основного текста, поэтому недопустимо разрывать её абы где.

[4] Как ужé сказано выше, целью применения сносок является сбережение неразрывности течения прозы основного текста, поэтому и нарушение целостности интонаций её недопустимо.

[5] Это пример сноски, обозначение которой стоит над запятою, стоит ближе к предшествующему слову.

[6] Это пример сноски, обозначение которой стоит над точкою, стоит ближе к предшествующему слову.

[7] Это пример сноски, обозначение которой стоит над многоточием, стоит ближе к предшествующему слову.

[8] У шаблона {{nobr}} первый параметр в данном случае уместно нумеровать явно («1=»), а не то первый параметр останется пустым, если в его предполагаемом тексте (довольно обширном в случае сноски) нежданно встретится знак равенства (например, как часть вызова другого шаблона). Подробнее об этом см. Справка:Механизм шаблонов#Неопределённые и пустые параметры. Также обратите внимание, как внутри второго шаблона {{nobr}} применяется шаблон {{тчк}}, описанный выше. Это пример для подражания.

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]