BardSongbooks - История изменений

Admin: BardSongbooks 0.2.3: примечания и исполнение, параметры печати и ссылки публичного каталога

2026-10-07T06:38:44Z

BardSongbooks 0.2.3: примечания и исполнение, параметры печати и ссылки публичного каталога

← Предыдущая версия		Версия от 09:38, 7 октября 2026
Строка 3:		Строка 3:
	== Скачать ==		== Скачать ==

	* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.1.zip BardSongbooks-0.2.1.zip]		* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.3.zip BardSongbooks-0.2.3.zip]
	* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.1.tar.gz BardSongbooks-0.2.1.tar.gz]		* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.3.tar.gz BardSongbooks-0.2.3.tar.gz]
	* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/SHA256SUMS SHA256SUMS]		* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/SHA256SUMS SHA256SUMS]

	<pre>		<pre>
	~~912ffa91633b28f474cdbc8514497888e5afdc6f3378cd478580279d9767d08e~~ BardSongbooks-0.2.1.zip		5626f68e59f0612e1ff24c9abddc7e67517b126e74aac864458ac826e1fee969 BardSongbooks-0.2.3.zip
	~~b5c1d2223fbf2b91d13c15aa1cf4f5f6ff05caf02097b2f631c3174da7e03c13~~ BardSongbooks-0.2.1.tar.gz		4491f343ad65f4f4325c111d3c5dfef27e88876ec15795731de0b8d7ac006342 BardSongbooks-0.2.3.tar.gz
	</pre>		</pre>

Строка 15:		Строка 15:
	<code>BardSongbooks</code> — самописное расширение MediaWiki для личных песенников Бард-Вики. Зарегистрированный пользователь может создать несколько приватных или публичных песенников, добавить в них страницы песен, расположить песни в любом порядке и подготовить печатную версию или PDF.		<code>BardSongbooks</code> — самописное расширение MediaWiki для личных песенников Бард-Вики. Зарегистрированный пользователь может создать несколько приватных или публичных песенников, добавить в них страницы песен, расположить песни в любом порядке и подготовить печатную версию или PDF.

	Текущая версия: '''0.2.1'''.		Текущая версия: '''0.2.3'''.

			== Изменения 0.2.3 ==

			* Настройки showNotes и showPerformance сохраняются в существующем JSON bsb_settings, без миграции БД.
			* «Показывать примечания»: при выключении удаляются раздел/список примечаний и ссылки-номера Cite в тексте; обычные надстрочные символы сохраняются.
			* «Показывать исполнение»: при выключении убираются заголовок и таблица исполнения из Template:Song либо одноимённый раздел.
			* «Только первый раздел» исключает аккорды и остальные варианты текста, но оставляет явно выбранные примечания/исполнение.
			* В старых и новых песенниках showNotes/showPerformance по умолчанию true; существующие сохранённые параметры не переписываются.
			* Параметры печати разделены на верхнюю строку полей и сетку галочек, с адаптацией для узкого экрана.
			* Название в общем каталоге публичных песенников открывает печатную версию; права владельца и приватность не меняются.


			=== Примечания и исполнение ===

			«Показывать примечания» управляет разделом примечаний и номерами сносок в песне вместе. При выключении исчезают ссылки-номера Cite, список и заголовок примечаний; обычные надстрочные символы текста не удаляются.

			«Показывать исполнение» управляет заголовком и таблицей исполнения, которые создаёт шаблон Song, а также отдельным одноимённым разделом, если он есть.

			Обе галочки включены по умолчанию и сохраняются для каждого песенника в bsb_settings как showNotes и showPerformance. Для старых настроек без этих ключей используется true. Исходные страницы песен и старые сохранённые настройки при обновлении не переписываются. При снятой галочке значение false сохраняется и в приватном, и в публичном печатном просмотре.

			«Только первый раздел песни» исключает аккорды и последующие варианты текста. Примечания и исполнение выбираются независимо: отмеченные дополнения остаются и при включённом первом разделе. Оглавление и количество колонок 1/2/3 работают как прежде.

			Название в общем каталоге публичных песенников ведёт сразу на Special:SongbookPrint/<id>. Ссылка для общего доступа Special:Songbook/<id> остаётся прежней, менять книгу по-прежнему может только владелец.

			Обновление с 0.2.1 на 0.2.3 не требует миграции БД или запуска updater. Версия 0.2.2 не выпускалась (отменённый частный черновик).

	== Изменения 0.2.1 ==		== Изменения 0.2.1 ==
Строка 198:		Строка 223:
	Если расширение удаляется окончательно, таблицы <code>bard_songbook_item</code> и <code>bard_songbook</code> можно удалить вручную только после отдельной проверенной резервной копии. Сначала удаляется таблица элементов, затем таблица песенников.		Если расширение удаляется окончательно, таблицы <code>bard_songbook_item</code> и <code>bard_songbook</code> можно удалить вручную только после отдельной проверенной резервной копии. Сначала удаляется таблица элементов, затем таблица песенников.

	== Ограничения версии 0.2.1 ==		== Ограничения версии 0.2.3 ==

	* песенники привязаны к текущим версиям страниц песен и не фиксируют конкретную ревизию;		* песенники привязаны к текущим версиям страниц песен и не фиксируют конкретную ревизию;

Admin: BardSongbooks 0.2.1: корзина в правой колонке, порядок перетаскиванием; документация и загрузки

2026-10-07T06:16:04Z

BardSongbooks 0.2.1: корзина в правой колонке, порядок перетаскиванием; документация и загрузки

← Предыдущая версия		Версия от 09:16, 7 октября 2026
Строка 3:		Строка 3:
	== Скачать ==		== Скачать ==

	* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.0.zip BardSongbooks-0.2.0.zip]		* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.1.zip BardSongbooks-0.2.1.zip]
	* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.0.tar.gz BardSongbooks-0.2.0.tar.gz]		* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.2.1.tar.gz BardSongbooks-0.2.1.tar.gz]
	* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/SHA256SUMS SHA256SUMS]		* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/SHA256SUMS SHA256SUMS]

	<pre>		<pre>
	~~88ce1e49927439a4bed65e4a27d6b2a0e695dd98d34a7f3104c3426c02658798~~ BardSongbooks-0.2.0.zip		912ffa91633b28f474cdbc8514497888e5afdc6f3378cd478580279d9767d08e BardSongbooks-0.2.1.zip
	~~18e8e1823a41c15d2c6777ce546041db76ab613374ab2c48bfa8cbdb1260db1a~~ BardSongbooks-0.2.0.tar.gz		b5c1d2223fbf2b91d13c15aa1cf4f5f6ff05caf02097b2f631c3174da7e03c13 BardSongbooks-0.2.1.tar.gz
	</pre>		</pre>

Строка 15:		Строка 15:
	<code>BardSongbooks</code> — самописное расширение MediaWiki для личных песенников Бард-Вики. Зарегистрированный пользователь может создать несколько приватных или публичных песенников, добавить в них страницы песен, расположить песни в любом порядке и подготовить печатную версию или PDF.		<code>BardSongbooks</code> — самописное расширение MediaWiki для личных песенников Бард-Вики. Зарегистрированный пользователь может создать несколько приватных или публичных песенников, добавить в них страницы песен, расположить песни в любом порядке и подготовить печатную версию или PDF.

	Текущая версия: '''0.2.0'''.		Текущая версия: '''0.2.1'''.

			== Изменения 0.2.1 ==

			* Убраны кнопки вверх/вниз. Порядок сохраняется перетаскиванием.
			* Вместо «Убрать» — SVG-корзина в отдельной правой колонке. Длинные подписи переносятся, не сдвигая корзину.
			* Данные и настройки книг, приватность, поиск и печать не меняются.

	== Возможности ==		== Возможности ==
Строка 26:		Строка 32:
	* одновременный запрос по разным полям: например, по автору и словам из текста;		* одновременный запрос по разным полям: например, по автору и словам из текста;
	* результаты в формате <code>Название (авторы) — Первая строка</code>;		* результаты в формате <code>Название (авторы) — Первая строка</code>;
	* произвольная перестановка песен перетаскиванием ~~или кнопками вверх/вниз~~;		* произвольная перестановка песен перетаскиванием;
	* ссылки на исходные страницы песен в списке и печатном представлении;		* ссылки на исходные страницы песен в списке и печатном представлении;
	* печать песен подряд или каждой с новой страницы;		* печать песен подряд или каждой с новой страницы;
Строка 84:		Строка 90:

	== Обновление ==		== Обновление ==

			Переход с 0.2.0 на 0.2.1 меняет только интерфейс: миграция БД и запуск updater не требуются.

	# Сделайте резервную копию текущего каталога <code>extensions/BardSongbooks</code> и базы данных.		# Сделайте резервную копию текущего каталога <code>extensions/BardSongbooks</code> и базы данных.
Строка 127:		Строка 135:
	=== Порядок песен ===		=== Порядок песен ===

	Песни можно перетаскивать мышью~~. Для клавиатуры и точной перестановки доступны~~ кнопки вверх и вниз. Новый полный порядок сохраняется только для данного песенника.		Песни можно перетаскивать мышью; кнопки вверх и вниз убраны. Новый полный порядок сохраняется только для данного песенника. Чтобы убрать песню, нажмите значок корзины в отдельной правой колонке её строки. Корзина доступна с клавиатуры и имеет подсказку «Убрать песню из песенника». Убирается только запись в песеннике, исходная страница песни остаётся в Wiki.

	=== Приватность, публикация и ссылка ===		=== Приватность, публикация и ссылка ===
Строка 190:		Строка 198:
	Если расширение удаляется окончательно, таблицы <code>bard_songbook_item</code> и <code>bard_songbook</code> можно удалить вручную только после отдельной проверенной резервной копии. Сначала удаляется таблица элементов, затем таблица песенников.		Если расширение удаляется окончательно, таблицы <code>bard_songbook_item</code> и <code>bard_songbook</code> можно удалить вручную только после отдельной проверенной резервной копии. Сначала удаляется таблица элементов, затем таблица песенников.

	== Ограничения версии 0.2.0 ==		== Ограничения версии 0.2.1 ==

	* песенники привязаны к текущим версиям страниц песен и не фиксируют конкретную ревизию;		* песенники привязаны к текущим версиям страниц песен и не фиксируют конкретную ревизию;

Admin: BardSongbooks 0.2.0: публичные книги, каталог и доступ по ссылке

2026-10-06T12:10:13Z

BardSongbooks 0.2.0: публичные книги, каталог и доступ по ссылке

Внесённые изменения

Admin: BardSongbooks 0.1.9: оглавление и мелкий список

2026-09-20T13:25:13Z

BardSongbooks 0.1.9: оглавление и мелкий список

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

= BardSongbooks =

'''BardSongbooks''' — самописное расширение MediaWiki для личных песенников Бард-Вики. Зарегистрированный пользователь может создать несколько закрытых песенников, добавить в них страницы песен, расположить песни в любом порядке и подготовить печатную версию или PDF.

Текущая версия: '''0.1.9'''.

== Скачать ==

* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.1.9.zip BardSongbooks 0.1.9 — ZIP]
* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/BardSongbooks-0.1.9.tar.gz BardSongbooks 0.1.9 — TAR.GZ]
* [https://new.bard-wiki.net/downloads/extensions/BardSongbooks/SHA256SUMS Файл SHA256SUMS]

<pre>
de67bbdf31e67b78a01d22c4dd097aafcb89561e79aaaf2737210b88b569a247 BardSongbooks-0.1.9.zip
09246223c66260ca94962bf38753c9e81982eb9e1e9b9d3fbaea395604dd6c94 BardSongbooks-0.1.9.tar.gz
</pre>

Архив распаковывается в каталог <code>BardSongbooks/</code>. Лицензия: GPL-2.0-or-later.

== Возможности ==

* несколько приватных песенников у одного пользователя;
* добавление песни прямо со страницы песни или из поиска в редакторе;
* управление добавлением в служебной панели темы: справа в инструментах Vector 2022 и слева в старых Vector/MonoBook;
* поиск по основному, альтернативному и оригинальному названию, композиторам, авторам текста, первой строке и всему индексированному тексту песни;
* одновременный запрос по разным полям;
* результаты вида <code>Название (авторы) — Первая строка</code>;
* произвольная перестановка песен перетаскиванием или кнопками вверх/вниз;
* ссылки на исходные страницы песен;
* печать песен подряд или каждой с новой страницы;
* от одной до трёх колонок внутри песни и размер шрифта от 8 до 16 пунктов;
* сохранение строф целиком при разбиении на колонки;
* возможность скрыть сведения о песне;
* режим «Только первый раздел песни», исключающий следующие разделы, например «Аккорды»;
* дополнительное нумерованное оглавление без номеров страниц со ссылками на песни внутри печатного представления;
* печать и сохранение в PDF средствами браузера.

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

* MediaWiki 1.43 или новее;
* PHP 8.1 или новее; выпуск проверен на PHP 8.3;
* MySQL или MariaDB, поддерживаемые установленной версией MediaWiki;
* расширение Cargo и таблица <code>cargo__song</code>;
* стандартный полнотекстовый индекс MediaWiki <code>searchindex</code>.

Поиск ожидает поля Cargo <code>Name</code>, <code>AlterName__full</code>, <code>OriginalName__full</code>, <code>Composer__full</code>, <code>Lyric__full</code>, <code>FirstString</code> и <code>_pageID</code>. Для другой схемы Cargo код поиска потребуется адаптировать.

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

# Сделайте резервную копию базы данных, каталога расширений и <code>LocalSettings.php</code>.
# Распакуйте архив в <code>extensions/BardSongbooks</code>. Файл манифеста должен оказаться по пути <code>extensions/BardSongbooks/extension.json</code>.
# Добавьте в <code>LocalSettings.php</code>:

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

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

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

# Проверьте версию на странице [[Служебная:Версия]].
# Войдите как зарегистрированный пользователь и откройте [[Служебная:Мои песенники]].

== Обновление ==

# Сохраните текущий каталог <code>extensions/BardSongbooks</code> и базу данных.
# Замените каталог файлами новой версии.
# Выполните <code>php maintenance/run.php update --quick</code>.
# При необходимости очистите кеш браузера.
# Проверьте создание песенника, поиск, перестановку и печатную версию.

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

=== Создание ===

Откройте «Мои песенники» в пользовательском меню или [[Служебная:Мои песенники]], введите название и нажмите «Создать». Один пользователь может иметь до 50 песенников. Названия песенников одного пользователя не повторяются.

=== Добавление и поиск ===

Песню можно добавить со страницы самой песни либо найти в редакторе песенника. В один песенник нельзя дважды добавить одну страницу; предел — 500 песен.

Запрос разбивается максимум на десять слов. Каждое слово должно встретиться хотя бы в одном поддерживаемом поле, но разные слова могут находиться в разных полях. Это позволяет одновременно искать по автору, части названия и словам из текста. Минимальная длина запроса — два символа, за один запрос возвращается до 30 результатов.

=== Порядок ===

Песни можно перетаскивать мышью либо перемещать кнопками вверх и вниз. Порядок хранится отдельно для каждого песенника.

=== Печать и PDF ===

В редакторе выбираются расположение песен, 1–3 колонки внутри песни, размер шрифта, показ сведений и режим первого раздела. Строфы распределяются между колонками целиком. Заголовки остаются ссылками на исходные страницы.

Кнопка «Печать / сохранить в PDF» открывает системный диалог браузера. Серверный PDF-файл расширение не создаёт.

Режим «Только первый раздел песни» отбрасывает содержимое начиная со следующего прямого заголовка H2–H6 и подходит для исключения раздела «Аккорды».

Флажок «Оглавление» добавляет перед песнями нумерованный список без номеров страниц. Названия в списке являются внутренними ссылками и переводят к соответствующей песне в превью; ссылки могут сохраняться и в PDF, если это поддерживает выбранный PDF-принтер браузера. При режиме «Каждая песня с новой страницы» первая песня начинается с новой страницы после оглавления.

== Данные и безопасность ==

Расширение создаёт только собственные таблицы:

* <code>bard_songbook</code> — владелец, название и параметры печати;
* <code>bard_songbook_item</code> — страницы песен и их порядок.

Страницы песен, PageForms, шаблоны, Lua-модули и Cargo-данные не изменяются.

Право <code>bard-songbooks-use</code> по умолчанию выдано группе <code>user</code>. Анонимным посетителям песенники недоступны. Изменения требуют входа, проверки владельца, POST-запроса и CSRF-токена MediaWiki.

== Откат и удаление ==

Для отката верните сохранённый каталог предыдущей версии и выполните <code>php maintenance/run.php update --quick</code>.

Для отключения удалите или закомментируйте <code>wfLoadExtension( 'BardSongbooks' );</code>. Таблицы и песенники при этом сохраняются.

Удалять таблицы вручную следует только при окончательном удалении расширения и после отдельной проверенной резервной копии. Сначала удаляется <code>bard_songbook_item</code>, затем <code>bard_songbook</code>.

== Ограничения версии 0.1.9 ==

* песенник использует текущую версию страницы песни и не фиксирует ревизию;
* совместный доступ и публичная публикация песенника отсутствуют;
* PDF создаётся браузером;
* полнотекстовый поиск зависит от актуальности индекса MediaWiki;
* Cargo-поиск привязан к структуре Бард-Вики.

== История выпусков ==

; 0.1.9
: Мелкий шрифт подписей в списке песен; сохраняемое нумерованное оглавление без номеров страниц с внутренними ссылками на песни.
; 0.1.8
: Ссылка с [[Служебная:Версия]] на эту документацию; рабочая логика 0.1.7 не менялась.
; 0.1.7
: Блок убран из содержимого статьи и перенесён в служебную панель темы. В Vector 2022 он следует за «Инструментами» в правой закреплённой колонке либо в раскрывающемся меню; в старых Vector и MonoBook находится в левой колонке.
; 0.1.6
: Блок добавления песни перенесён в компактную правую колонку; на экранах до 720 пикселей он остаётся в обычном потоке, а при печати скрывается.
; 0.1.5
: Полная документация, журнал изменений, лицензия и публичные установочные архивы. Функциональность 0.1.4 не менялась.
; 0.1.4
: Ссылки на страницы песен и сохранение строф при распределении по колонкам.
; 0.1.3
: Полнотекстовый поиск, альтернативные названия и режим первого раздела.
; 0.1.1
: Составной поиск по названию, авторам и первой строке.
; 0.1.0
: Первый рабочий выпуск личных песенников.

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