Admin: Poem 2.2.2: ссылка на документацию

2026-09-20T12:41:23Z

Poem 2.2.2: ссылка на документацию

Новая страница

= Poem Bard-Wiki =

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

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

== Скачать ==

* [https://new.bard-wiki.net/downloads/extensions/Poem/Poem-BardWiki-2.2.2-bardwiki-mw143.zip Poem Bard-Wiki 2.2.2 — ZIP]
* [https://new.bard-wiki.net/downloads/extensions/Poem/Poem-BardWiki-2.2.2-bardwiki-mw143.tar.gz Poem Bard-Wiki 2.2.2 — TAR.GZ]
* [https://new.bard-wiki.net/downloads/extensions/Poem/SHA256SUMS Файл SHA256SUMS]

<pre>
7c88119c2a1c097d47fd7426352028b0b21aa69f5d9f41f1b29a40862f7d711f Poem-BardWiki-2.2.2-bardwiki-mw143.zip
1374913511821321f3a26ef5b7b72b08d8c82c349ee0aa642dfb30091a6a3cf6 Poem-BardWiki-2.2.2-bardwiki-mw143.tar.gz
</pre>

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

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

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

== Требования ==

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

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

== Установка ==

# Сделайте резервную копию каталога <code>extensions/Poem</code> и <code>LocalSettings.php</code>.
# Распакуйте архив в <code>extensions/Poem</code>.
# Убедитесь, что в <code>LocalSettings.php</code> есть:

<syntaxhighlight lang="php">
wfLoadExtension( 'Poem' );
</syntaxhighlight>

# Из корня MediaWiki выполните:

<syntaxhighlight lang="bash">
php maintenance/run.php update --quick
</syntaxhighlight>

# Проверьте версию на странице [[Служебная:Версия]].

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

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

<syntaxhighlight lang="text">
<poem>
Первая строфа, строка 1
Первая строфа, строка 2

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

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

<syntaxhighlight lang="text">
<poem c=1>
Текст песни
</poem>
</syntaxhighlight>

Три колонки:

<syntaxhighlight lang="text">
<poem c=3>
Текст песни
</poem>
</syntaxhighlight>

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

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

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

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

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

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

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

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

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

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

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

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

Poem Bard-Wiki - История изменений

Admin: Poem 2.2.2: ссылка на документацию