Здравствуйте, друзья. Как и обещал расскажу подробнее о папках и файлах.
Преамбула
Сама концепция Opensong-совместимых приложений подразумевает, что программы и сами песни хранятся раздельно. В настройках программы можно указать, песни из какой именно папки будут открыты для работы. Это позволяет хранить на одном компьютере несколько отдельных баз, например песенные сборники разных церквей или песни на разных языках. Все программы совместимые с Opensong используют одинаковую структуру каталогов и вложенных подкаталогов, что очень удобно.
Рассмотрим структуру каталогов на примере программы Open Chords. Я пользуюсь её на протяжении нескольких лет и новичкам рекомендую именно её.
Существует установочная (Installer) и переносная (Portable) версия, и их способы хранения данных несколько отличаются.
Ссылка на архив версий тут.
Установочная версия (Installer)
Думаю, большинство людей на настольном компьютере пользуется Windows, поэтому рассмотрим работу на примере этой операционной системы. Скачиваем дистрибутив (исполнимый файл для установки программы). Последнюю версию можно скачать здесь и запускаем его.
Свою стартовую папку при установке программа создает сама. По умолчанию она размещается в
C:\Users\ИмяПользователя\Documents\Open Chords\
Изначально там будет находится несколько песен на английском, которые идут в комплекте с программой.
Если вы устанавливайте программу в первый раз и не имеете опыта работы, то я рекомендую просто добавить скачанные песни в папку уже созданную программой.
Если вы захотите использовать другой каталог для работы то в настройках необходимо указать его. Предыдущий при этом никуда не денется (пока вы вручную его не удалите разумеется) и вы всегда сможете вернуться к нему.
Если вы хотите пользоваться базой собранной нами или сообществом Worship Leader App скачайте её здесь и укажите эту папку со скачанными песнями в настройках.
Переносная версия (Portable)
Скачать последнюю версию можно здесь.
Она не требует установки и может работать с флешки, переносного диска и т.п. Просто распаковываете архив в нужную папку.
Если вы пользуйтесь переносной версией (в настройках галочкой отмечен пункт Portable Mode) то песни по умолчанию будут хранится в папке: ВашДиск:\ПапкаПрограммы\App\Data\Songs
Структура папки Data повторяет Open Chords для установочной версии.
Структура каталогов (папок)
Обычно дерево каталогов выглядит так:
\OpenSongIcf\..- рабочий каталог программы с несколькими вложенными файлами и исполнимым файлом программы, вообще то по умолчанию она называется “Open Chords”, но я переименовал, в личных целях, так как на моем ПК баз несколько;
\Export\.. - каталог экспортированных песен, в нем обычно две папки:
\Print\ файлы после экспорта на печать, и
\Tablet\ файлы после экспорта в HTML, кстати, можно перевести всю базу песен в html одной командой, потом их можно разместить на сайте, просмотреть в браузере и т.д.;
\Sets\- каталог с сохраненными списками песен;
\Settings\ - каталог с настройками программы (во избежание проблем лучше здесь ничего не трогать);
\Songs\ - каталог содержащий сами файлы песен.
XML
Итак, каждая песня хранится в отдельном файле. Как я уже говорил, используется формат XML. Структурированный язык разметки. В случае с Opensong файлы с песнями не имеют расширения. Это несколько усложняет работу. Например пред-просмотр встроенными средствами операционной системы. Почему именно так сделано, я не знаю. Возможно разработчики руководствовалиcь какими то своими соображениями.
Структура файла Opensong
Вот мы и добрались до самой важной части статьи. Рассмотрим более подробно содержание файла с песней. Скачайте наш тестовый файл отсюда. Это широко известный гимн прославления Amazing Grace. И откройте в текстовом редакторе, например в программе WordPad. Это простой редактор, который поставляется с Windows. Если не знаете, то обычно можно найти в Кнопка Пуск > Все программы > (крутим список в самый низ) > Стандартные
(Осторожно - красноглазие - пути назад нетъ!)
Какая информация о песне храниться в файле?
<?xml version="1.0" encoding="utf-8"?> - В начале файла перечисляются служебные данные о стандарте XML и кодировке страницы.
<song...>- заявляется, что это песня
Затем описание визуального оформления в тэгах <style></style>.
Далее в тэгах описывается:
<title>Amazing Grace</title>- название песни
<author>John Newton</author>- автор
<presentation>V3 V1 V2 V4</presentation> - порядок показа частей
<capo>0</capo>- расположение каподастра для щипковых инструментов, в нашем случае никакого каподастра не нужно.
<key>D</key>- тональность, в нашем случае Ре мажор, она автоматически меняется при транспонировании, поэтому при создании песни лучше её указать правильно.
Далее следует самая объемная и самая важная часть файла:
<lyrics>
[V1]
. D D7 G D
Amazing grace how sweet the sound
. Bm E A A7
that saved a wretch like me;
. D D7 G D
I once was lost but now I'm found,
. Bm A G D
was blind but now I see.
[V2]
. D D7 G D
Twas grace that taught my heart to fear,
. Bm E A A7
and grace my fears relieved;
. D D7 G D
How precious did that grace appear
. Bm A G D
the hour I first believed!
[V3]
. D D7 G
Through many dangers, toils,
. D Bm E A A7
and snares I have already come;
. D D7 G D
'Tis grace that brought me safe thus far
. Bm A G D
and grace will lead me home.
[V4]
. D D7 G
When we've been there ten thousand
.D Bm E A A7
years bright shining as the sun;
. D D7 G D
We've no less days to sing God's praise
. Bm A G D
than when we'd first begun!
</lyrics>
-собственно сам текст песни с аккордами. Подробное описание достойно отдельной статьи, но на самом деле здесь все просто:
. - строки начинающиеся с точки, это буквенные обозначения аккордов, они будут изменяться при транспонировании.
_ - строки начинающиеся с пробела это сами слова песни (стихи).
[V1] - тэги в квадратных скобках, это обозначения частей песни, например [V1] это первый куплет (от слова английского слова “Verse” - куплет). Тэг действует до следующего тэга или до конца раздела </lyrics>. О тэгах opensong я еще расскажу подробнее в будущем.
<ccli>1037882</ccli>- код песни в CCLI это такая “международная христианская” лицензия на тексты песен, в России и СНГ, насколько я знаю такой лицензии ни у кого нет, нам от неё не горячо ни холодно;
<preferFlats>False</preferFlats> - используются ли аккорды с бемолем (в нашем случае указано False (ложь) - отключено);
<tempo /> - точный темп bpm (удары в минуту), тут не указан;
<time_sig /> - размер (4/4, 3/8 и т.д.)
<hymn_number /> -номер гимна, например можете создать свою внутреннюю нумерацию;
<notes>
[V3]
slow and worshipful
[V1]
switch to 4/4
timing
with palm muting
add light drums
[V2]
heavy
[V4]
heavy
sharp ending
on D
[G]
do V3 original
song then switch to
4/4 timing
</notes>
-примечания к частям для исполнителей (как нужно играть песню), обратите внимание, что тэги примечаний соответствуют <lyrics>, то есть мы можем прописать примечания отдельно для каждой части
</song> - закрывающий тег, сообщающий, что информация о песне закончилась.
При чтении файла OpenChords просто переносит данные из файла в свои поля, например из <title> в Название песни, из <key> в Тональность и т.д. Получается очень просто и красиво. При этом вся текстовая информация, занимает обычно 1-2 кб. То есть вся база проекта Лидер Поклонения, а это около 12000 русских песен, занимает менее 9 Мб. Значит это еще и компактно!
Итоги
Как вы сами можете видеть:
- все довольно просто, наглядно и понятно даже человеку без специальной подготовки;
- кроме специальных программ файл можно просмотреть и отредактировать в любом текстовом редакторе, например в Windows это Блокнот, WordPad, Notepad++, Microsoft Word, Libre Office Writer и т.п.
Я считаю это важными преимуществами по сравнению с любыми закрытыми проприетарными форматами.
Читайте еще: