Extension:Poem - История изменений

Admin в 14:44, 26 ноября 2025

2025-11-26T14:44:57Z

← Предыдущая версия		Версия от 17:44, 26 ноября 2025
Строка 1:		Строка 1:
	{{~~Extension~~		{{infobox
	\| name = Poem Bard-Wiki vers		\| name = Poem Bard-Wiki vers
	\| status = stable		\| status = stable

Admin в 07:40, 26 ноября 2025

2025-11-26T07:40:01Z

← Предыдущая версия		Версия от 10:40, 26 ноября 2025
Строка 14:		Строка 14:
	\| issues =		\| issues =
	}}		}}
	Расширение Poem Bard-Wiki vers позволяет легко форматировать стихи и подобный материал в вики-тексте. После активации расширения вы можете поместить любой блок текста внутри тегов <poem></poem>, что приведет к следующим эффектам:		Расширение Poem Bard-Wiki vers позволяет легко форматировать стихи и подобный материал в вики-тексте. После активации расширения вы можете поместить любой блок текста внутри тегов <nowiki><poem></poem></nowiki>, что приведет к следующим эффектам:

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

Admin в 07:38, 26 ноября 2025

2025-11-26T07:38:33Z

← Предыдущая версия		Версия от 10:38, 26 ноября 2025
Строка 4:		Строка 4:
	\| type = tag		\| type = tag
	\| description = Добавляет тег <nowiki><poem></nowiki> для форматирования стихов с поддержкой колонок и специальной обработкой		\| description = Добавляет тег <nowiki><poem></nowiki> для форматирования стихов с поддержкой колонок и специальной обработкой
	\| author = ~~[[User:~~Nikola Smolenski~~\|Nikola Smolenski]] ([[User talk:Nikola Smolenski\|talk]])~~, Brion Vibber, Steve Sanbeg, Sergey Notik		\| author = Nikola Smolenski, Brion Vibber, Steve Sanbeg, Sergey Notik
	\| version = 2.2.0		\| version = 2.2.0
	\| mediawiki = 1.37+		\| mediawiki = 1.37+
Строка 16:		Строка 16:
	Расширение Poem Bard-Wiki vers позволяет легко форматировать стихи и подобный материал в вики-тексте. После активации расширения вы можете поместить любой блок текста внутри тегов <poem></poem>, что приведет к следующим эффектам:		Расширение Poem Bard-Wiki vers позволяет легко форматировать стихи и подобный материал в вики-тексте. После активации расширения вы можете поместить любой блок текста внутри тегов <poem></poem>, что приведет к следующим эффектам:

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

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

Admin в 07:31, 26 ноября 2025

2025-11-26T07:31:29Z

← Предыдущая версия		Версия от 10:31, 26 ноября 2025
Строка 3:		Строка 3:
	\| status = stable		\| status = stable
	\| type = tag		\| type = tag
	\| description = Добавляет тег <poem> для форматирования стихов с поддержкой колонок и специальной обработкой		\| description = Добавляет тег <nowiki><poem></nowiki> для форматирования стихов с поддержкой колонок и специальной обработкой
	\| author = [[User:Nikola Smolenski\|Nikola Smolenski]] ([[User talk:Nikola Smolenski\|talk]]), Brion Vibber, Steve Sanbeg, Sergey Notik		\| author = [[User:Nikola Smolenski\|Nikola Smolenski]] ([[User talk:Nikola Smolenski\|talk]]), Brion Vibber, Steve Sanbeg, Sergey Notik
	\| version = 2.2.0		\| version = 2.2.0

Admin: Новая страница: «{{Extension | name = Poem Bard-Wiki vers | status = stable | type = tag | description = Добавляет тег для форматирования стихов с поддержкой колонок и специальной обработкой | author = Nikola Smolenski (talk), Brion Vibber, Steve Sanbeg, Sergey Notik | version = 2.2.0 | mediawiki = 1.37+ | database = no | license = Crea...»

2025-11-26T07:17:01Z

Новая страница: «{{Extension | name = Poem Bard-Wiki vers | status = stable | type = tag | description = Добавляет тег <poem> для форматирования стихов с поддержкой колонок и специальной обработкой | author = Nikola Smolenski (talk), Brion Vibber, Steve Sanbeg, Sergey Notik | version = 2.2.0 | mediawiki = 1.37+ | database = no | license = Crea...»

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

{{Extension
| name = Poem Bard-Wiki vers
| status = stable
| type = tag
| description = Добавляет тег <poem> для форматирования стихов с поддержкой колонок и специальной обработкой
| author = [[User:Nikola Smolenski|Nikola Smolenski]] ([[User talk:Nikola Smolenski|talk]]), Brion Vibber, Steve Sanbeg, Sergey Notik
| version = 2.2.0
| mediawiki = 1.37+
| database = no
| license = [[Creative Commons Zero v1.0 Universal|//creativecommons.org/publicdomain/zero/1.0/]]
| download = [https://bard-wiki.net/download/Poem.zip Скачать ZIP-архив расширения]
| tags = poem
| translate =
| issues =
}}
Расширение Poem Bard-Wiki vers позволяет легко форматировать стихи и подобный материал в вики-тексте. После активации расширения вы можете поместить любой блок текста внутри тегов <poem></poem>, что приведет к следующим эффектам:

Все новые строки сохраняются путем преобразования их в теги

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

Эта версия расширения сильно отличается от оригинальной: добавлена поддержка нескольких колонок, специальная обработка строк с запятой и использование flexbox для разметки.
== Использование ==
Для форматирования стихов используйте тег <poem> с текстом внутри. Расширение автоматически разобьет текст на строфы (группы строк, разделенные пустыми строками) и распределит их по колонкам.
=== Параметры ===

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

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

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

! Выход<poem c="1">Земля с тощим боком, суровая, скупая, неприветливаяГде живущие задумчиво работают грустно,::И которая дает с сожалением этой человеческой расеНемного хлеба за столько труда и боли;::Жесткие люди, вылупившиеся на этих неблагодарных бороздах;Города, откуда уходят, корча руки,::Милосердие, мир, вера, почтенные сестры;Гордость у могущественных и у несчастных;,Строка с запятой в начале — станет синей.</poem>Земля с тощим боком, суровая, скупая, неприветливая
Где живущие задумчиво работают грустно,
И которая дает с сожалением этой человеческой расе
Немного хлеба за столько труда и боли;
Жесткие люди, вылупившиеся на этих неблагодарных бороздах;
Города, откуда уходят, корча руки,
Милосердие, мир, вера, почтенные сестры;
Гордость у могущественных и у несчастных;
Строка с запятой в начале — станет синей.}
Здесь параметр c="1" указывает одну колонку. Отступы с двоеточиями (:) создают indentation. Строка, начинающаяся с запятой, окрашена в синий.
=== Пример с несколькими колонками ===
{| class="wikitable"
! Входной текст

! Выход<poem c="3">Строфа 1, строка 1Строфа 1, строка 2
Строфа 2, строка 1
Строфа 3, строка 1
Строфа 3, строка 2
Строфа 4, строка 1
</poem>
| Строфа 1, строка 1
Строфа 1, строка 2Строфа 2, строка 1Строфа 3, строка 1
Строфа 3, строка 2

Строфа 4, строка 1
|}
Текст разбивается на 4 строфы и распределяется по 3 колонкам (первые колонки получают больше строф при неравном делении).
=== Опция "compact" ===
Опция compact позволяет создавать более компактную разметку: каждая строка становится отдельным абзацем, но без лишних переносов между блоками.
{| class="wikitable"
! Входной текст

! Выход<poem compact>Один,Два.
</poem>
<poem compact>
Три?
Четыре!
</poem></pre>
| Один,<br>Два.<br>Три?<br>Четыре!
|}
== Стиль ==
Текст стиха оборачивается в , внутри которого колонки в , а содержимое в . Вы можете добавить стили в CSS вашего вики (например, в MediaWiki:Common.css) для кастомизации, такие как отступы, ширина колонок и т.д.
Например, для обрамления:
<poem style="border: 2px solid #d6d2c5; background-color: #fdf2d5; padding: 1em;">
== Проблемы и решения ==

Переменные и ParserFunctions работают внутри контейнера <poem>...</poem>, но НЕ внутри самого тега <poem ... >; это предотвращает шаблоны вроде <poem style="{{{1}}}">.
Обход: Используйте <poem> ... </poem>.
Альтернатива: Используйте магическое слово #tag: {{#tag:poem| ... |style="{{{1}}}"}} (но это может не работать с опцией compact).

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

Скачайте ZIP-архив расширения по ссылке: [https://bard-wiki.net/download/Poem.zip Скачать ZIP].
Распакуйте папку Poem в директорию extensions/ вашего MediaWiki.
Добавьте следующий код в конец файла [[Manual:LocalSettings.php|LocalSettings.php]]:wfLoadExtension( 'Poem' );
Перейдите на [[Special:Version]] в вашем вики, чтобы убедиться, что расширение установлено успешно.

Эта версия требует MediaWiki версии 1.37 или выше.