Poem Bard-Wiki: различия между версиями
Admin (обсуждение | вклад) Poem 2.2.2: ссылка на документацию |
Poem 2.2.4 — максимум четыре колонки |
||
| (не показана 1 промежуточная версия этого же участника) | |||
| Строка 3: | Строка 3: | ||
'''Poem Bard-Wiki''' — адаптированная версия расширения MediaWiki Poem. Она сохраняет обычный тег <code><poem></code>, но распределяет целые строфы по нескольким визуальным колонкам и учитывает правила оформления песен Бард-Вики. | '''Poem Bard-Wiki''' — адаптированная версия расширения MediaWiki Poem. Она сохраняет обычный тег <code><poem></code>, но распределяет целые строфы по нескольким визуальным колонкам и учитывает правила оформления песен Бард-Вики. | ||
Текущая версия: '''2.2. | Текущая версия: '''2.2.4-bardwiki-mw143'''. | ||
== Скачать == | == Скачать == | ||
* [https://new.bard-wiki.net/downloads/extensions/Poem/Poem-BardWiki-2.2. | * [https://new.bard-wiki.net/downloads/extensions/Poem/Poem-BardWiki-2.2.4-bardwiki-mw143.zip Poem Bard-Wiki 2.2.4 — ZIP] | ||
* [https://new.bard-wiki.net/downloads/extensions/Poem/Poem-BardWiki-2.2. | * [https://new.bard-wiki.net/downloads/extensions/Poem/Poem-BardWiki-2.2.4-bardwiki-mw143.tar.gz Poem Bard-Wiki 2.2.4 — TAR.GZ] | ||
* [https://new.bard-wiki.net/downloads/extensions/Poem/SHA256SUMS Файл SHA256SUMS] | * [https://new.bard-wiki.net/downloads/extensions/Poem/SHA256SUMS Файл SHA256SUMS] | ||
<pre> | <pre> | ||
34037daea13bc1d1f3cef790e40fd22043087d98cdffd9cd90802d1386a5efc9 Poem-BardWiki-2.2.4-bardwiki-mw143.zip | |||
8022d8873a08ae782768033701f943cbda442e67ae8295e841bfc4148344f495 Poem-BardWiki-2.2.4-bardwiki-mw143.tar.gz | |||
</pre> | </pre> | ||
| Строка 21: | Строка 21: | ||
* две колонки по умолчанию; | * две колонки по умолчанию; | ||
* выбор | * выбор от одной до четырёх колонок через латинский атрибут <code>c</code> или кириллический <code>с</code>; | ||
* распределение целых строф между колонками; | * распределение целых строф между колонками; | ||
* пустая строка отделяет строфы; | * пустая строка отделяет строфы; | ||
| Строка 108: | Строка 108: | ||
== История выпусков Бард-Вики == | == История выпусков Бард-Вики == | ||
; 2.2. | ; 2.2.3-bardwiki-mw143 | ||
: Ссылка с [[Служебная:Версия]] на эту документацию; обработка тега и отображение текста не менялись. | : Ссылка с [[Служебная:Версия]] на эту документацию; обработка тега и отображение текста не менялись. | ||
; 2.2.1-bardwiki-mw143 | ; 2.2.1-bardwiki-mw143 | ||
| Строка 116: | Строка 116: | ||
См. также [[Расширения Бард-Вики|каталог самописных расширений Бард-Вики]]. | См. также [[Расширения Бард-Вики|каталог самописных расширений Бард-Вики]]. | ||
== Отступы с табуляцией (2.2.3) == | |||
Исправлена потеря отступа первой строки строфы, если он задан табуляцией или смесью табуляции и пробелов. Табуляция дополняет отступ до ближайшей позиции, кратной восьми. Исправление действует для одной и нескольких колонок; исходник песни не меняется. Если страница показывает старый результат, очистите её кэш. При подготовке песни обновите предпросмотр. | |||
== Максимум четыре колонки (2.2.4) == | |||
Значения от 1 до 4 задают число колонок. При большем значении выводятся четыре колонки. Это правило действует для латинской <code>c</code> и русской <code>с</code>. Без параметра выводятся две колонки. | |||
Текущая версия от 12:17, 7 ноября 2026
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для визуального расположения колонок.
Расширение не создаёт таблиц базы данных и не изменяет содержимое страниц.
Установка
- Сделайте резервную копию каталога
extensions/PoemиLocalSettings.php. - Распакуйте архив в
extensions/Poem. - Убедитесь, что в
LocalSettings.phpесть:
wfLoadExtension( 'Poem' );
- Из корня MediaWiki выполните:
php maintenance/run.php update --quick
- Проверьте версию на странице Служебная:Версия.
Использование
Две колонки по умолчанию:
<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 и русской с. Без параметра выводятся две колонки.