Официальный сайт программы "Песенник"

Эта страница написана довольно «коряво» и непонятно.
Правки и предложения — в комментарии.

Все желающие могут активно участвовать в написании справки по программе!

УПРАВЛЕНИЕ ПЕСНЯМИ И ПАПКАМИ

Для добавления, редактирования и удаления песен и папок можно пользоваться меню «Песня» и кнопками панели инструментов. Для добавления песни необходимо выбрать папку (щелкнув по ней левой кнопкой мыши), в которую будет добавляться песня. Редактирование песни может быть вызвано двойным щелчком мыши по песне, или использованием кнопки панели инструментов. Для добавления папки нужно выбрать папку, в которую она будет добавляться. Если поставить галочку под полем для ввода имени новой папки, папка будет добавлена в корень дерева, т.е. на самый верхний уровень. Название песени или папки не должно содержать недопустимые символы, такие как «/», «\», «:», «*», «?», «»», «<«, «>», «|» .

ФОРМАТ ПЕСЕН

Первая строка файла предназначена для записи комментария к песне, который при её просмотре будет выводиться в строку статуса. Все остальные строки — текст песни. Пустые строки, по возможности, не должны содержать пробелов.

Управляющие символы и фразы.

Текст должен отделяться от управляющих символов и фраз (расположенных в начале строки) символами табуляции (больше их нигде нельзя использовать).

• Если строка начинается с символа «!», то вся строка раскрашивается как коментарий (коричневым цветом).

• Если строка начинается с символа «>», то вся строка раскрашивается как аккорды (синим цветом);
• Комментарий также может записываться в начале строки, тогда он должен заканчиваться символом «:».
• Номер куплета записывается в скобках, например «(1)».
• Если строка начинается с символа «-«, это является обозначением того, что далее последует другой вариант песни. Если на панели инструментов нажата кнопка «Страничная Разбивка», тогда под текстом песен выводятся кнопки, соответствующие количеству вариантов песни. Остальные варианты показываются после нажатия соответствующей кнопки. Если кнопка «Страничная Разбивка» не нажата,  то вместо строк с символом «-» рисуется горизонтальная линия (на печать она не выводится), после которых следуют другие варианты песен.
• Если текст начинается с цифры от 1 до 7 или с одной из букв: «E», «B», «G», «D», «A», с последующим символом «)», или с символа «|» (для раскраски табулатур аккордов), то подразумевается номер струны и идёт раскраска табулатуры (также такая раскраска включается между скобками «[«, «]», (тёмно-синим цветом).
• Раскраска повторов (зелёным цветом) включается после символов: «\», «/», «}», перед которыми есть пробел . Аккорды раскрашиваются между символами «<«, «>» (синим цветом).

АВТОФОРМАТИРОВАНИЕ

В редакторе песен предусмотрена возможность автоформатирования текста. Автоформатирование изменяет все строки песни, кроме первой строки и пустых строк, следующим образом: обрезает все пробелы и табуляции в начале и конце строки, заменяет все символы табуляции на пробелы, где нужно убирает пробелы перед знаками препинания или после них и добавляет два символа табуляции в начале строки, т.е. делает промежуточное форматирование для последующего редактирования песни вручную.

ПОИСК ПЕСЕН

Панель быстрого поиска

В программе существует возможность поиска песен. Чтобы открыть панель поиска песен, нужно нажать кнопку, отмеченную на картинке стрелочкой, и ввести слово в поле поиска. Для запуска процесса поиска, нужно нажать кнопку «Найти» под полем ввода текста, или клавишу «Enter». Чтобы прервать поиск, нужно сделать то же самое.

После начала поиска, дерево песен очищается, и в него добавляются найденные песни. Если ни одной песни не найдено, появится сообщение об этом, а дерево останется пустым. Чтобы вернуться к обычному дереву песен, необходимо еще раз нажать кнопку, отмеченную стрелкой. При этом панель поиска закроется, а в дереве развернется выбранный при поиске файл. Если после поиска не было выбрано ни одной песни, то при закрытии формы поиска будет предложено вернуться к последней песне, открытой до начала поиска.

Если поставить галочку «Точное название песни», то будет произведен поиск песни, точно соответствующей введенной фразе. Если галочка не стоит, будут найдены все песни, содержащие введенную фразу. Если стоит галочка «Учитывать регистр», то при поиске будет учитываться регистр символов, т.е. то, заглавными или строчными ли буквами набрана поисковая фраза.

ИЗБРАННЫЕ ПЕСНИ

Чтобы открыть список избранных песен, нужно щелкнуть кнопку со звездочкой на панели инструментов или нажать сочетание клавиш CTRL+SHIFT+F. Чтобы добавить выбранную песню CTRL+SHIFT+A или, щелкнув по песне правой кнопкой, выбрать соответствующий пункт меню.