Метаданные

Метатеги — это способ предоставления информации о песне, выраженный в разделе метаданных. Метаданные выражаются в первом разделе песни перед первой пустой строкой или до тех пор, пока больше не встречаются метатеги. Метатеги — это пары имя/значение, где имя находится слева, а значение справа, разделенные двоеточием. На одной строке может появиться только один метатег. Пожалуйста, обратитесь к Формату файла ChordPro для получения подробной информации о том, как выражать метаданные в формате ChordPro.

OnSong автоматически назначает первую строку текстового файла в качестве названия песни, если она не в формате метатега. Кроме того, вторая строка считается исполнителем/авторством песни, если не определен метатег. Ниже приведен пример типичного раздела метаданных песни, который устанавливает название и исполнителя в качестве первой и второй строк, а также тональность и темп.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Теги метаданных

Следующие теги поддерживаются OnSong:

• Title: Название песни. Это также может быть выражено в первой строке содержимого песни.
• Artist: Имя исполнителя или любая другая информация об авторстве. Это также может быть выражено во второй строке содержимого песни. Вы можете указать нескольких исполнителей, разделяя имена точкой с запятой. - Kim Walker-Smith; Chris Quilala
• Author: Имя человека, создавшего таблицу аккордов. Это отображается в нижней части таблицы аккордов и в проекции текстов.
• Key: Тональность песни, написанная как тональность с предпочтением энгармонического эквивалента и дополнительным "m" для обозначения минора. - буквенно-цифровой формат, например Bb или Em
• TransposedKey: Желаемая тональность, в которой должна быть сыграна песня, которая может отличаться от тональности, в которой написана песня. - буквенно-цифровой формат, например Bb или Em
• In: является синонимом метатега транспонированной тональности.
• Capo: Каподастр, установленный как количество ладов. Обычно это положительное целое число (от 1 до 11), но может быть также отрицательным целым числом. - числовой
• Tempo: Количество ударов в минуту (BPM). - числовой
• Time: Размер такта. - числовой формат доля/такт, например 3/4
• Duration: Длительность песни для автопрокрутки. - секунды или мм:сс
• Book: Название книги или книг, в которые поместить песню. Это разделенный запятыми список названий книг, в которые будет помещена песня. Если книга не существует, она будет автоматически создана.
• Number: Номер песни - числовой. Используется для гимнов, лет и т. д. Вы можете сортировать песни по номеру для справки.
• Flow: Расположение разделов. - список меток разделов. См. Flow для получения информации об организации последовательности песни.
• MIDI: Команды MIDI для отправки при просмотре песни. См. Синтаксис MIDI для получения информации о том, как выражать команды MIDI в виде текста в OnSong.
• MIDI-Index: Команды MIDI, которые вызовут открытие этой песни в Просмотрщике песен. См. Синтаксис MIDI для получения информации о том, как выражать команды MIDI в виде текста в OnSong.
• Keywords: или Topic: Список тегов для использования при поиске по темам. См. Темы для получения дополнительной информации о просмотре по темам.
• Copyright: или Footer: или f: Информация об авторских правах песни. Это будет появляться в нижней части таблицы аккордов и проекции текстов.
• CCLI: Номер CCLI песни. Это будет появляться в нижней части таблицы аккордов и проекции текстов.
• Restrictions: Это ограничения, которые предотвращают определенные действия в песне. См. Ограничения для получения информации об установке ограничений для вашей песни.
• Pitch: Нота или ноты для воспроизведения при использовании функции Камертон. Это определяется как разделенный пробелами список нот с дополнительными октавами. - например A3 C#4 E5
• Subdivision: или Beat: позволяет выбрать подразделение для песни. Это может быть значение, включающее: whole, half, quarter, eighth, shuffle или sixteenth. Альтернативно можно использовать целое число, такое как 1, 2, 4, 8 или 16.
• Transpose: Количество полутонов для транспонирования песни. Это используется в середине песни для модуляции песни вверх или вниз и адаптируется в соответствии с тональностью, установленной в ползунках транспозиции. Это число должно быть положительным или отрицательным целым числом.
• Tuning: Настройка инструмента для назначения песне. Они специфичны для инструмента, и в настоящее время только гитара поддерживается со следующими значениями: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G или Open E.
• Scene: Сцена для воспроизведения при загрузке песни. Это можно установить, введя имя сцены после двоеточия.

Встроенные теги

Некоторые теги можно использовать внутри песни для влияния на транспозицию в середине песни. К ним относятся:

• Capo: может быть использован для применения каподастра в середине песни, модулируя песню вниз, чтобы обеспечить аккорды для воспроизведения с применяемым каподастром. Вы можете отрегулировать направление модуляции в Параметрах каподастра. Обычно это положительное целое число (от 1 до 11), но может быть также отрицательным целым числом для удаления предыдущего каподастра. - числовой
• Key: для явного установления тональности в песне. Если вы заключите значение в скобки при использовании аккордов в скобках, результирующая тональность также будет транспонирована. - буквенно-цифровой формат, например Bb или Em
• Transpose: транспонирует песню на желаемое количество полутонов. Это положительное или отрицательное целое число. Например, используйте 2 или +2 для транспонирования песни на целый шаг вверх, или используйте -3 для транспонирования на три полутона вниз. - числовой

Теги разделов

Некоторые теги можно использовать для предоставления информации о каждом разделе песни. К ним относятся:

• MIDI: Команды MIDI для отправки при выборе раздела. См. Синтаксис MIDI для получения информации о том, как выражать команды MIDI в виде текста в OnSong.
• Scene: Сцена для воспроизведения при выборе раздела. Это можно установить, введя имя сцены после двоеточия.

Примечание: метатеги не чувствительны к регистру