Extension:Poem

{{#invoke:Infobox|infobox}} Расширение Poem Bard-Wiki vers позволяет легко форматировать стихи и подобный материал в вики-тексте. После активации расширения вы можете поместить любой блок текста внутри тегов <poem></poem>, что приведет к следующим эффектам:

• Все переводы строк сохраняются.
• Блок текста оборачивается в теги для поддержки колонок с использованием flexbox.
• Пробелы в начале строки сохраняются и преобразуются в неразрывные пробелы.
• Строки, начинающиеся с запятой (,) в первой позиции, заменяются: запятая убирается, заменяется на пробел, и вся строка окрашивается в синий цвет (используется для выделения цветом строк с аккордами).
• Тег определяет разделение на строфы (разделенные пустыми строками), которые распределяются по колонкам (по умолчанию 2 колонки, или в 1 колонку по параметру "c=1").
• Расширение сохраняет вики-ссылки, жирный шрифт и т.д., если они присутствуют в стихе.

Эта версия расширения сильно отличается от оригинальной: добавлена поддержка нескольких колонок, специальная обработка строк с запятой и использование flexbox для разметки.

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

Для форматирования стихов используйте тег

 с текстом внутри. Расширение автоматически разобьет текст на строфы (группы строк, разделенные пустыми строками) и распределит их по колонкам.
=== Параметры ===

compact: Если указан, то новые строки не добавляются между строками (компактный режим, где каждая строка становится отдельным абзацем, но без лишних переносов).
c или с (кириллица): Указывает количество колонок (целое число). По умолчанию 2. Если 1 — текст в одной колонке без разбиения.

=== Пример базового использования ===
{| class="wikitable"
! Входной текст


! Выход<poem>В Xanadu Кубла ХанПостроил величественный дворец удовольствий:Где Альф, священная река, теклаЧерез пещеры, неизмеримые для человекаВниз к безсолнечному морю.
Итак, дважды пять миль плодородной земли
Были окружены стенами и башнями:
И там были сады, яркие извилистыми ручьями,
Где цвели многие деревья, несущие ладан;
И здесь были леса древние, как холмы,
Обнимающие солнечные пятна зелени.

| В Xanadu Кубла Хан Построил величественный дворец удовольствий: Где Альф, священная река, текла Через пещеры, неизмеримые для человека Вниз к безсолнечному морю.Итак, дважды пять миль плодородной земли Были окружены стенами и башнями: И там были сады, яркие извилистыми ручьями, Где цвели многие деревья, несущие ладан; И здесь были леса древние, как холмы, Обнимающие солнечные пятна зелени. |} В этом примере текст разбивается на две строфы и размещается в двух колонках.

Пример с отступами и синим цветом

Входной текст

Выход Земля с тощим боком, суровая, скупая, неприветливаяГде живущие задумчиво работают грустно,::И которая дает с сожалением этой человеческой расеНемного хлеба за столько труда и боли;::Жесткие люди, вылупившиеся на этих неблагодарных бороздах;Города, откуда уходят, корча руки,::Милосердие, мир, вера, почтенные сестры;Гордость у могущественных и у несчастных;,Строка с запятой в начале — станет синей. Земля с тощим боком, суровая, скупая, неприветливая Где живущие задумчиво работают грустно, И которая дает с сожалением этой человеческой расе Немного хлеба за столько труда и боли; Жесткие люди, вылупившиеся на этих неблагодарных бороздах; Города, откуда уходят, корча руки, Милосердие, мир, вера, почтенные сестры; Гордость у могущественных и у несчастных; Строка с запятой в начале — станет синей.} Здесь параметр c="1" указывает одну колонку. Отступы с двоеточиями (:) создают indentation. Строка, начинающаяся с запятой, окрашена в синий. Пример с несколькими колонками Входной текст Выход Строфа 1, строка 1Строфа 1, строка 2 Строфа 2, строка 1 Строфа 3, строка 1 Строфа 3, строка 2 Строфа 4, строка 1 Строфа 1, строка 1 Строфа 1, строка 2Строфа 2, строка 1Строфа 3, строка 1 Строфа 3, строка 2 Строфа 4, строка 1 Текст разбивается на 4 строфы и распределяется по 3 колонкам (первые колонки получают больше строф при неравном делении). Опция "compact" Опция compact позволяет создавать более компактную разметку: каждая строка становится отдельным абзацем, но без лишних переносов между блоками. Входной текст Выход Один,Два. Три? Четыре! Один, Два. Три? Четыре! Стиль Текст стиха оборачивается в , внутри которого колонки в , а содержимое в . Вы можете добавить стили в CSS вашего вики (например, в MediaWiki:Common.css) для кастомизации, такие как отступы, ширина колонок и т.д. Например, для обрамления: Проблемы и решения Переменные и ParserFunctions работают внутри контейнера <poem>... , но НЕ внутри самого тега ; это предотвращает шаблоны вроде <poem style="{{{1}}}">. Обход: Используйте <poem> ... . Альтернатива: Используйте магическое слово #tag:  ... (но это может не работать с опцией compact). Установка Скачайте ZIP-архив расширения по ссылке: Скачать ZIP. Распакуйте папку Poem в директорию extensions/ вашего MediaWiki. Добавьте следующий код в конец файла LocalSettings.php:wfLoadExtension( 'Poem' ); Перейдите на Special:Version в вашем вики, чтобы убедиться, что расширение установлено успешно. Эта версия требует MediaWiki версии 1.37 или выше.