Poem Bard-Wiki

Версия от 12:17, 7 ноября 2026; Bard-Wiki Guru (обсуждение | вклад) (Poem 2.2.4 — максимум четыре колонки)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Poem Bard-Wiki

Poem Bard-Wiki — адаптированная версия расширения MediaWiki Poem. Она сохраняет обычный тег <poem>, но распределяет целые строфы по нескольким визуальным колонкам и учитывает правила оформления песен Бард-Вики.

Текущая версия: 2.2.4-bardwiki-mw143.

Скачать

34037daea13bc1d1f3cef790e40fd22043087d98cdffd9cd90802d1386a5efc9  Poem-BardWiki-2.2.4-bardwiki-mw143.zip
8022d8873a08ae782768033701f943cbda442e67ae8295e841bfc4148344f495  Poem-BardWiki-2.2.4-bardwiki-mw143.tar.gz

Архив распаковывается в каталог Poem/. Лицензия: CC0-1.0.

Возможности версии Бард-Вики

  • две колонки по умолчанию;
  • выбор от одной до четырёх колонок через латинский атрибут c или кириллический с;
  • распределение целых строф между колонками;
  • пустая строка отделяет строфы;
  • двоеточия в начале строки создают отступ;
  • начальные пробелы сохраняются;
  • запятая в первой позиции окрашивает строку синим и заменяется пробелом;
  • пустая строка на границе визуальных колонок сохраняется при обычном Ctrl+C.

Требования

  • MediaWiki 1.43 или новее;
  • PHP, поддерживаемый установленной версией MediaWiki; проверено на PHP 8.3;
  • стили классов .poem-flex-container, .poem-flex-column и .poem-content для визуального расположения колонок.

Расширение не создаёт таблиц базы данных и не изменяет содержимое страниц.

Установка

  1. Сделайте резервную копию каталога extensions/Poem и LocalSettings.php.
  2. Распакуйте архив в extensions/Poem.
  3. Убедитесь, что в LocalSettings.php есть:
wfLoadExtension( 'Poem' );
  1. Из корня MediaWiki выполните:
php maintenance/run.php update --quick
  1. Проверьте версию на странице Служебная:Версия.

Использование

Две колонки по умолчанию:

<poem>
Первая строфа, строка 1
Первая строфа, строка 2

Вторая строфа, строка 1
Вторая строфа, строка 2
</poem>

Одна колонка:

<poem c=1>
Текст песни
</poem>

Три колонки:

<poem c=3>
Текст песни
</poem>

Для старых страниц поддерживается кириллический атрибут с=1. В новом коде рекомендуется латинская буква c.

Копирование текста

До версии 2.2.1 визуальная граница колонок не создавала пустую строку в буфере обмена: последняя строфа левой колонки при вставке соединялась с первой строфой правой.

Версия 2.2.1 добавляет между DOM-колонками невидимый текстовый перевод строки. Вместе с обычным переносом между блочными элементами он создаёт ровно одну пустую строку.

Разделитель не занимает места, скрыт от экранных читалок, участвует в обычном выделении и не перехватывает Clipboard API. Отображение песни и распределение строф не меняются.

Обновление и откат

Перед обновлением сохраните текущий каталог extensions/Poem. Для отката верните его сохранённую версию. Изменений схемы базы нет.

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

  • одну, две и три колонки;
  • порядок и целостность строф;
  • пустую строку между колонками после Ctrl+C;
  • печатное представление.

История выпусков Бард-Вики

2.2.3-bardwiki-mw143
Ссылка с Служебная:Версия на эту документацию; обработка тега и отображение текста не менялись.
2.2.1-bardwiki-mw143
Сохранение пустой строки между колонками при копировании; полная документация и установочные архивы.
2.2.0-bardwiki-mw143
Адаптация к MediaWiki 1.43, пользовательское распределение строф и параметры c/с.

См. также каталог самописных расширений Бард-Вики.

Отступы с табуляцией (2.2.3)

Исправлена потеря отступа первой строки строфы, если он задан табуляцией или смесью табуляции и пробелов. Табуляция дополняет отступ до ближайшей позиции, кратной восьми. Исправление действует для одной и нескольких колонок; исходник песни не меняется. Если страница показывает старый результат, очистите её кэш. При подготовке песни обновите предпросмотр.

Максимум четыре колонки (2.2.4)

Значения от 1 до 4 задают число колонок. При большем значении выводятся четыре колонки. Это правило действует для латинской c и русской с. Без параметра выводятся две колонки.