Руководство пользователя
Метаданные
Метатеги — это способ предоставления информации о песне, выраженный в разделе метаданных. Метаданные выражаются в первом разделе песни перед первой пустой строкой или до тех пор, пока больше не встречаются метатеги. Метатеги — это пары имя/значение, где имя находится слева, а значение справа, разделенные двоеточием. В одной строке может появиться только один метатег. Пожалуйста, обратитесь к Формату файла ChordPro для получения подробной информации о том, как выражать метаданные в формате ChordPro.
OnSong автоматически присваивает первую строку текстового файла в качестве названия песни, если она не в формате метатега. Кроме того, вторая строка считается исполнителем/подписью песни, если не определен метатег. Ниже приведен пример типичного раздела метаданных песни, который устанавливает название и исполнителя в качестве первой и второй строк, а также тональность и темп.
Amazing Grace
Daniel Thomas
Key: D
Tempo: 76
Лирика и аккорды начинаются здесь...
Теги метаданных
OnSong поддерживает следующие теги:
- Название: Название песни. Это также может быть выражено в первой строке содержимого песни.
- Исполнитель: Имя исполнителя или любая другая информация подписи. Это также может быть выражено во второй строке содержимого песни. Вы можете указать нескольких исполнителей, разделяя имена точкой с запятой. - Kim Walker-Smith; Chris Quilala
- Автор: Имя человека, который создал таблицу аккордов. Это отображается в нижней части таблицы аккордов и при проецировании лирики.
- Тональность: Тональность песни, написанная с энгармонической предпочтением и необязательной буквой «m» для обозначения минора. - буквенно-цифровое обозначение, например Bb или Em
- TransposedKey: Желаемая тональность, в которой должна воспроизводиться песня, которая может отличаться от тональности, в которой написана песня. - буквенно-цифровое обозначение, например Bb или Em
- In: является синонимом метатега транспонированной тональности.
- Каподастр: Каподастр для установки как количество ладов. Это обычно положительное целое число (от 1 до 11), но также может быть отрицательным целым числом. - числовое
- Темп: Количество ударов в минуту (BPM). - числовое
- Размер: Размер такта. - числовое обозначение, например 3/4
- Длительность: Длина песни для автопрокрутки. - секунды или мм:сс
- Книга: Название книги или книг для размещения песни. Это разделенный запятыми список названий книг, в которые будет помещена песня. Если книга не существует, она будет автоматически создана.
- Номер: Номер песни - числовое. Используйте для гимнов, лет и т. д. Вы можете сортировать песни по номеру для справки.
- Порядок: Расположение секций. - список меток секций. Смотрите Порядок для получения информации об упорядочении последовательности песни.
- MIDI: Команды MIDI для отправки при просмотре песни. Смотрите Синтаксис MIDI для получения информации о том, как выражать команды MIDI в виде текста в OnSong.
- MIDI-Index: Команды MIDI, которые вызовут открытие этой песни в Просмотре песни. Смотрите Синтаксис MIDI для получения информации о том, как выражать команды MIDI в виде текста в OnSong.
- Ключевые слова: или Тема: Список теговых поисковых терминов. Смотрите Темы для получения дополнительной информации о поиске по темам.
- Авторские права: или Нижний колонтитул: или f: Информация об авторских правах песни. Это будет отображаться в нижней части таблицы аккордов и при проецировании лирики.
- CCLI: Номер CCLI песни. Это будет отображаться в нижней части таблицы аккордов и при проецировании лирики.
- Ограничения: Это ограничения, которые предотвращают выполнение определенных действий в песне. Смотрите Ограничения для получения подробной информации об установке ограничений для вашей песни.
- Высота звука: Нота или ноты для воспроизведения при использовании функции Свисток для определения высоты. Это определяется как разделенный пробелами список нот с необязательными октавами. - например A3 C#4 E5
- Подразделение: или Доля: позволяет выбрать подразделение для песни. Это может быть значение, включающее: целое, половину, четверть, восьмую, шаффл или шестнадцатую. Также можно использовать целое число, например 1, 2, 4, 8 или 16.
- Транспозиция: Количество полутонов для транспонирования песни. Это используется в середине песни для модуляции песни вверх или вниз и адаптируется к тональности, установленной в ползунках транспозиции. Это число должно быть положительным или отрицательным целым числом.
- Настройка: Настройка инструмента, которую нужно назначить песне. Они специфичны для инструмента, и в настоящее время только гитара поддерживается со следующими значениями: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G или Open E.
- Сцена: Сцена, которая должна воспроизводиться при загрузке песни. Это можно установить, введя название сцены после двоеточия.
Встроенные теги
Некоторые теги можно использовать в песне для эффекта транспозиции в середине песни. К ним относятся:
- Каподастр: можно использовать для применения каподастра в середине песни, модулируя песню вниз, чтобы обеспечить аккорды для воспроизведения с применяемым каподастром. Вы можете отрегулировать направление модуляции в Параметры каподастра. Это обычно положительное целое число (от 1 до 11), но также может быть отрицательным целым числом для удаления предыдущего каподастра. - числовое
- Тональность: для явной установки тональности в песне. Если вы окружите значение скобками при использовании скобочных аккордов, результирующая тональность также будет транспонирована. - буквенно-цифровое обозначение, например Bb или Em
- Транспозиция: транспонирует песню на желаемое количество полутонов. Это положительное или отрицательное целое число. Например, используйте 2 или +2 для транспонирования песни на целый шаг вверх, или используйте -3 для транспонирования вниз на три полутона. - числовое
Теги секций
Некоторые теги можно использовать для предоставления информации о каждой секции песни. К ним относятся:
- MIDI: Команды MIDI для отправки при выборе секции. Смотрите Синтаксис MIDI для получения информации о том, как выражать команды MIDI в виде текста в OnSong.
- Сцена: Сцена, которая должна воспроизводиться при выборе секции. Это можно установить, введя название сцены после двоеточия.
Примечание: метатеги чувствительны к регистру