WMDE Technical Wishes/Sub-referencing/ru
Вложенные сноски | |
---|---|
Status | В разработке |
Origin | Технические пожелания 2013, 2015, 2022 и другие |
Focus area | Сделать повторное использование примечаний проще |
Phabricator | доска проекта |
Responsible | Команда технических пожеланий |
Расскажите нам, что вы думаете Мы приглашаем вас протестировать наш прототип, который мы постоянно обновляем. Добавьте в список наблюдения эту страницу или подпишитесь на этот список рассылки, чтобы узнать о новинках, которые вы можете протестировать |
В настоящее время невозможно легко повторно использовать одну и ту же сноску с другими подробностями в статье. Члены сообщества неоднократно просили решение MediaWiki, которое работает без шаблонов и основано на существующем способе работы сносок, как для вики-текста, так и для визуального редактора. » Подробнее о проблеме
В рамках направления «Упрощение повторного использования ссылок» команда технических пожеланий Викимедиа Германия представляет вложенные сноски — дополнительную функцию, которая позволяет легко прикреплять различные сведения к существующей сноске без необходимости её дублирования.
Наш план — развернуть вложенные сноски в вики-проектах Викимедиа в конце 2024 года.
О вложенных сносках кратко
Чтобы цитировать источник больше одного раза с разными подробностями, вам нужны основная сноска и вложенные сноски.
- Основная сноска содержит основную библиографическую информацию.
- Вложенная сноска содержит подробности: номера страниц или любую дополнительную информацию, которая может отличаться для каждого включения, например, главы, стихи или примечания.
- В разделе ссылок читатели видят все вложенные сноски, сгруппированные под их основной сноской. Это облегчает понимание того, как часто один источник цитировался в этой статье.
- В вики-тексте вы используете новый атрибут для вложенных ссылок. Текущее имя этого атрибута — extends, но оно может измениться до развертывания функции. Мы соберем больше отзывов об имени.
- В визуальном редакторе мы изменяем существующее диалоговое окно цитирования, чтобы оно поддерживало вложенные сноски.
Основные преимущества
- Вложенные сноски основываются на существующем способе работы сносок.
- Это работает как для Визуального редактора, так и для вики-текста, приближая нас к паритету функций между Визуальным редактором и вики-текстом.
- Решение будет интегрировано в MediaWiki, таким образом, доступно во всех вики-проектах Викимедиа и может быть использовано без решений на основе шаблонов.
- Вложенные сноски будут правильно отображаться в предпросмотре примечаний и мобильных попапах примечаний.
- Это не обязательно: вы можете использовать другие методы для сносок. Но вы можете столкнуться с вложенной сноской в статьях, написанных другими участниками.
- Протестируйте прототип! Узнайте больше о том, как тестировать.
- Оставьте общий отзыв на странице обсуждения.
- Добавьте в список наблюдения эту страницу или подпишитесь на этот список рассылок, чтобы узнать о новинках, которые вы можете протестировать.
Как это работает
В вики-тексте
Решение вложенных сносок в вики-тексте почти готово. Однако имя атрибута может измениться. Решение еще не развернуто, в основном потому, что мы хотим избежать того, чтобы пользователи визуального редактора имели совершенно другой опыт, чем пользователи, редактирующие вики-текст. Поддержка визуального редактора всё ещё находится в разработке. Вы все еще можете протестировать прототип и рассказать нам, как вам его работа.
Преимущества, специфичные для вики-текста
- Решение основывается на существующей и известной концепции именованных ссылок.
- Оно не требует знаний шаблонов.
- В вики-тексте можно удалить почти дублирующиеся сноски, что делает его чище, менее избыточным и более простым для чтения.
По шагам
1) Вам нужна сноска с основной библиографической информацией, основная ссылка. Для этой ссылки нужно имя:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
Эту основную сноску следует поместить в раздел примечаний, иначе в статье будет ссылка, не содержащая никаких подробностей, например номеров страниц.
2) Вы создаете вложенную сноску, используя имя основной сноски с атрибутом extends. Вы добавляете подробности между тегами <ref>
:
<ref extends="Miller">Page 23.</ref>
Вот как это выглядит:
According to scientists, the Sun is pretty big.<ref extends="Miller">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref extends="Miller">Page 23.</ref>
==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
Если вы хотите сослаться на новый источник, используя вложенные сноски в вики-тексте, вам нужно создать основную сноску в разделе примечаний.
Но во многих случаях вы, вероятно, захотите использовать вложенную сноску с основной сноской, которая уже существует в статье. В этих случаях
- Превратите первоначальную сноску в основную сноску с помощью
<ref name>
. - Переместите основную сноску в раздел примечаний.
- Создайте вложенную сноску в тексте статьи на том месте, где первоначальная сноска была ранее.
- Переместите подробности из основной сноски (номеров страниц и т.д.) во вложенную сноску. Убедитесь, что они больше не остаются в основном справочнике, иначе эти детали будут показаны дважды.
- Создайте больше вложенных сносок в тех местах статьи, где бы вы не хотели цитировать источник с различными подробностями.
Вы также можете повторно использовать саму вложенную сноску, дав вложенной сноске имя:
According to scientists, the Sun is pretty big.<ref extends="Miller" name="Miller, 23">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref name="Miller, 23" />
==References==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
Обратите внимание
- Преобразование сносок в основные и вложенные требует некоторой очистки; и основная ссылка, как правило, должна находиться в секции примечаний (как описано выше).
- Вы можете использовать вложенные сноски с шаблонами цитирования. Мы проверили наиболее часто используемые, но ваш любимый шаблон может нуждаться в обновлении, чтобы работать с нашим решением.
- Некоторые гаджеты/скрипты, связанные со сносками, также могут нуждаться в обновлении, чтобы правильно работать с новым решением вложенных сносок.
- Невозможно сделать вложенную сноску для вложенной сноски.
- Если используется
<ref group>
, основная и вложенная сноски должны находиться в одной группе.
В визуальном редакторе (в разработке)
На данный момент мы не знаем, как будет выглядеть функция для визуального редактора. Пока у нас есть очень минимальное решение, которое еще не готово к развертыванию. В ближайшие недели это решение, скорее всего, изменится. Вы также можете протестировать прототип с текущим состоянием решения для визуального редактора. Пожалуйста, имейте в виду, что оно, скорее всего, изменится. Мы обновим эту страницу, когда новые аспекты станут доступны для тестирования.
Преимущества, специфичные для визуального редактора
- Чтобы сослаться на один и тот же источник с разными подробностями, вам больше не нужно создавать новую сноску с нуля.
- Вложенные сноски полностью совместимы с визуальным редактором (в отличие от решений на шаблонах): вы можете создать их через диалог цитирования и редактировать их из раздела примечаний.
Рабочие процессы в текущем прототипе (вероятно, изменятся)
Создание вложенной сноски
- Создание вложенной сноски в настоящее время работает через существующий диалог цитирования.
- Во вкладке «Расширяет» выберите сноски, которую вы хотите повторно использовать. Эта вкладка, вероятно, будет улучшена после наших текущих сессий тестирования с пользователями.
- Введите подробности этой вложенной сноски и кликните на вставку.
- В окне сноски в визуальном редакторе вы видите, что эта сноска является вложенной, и как часто она используется повторно.
Редактирование существующей вложенной сноски
- Нажмите на маркер примечания в тексте статьи, чтобы редактировать вложенную сноску.
- Теперь вы можете изменить подробности вложенной сноски. Вы также информированы, что это сноска является вложенной.
- Вы пока не сможете редактировать вложенную сноску из списка примечаний.
- Чтобы редактировать основную сноску, нажмите на неё в разделе примечаний.
Повторное использование вложенной сноски
- Вы можете повторно использовать вложенную сноску с помощью вкладки «повторное использование» в диалоге цитирования.
Обратите внимание
- Существующая проблема с автоматическими именами сносок в визуальном редакторе возникает также и с вложенными сносками.
- В визуальном редакторе в настоящее время можно сделать вложенную сноску для вложенной сноски. Это ошибка, и при сохранении вы получите ошибку. Так не должно будет работать позже в решении, а также не работает в вики-тексте.
- Мы еще не проработали, что происходит, когда удаляется ссылка, которая используется повторно.
- Рабочий процесс по превращению существующих сносок в основные и вложенные еще не определен.
- Когда вы создаете повторное используете вложенные сноски в визуальном редакторе, а затем переключаетесь на вики-текст, вы обнаружите, что утверждение в вики-тексте —
<ref extends="main-reference" name="sub-reference" />
. Это ошибка, и она будет исправлена в рамках T367749. - $сщву в настоящее время не показывает предыдущую версию сноски для вложенной сноски в визуальном режиме редактирования. Вы увидите в окне только подробности вложенной сноски, но не информацию из основной ссылки. Чтобы также увидеть и информацию из основной сноски в окне, вы должны использовать синтаксис
<ref extends="main" name="sub-reference name" />
.
Тестирование прототипа
Нам нужны ваши отзывы, чтобы убедиться, что мы создаем правильные вещи. Отзывы и вопросы всегда приветствуются на странице обсуждения этого проекта.
Прототип доступен на бета-вики. В настоящее время мы прежде всего приглашаем вас протестировать решение для вики-текста:
- Они могут выглядеть по-другому (например, не использовать предпочитаемую вами тему оформления).
- Они могут предлагать некоторые новые функции, которые ещё испытываются.
- Они содержат только некоторые тестовые страницы и шаблоны, не весь контент вашей вики, как и не все шаблоны, модули, гаджеты и т. д., к которым вы привыкли.
- Ваш обычный логин в проектах Викимедиа не работает на бета-вики. Вы можете либо зарегистрировать учетную запись — обязательно используйте пароль, отличный от вашего обычной учётной записи Викимедиа — или протестировать функцию без учетной записи, что приведет к созданию временной учетной записи (на de-betawiki) — или отобразит ваш IP-адрес (на en-betawiki).
Проблема, которую мы решаем
В статьях Википедии принято ссылаться на источник несколько раз. Но хотя вы можете повторно использовать сноску точно такой, какая она есть, в настоящее время вы не можете повторно использовать ту же ссылку с другими подробностями (например, с другими номерами страниц). Единственный вариант — создать совершенно новую ссылку или использовать обходные пути.
Статус-кво: повторное использование сносок в вики-тексте и визуальном редакторе
Если вы хотите повторно использовать сноску в вики-тексте, вы можете превратить ее в именованную ссылку и ссылаться на это имя в другом месте статьи. Именованную сноску можно разместить в тексте статьи или в разделе примечаний. В визуальном редакторе вы можете использовать опцию «повторное использование» в диалоге цитирования. В разделе примечаний ссылки с одинаковым именем группируются вместе.
-
Вики-текст: <ref name> в тексте статьи
-
Вики-текст: <ref name> в разделе примечаний
-
Визуальный редактор: диалог цитирования
-
Вид для читателя
Статус-кво: повторное использование сносок с различными подробностями в вики-тексте
Если вы хотите повторно использовать существующую сноску с другими подробностями в вики-тексте, вам в настоящее время необходимо скопировать и вставить существующую сноску и изменить подробности дубликата или создать новую (почти идентичную) сноску с нуля. Некоторые проекты используют обходные пути, такие как короткие цитаты или решения на основе шаблонов, такие как сокращенные сноски. В разделе примечаний исходная сноска и новая, которую вы создали, не группируются вместе.
-
Два почти идентичных сноски в вики-тексте.
-
Вид для читателя: почти одинаковые сноски не объединены
-
Обходной путь с короткими цитатами в вики-тексте
-
Вид для читателя: обходной путь с короткими цитатами
-
Обходной путь с {{sfn}} в вики-тексте
-
Вид для читателя: обходной путь с {{sfn}}
Статус-кво: повторное использование сносок с различными подробностями в визуальном редакторе
Если вы хотите повторно использовать существующую сноску с другими подробностями в визуальном редакторе, ни опция «повторное использование» в диалоговом окне цитирования, ни метод копирования и вставки не сработают, поскольку оба варианта приводят к идентичным повторным использованиям, а изменение подробностей повторно используемой/скопированной сноски изменяет оба экземпляра этой сноски. Вместо этого вам нужно будет создать новую (почти идентичную) сноску с нуля. В разделе примечаний исходная сноска и новая, которую вы создали, не будут сгруппированы вместе.
Сноски, созданные на основе шаблонов, такие как {{sfn}}, не могут быть изменены из раздела сносок и не появляются в вкладке повторного использования диалога цитирования; но можно редактировать их вручную, найдя их в тексте статьи.
обходной путь с {{sfn}}:
-
Вид для читателя
-
Сноски исчезают из раздела примечаний при клике на «редактировать».
-
Невозможно использовать сноски {{sfn}} через диалог «повторное использование».
-
Сноски можно редактировать только найдя их в тексте статьи
Проблемы для читателей
Обходные пути на основе шаблонов не отображаются должным образом в предварительном просмотре сносок, подсказках для сносок и мобильных всплывающих окнах со сносками.
обходной путь {{sfn}} с предварительным просмотром сносок:
-
Предварительный просмотр сносок: Основная информация не отображается во всплывающем окне.
-
Подсказки для сносок: Основная информация не включена в начальное всплывающее окно.
-
Подсказки для сносок: Основная информация отображается в отдельном всплывающем окне.
-
Всплывающее окно сноски на мобильных: Основная информация не включена.
Основные проблемы со статус-кво
- Опыт пользователей визуального редактора и вики-текста очень отличается.
- Большинство решений для повторного использования сносок с различными деталями не работают должным образом в визуальном редакторе.
- Создание множества почти идентичных сносок с разными деталями делает вики-текст длиннее и, вероятно, труднее для чтения.
- Реализация методов решения на основе шаблонов не принимается во всех сообществах одинаково и, следовательно, не доступна в глобальном масштабе.
- Некоторые пользователи пытаются избежать этой проблемы, помещая источники в разделе библиографии без использования их в качестве сносок, что затрудняет проверку разделов статьи.
Недавние изменения и следующие шаги
Наша команда уже некоторое время работает над этой проблемой. Вот обзор истории этого проекта, включая наши исследования.
Спасибо всем, кто принимал участие в тестах и интервью и проявил интерес, а также всем, кто находил время, чтобы комментировать наши страницы обсуждения на протяжении многих лет. Мы это очень ценим. Если у вас есть дополнительные отзывы, пожалуйста, поделитесь ими на странице обсуждения.
- Прототип доступен на бета-вики. Он охватывает решение для вики-текста и некоторые основные функции решения для визуального редактора. Вы можете непрерывно тестировать прототип и давать отзывы.
- Мы будем публиковать анонсы во всех вики-проектах, чтобы сообщества знали об этой предстоящей функции, и приглашать их тестировать и давать отзывы.
- Our team presented sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
- Пользователи в разных проектах в настоящее время участвуют в модерируемых пользовательских тестах.
- В ближайшее время мы обратимся к потенциальным пилотным вики-проектам и, надеемся, в конце сентября развернём проект в пилотных вики-проектах.
- Наш план состоит в том, чтобы в концу 2024 года внедрить функцию вложенных сносок для вики-текста и визуального редактора.
- Мы будем продолжать собирать обратную связь для улучшения решения после его внедрения.
Мы знаем о других проблемах в области «повторного использования сносок», и мы постараемся решить их по ходу дела. Однако наше внимание по-прежнему сосредоточено на создании решения для вложенных сносок.
Часто задаваемые вопросы
Как мне найти статьи, которые используют вложенные сноски?
Отслеживающая категория Категория:Страницы, использующие расширенные сноски добавляется к любой странице, где используются вложенные сноски, что позволяет вам исследовать или исправлять страницы, испольщующие новую функцию. Название этой категории может измениться.
Могу ли я использовать эту возможность вместе с шаблонами/инструментами примечаний?
Да, можно использовать вложенные сноски с шаблонами цитирования. Мы проверили самые распространенные шаблоны цитирования (например, cite book и cite web) и не ожидаем каких-либо проблем. Но ваш любимый шаблон может потребовать некоторых обновлений, чтобы работать с нашим решением. Некоторые гаджеты/скрипты, связанные со сносками, также могут нуждаться в обновлении, чтобы правильно работать с новым решением по сноскам. Поскольку шаблоны, гаджеты и скрипты находятся в руках вики-сообществ, мы не можем их адаптировать.
Пожалуйста, сообщите нам на странице обсуждения, если вы обнаружите какие-либо проблемы или нуждаетесь в помощи в обновлении шаблонов цитирования, чтобы они работали с новой функцией. Вы также можете посетить нашу семинар на Викимании «[$1 Новый вариант цитирования — Что это означает для шаблонов цитатирования?]» (гибридный) или посмотреть запись позже.
Каким будет название атрибута вложенной сноски?
Мы еще не знаем. В настоящее время название атрибута для создания вложенной сноски в вики-тексте — extends
. Мы приняли решение по этому названию несколько лет назад после обсуждения с сообществами и заинтересованными сторонами в Фонде Викимедиа. Однако мы получили некоторые отзывы, что это название может быть не лучшим вариантом. Прежде чем мы будем распространять эту функцию на вики-проекты, мы хотим получить больше отзывов о названии атрибута и планируем обсудить некоторые альтернативы. Мы сообщим вам, когда это произойдет.
Почему вы выбрали такой синтаксис вики-текста?
Когда мы впервые начали работать над внедрением этой функции в вики-тексте, мы обсудили различные варианты. Добавление нового тега (например, <subref>
) было тщательно обсуждено, но мы хотели придерживаться существующего подхода <ref>
, чтобы минимизировать количество нового синтаксиса, которому нужно будет учиться, для участников. Кроме того, для внедрения нового тега потребуется много обновлений существующего программного обеспечения сообщества (инструменты, гаджеты, боты и т.д.) для сносок.
Одно предложение (от 2008 г.) состояло в том, чтобы указать детали вложенных сносок внутри тега <ref>
: <ref page="page 2" name="Miller">
или позднее <ref detail="page 2" name="Miller">
, используя атрибут name для ссылки на основную ссылку. Это похоже на опыт работы участников с такими шаблонами как {{cite book}}.
Однако главная проблема этого подхода заключается в том, что он вызывает проблемы с шаблонами и очень вероятно приведет к ошибкам. Другая проблема этого синтаксиса заключается в том, что он не позволяет повторно использовать вложенную сноску, поскольку атрибут name уже используется для ссылки на основную сноску и не может быть использован повторно.
Способ избежать обоих этих проблем заключается в создании нового атрибута сноски и помещении деталей вложенной сноски в зону между открывающим и закрывающим тегами <ref>
, так же, как это уже делается для содержания сносок. Это то, что делает наш подход.
Почему поиск решения занял так много времени?
Команда технических пожеланий работала над этой функцией с перерывами много лет. Если вы хотите узнать больше, вот обзор истории и сложности этой проблемы.