WMDE Technical Wishes/Sub-referencing/ru
В настоящее время невозможно легко повторно использовать одну и ту же сноску с другими подробностями в статье. Члены сообщества неоднократно просили решение MediaWiki, которое работает без шаблонов и основано на существующем способе работы сносок, как для вики-текста, так и для визуального редактора. » Подробнее о проблеме
Вложенные сноски | |
---|---|
Status | В разработке |
Origin | Технические пожелания 2013, 2015, 2022 и другие |
Focus area | Сделать повторное использование примечаний проще |
Phabricator | доска проекта |
Responsible | Команда технических пожеланий |
Расскажите нам, что вы думаете Мы приглашаем вас протестировать наш прототип, который мы постоянно обновляем. Добавьте в список наблюдения эту страницу или подпишитесь на этот список рассылки, чтобы узнать о новинках, которые вы можете протестировать |
В рамках направления «Упрощение повторного использования ссылок» команда технических пожеланий Викимедиа Германия представляет вложенные сноски — дополнительную функцию, которая позволяет легко прикреплять различные сведения к существующей сноске без необходимости её дублирования.
Наш план — развернуть вложенные сноски в вики-проектах Викимедиа в конце 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)
- Moderated users tests took place across different projects in 2024.
- As of October/November 2024, we are currently exploring possible changes to our wikitext approach, based on the community feedback we've received. We'll reach out to communities soon to get more feedback on possible changes to the sub-referencing feature.
- Pilot wiki deployment is stalled, pending discussions and potential changes to our feature.
- We are planning to deploy the sub-referencing feature to other Wikimedia wikis in 2025.
- Мы будем продолжать собирать обратную связь для улучшения решения после его внедрения.
Мы знаем о других проблемах в области «повторного использования сносок», и мы постараемся решить их по ходу дела. Однако наше внимание по-прежнему сосредоточено на создании решения для вложенных сносок.
Часто задаваемые вопросы
Как мне найти статьи, которые используют вложенные сноски?
Отслеживающая категория Категория:Страницы, использующие расширенные сноски добавляется к любой странице, где используются вложенные сноски, что позволяет вам исследовать или исправлять страницы, испольщующие новую функцию. Название этой категории может измениться.
Могу ли я использовать эту возможность вместе с шаблонами/инструментами примечаний?
Да, можно использовать вложенные сноски с шаблонами цитирования. Мы проверили самые распространенные шаблоны цитирования (например, 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>
, так же, как это уже делается для содержания сносок. Это то, что делает наш подход.
Почему поиск решения занял так много времени?
Команда технических пожеланий работала над этой функцией с перерывами много лет. Если вы хотите узнать больше, вот обзор истории и сложности этой проблемы.