Poem Bard-Wiki

Poem Bard-Wiki

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

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

Скачать

• Poem Bard-Wiki 2.2.2 — ZIP
• Poem Bard-Wiki 2.2.2 — TAR.GZ
• Файл SHA256SUMS

7c88119c2a1c097d47fd7426352028b0b21aa69f5d9f41f1b29a40862f7d711f  Poem-BardWiki-2.2.2-bardwiki-mw143.zip
1374913511821321f3a26ef5b7b72b08d8c82c349ee0aa642dfb30091a6a3cf6  Poem-BardWiki-2.2.2-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.2-bardwiki-mw143

Ссылка с Служебная:Версия на эту документацию; обработка тега и отображение текста не менялись.

2.2.1-bardwiki-mw143

Сохранение пустой строки между колонками при копировании; полная документация и установочные архивы.

2.2.0-bardwiki-mw143

Адаптация к MediaWiki 1.43, пользовательское распределение строф и параметры c/с.

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