Метадані

Метатеги — це спосіб надання інформації про пісню, яка виражається в розділі метаданих. Метадані виражаються в першому розділі пісні перед першим порожнім рядком або до тих пір, поки більше не буде метатегів. Метатеги — це пари назва/значення, де назва знаходиться ліворуч, а значення праворуч, розділені двокрапкою. Тільки один метатег може з'явитися на рядку. Будь ласка, зверніться до Формату файлу ChordPro для отримання деталей про те, як виражати метадані у форматі ChordPro.

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

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

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

Наступні теги підтримуються 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 пісні. Це з'явиться в нижній частині таблиці акордів та проекції текстів.
• Обмеження: Це обмеження, які запобігають виконанню певних дій у пісні. Див. Обмеження для отримання деталей про встановлення обмежень для вашої пісні.
• Висота звуку: Нота або ноти для відтворення під час використання функції Pipe для висоти звуку. Це визначається як розділений пробілами список нот з опціональними октавами. - наприклад A3 C#4 E5
• Поділ: або Удар: дозволяє вибрати поділ для пісні. Це може бути значення, включаючи: цілий, половина, чверть, восьма, shuffle або шістнадцята. Крім того, ви можете використати ціле число, таке як 1, 2, 4, 8 або 16.
• Транспозиція: Кількість півтонів для транспонування пісні. Це використовується в середині пісні для модуляції пісні вверх або вниз і адаптується до тональності, встановленої в повзунках транспозиції. Це число повинно бути позитивним або негативним цілим числом.
• Сцена: Сцена, яка буде відтворена при завантаженні пісні. Це можна встановити, ввівши ім'я сцени після двокрапки.

Вбудовані теги

Деякі теги можна використовувати в межах пісні для впливу на транспозицію в середині пісні. Вони включають:

• Каподастр: можна використовувати для застосування каподастра в середині пісні, модулюючи пісню для надання акордів для гри з застосованим каподастром. Ви можете відрегулювати напрямок модуляції в Параметри каподастра. Це зазвичай позитивне ціле число (1–11), але може бути також від'ємним числом для видалення попереднього каподастра. - цифрова
• Тональність: для явного встановлення тональності в пісні. Якщо ви оточуєте значення дужками при використанні дужкових акордів, результуюча тональність також буде транспонована. - буквено-цифрова, наприклад Bb або Em
• Транспозиція: транспонує пісню на бажану кількість півтонів. Це позитивне або негативне ціле число. Наприклад, використовуйте 2 або +2 для транспонування пісні на цілий крок вверх, або використовуйте -3 для транспонування на три півтони вниз. - цифрова

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

Деякі теги можна використовувати для надання інформації про кожен розділ пісні. Вони включають:

• MIDI: Команди MIDI для відправки при виборі розділу. Див. Синтаксис MIDI для того, як виражати команди MIDI як текст у OnSong.
• Сцена: Сцена, яка буде відтворена при виборі розділу. Це можна встановити, ввівши ім'я сцени після двокрапки.

Примітка: метатеги не чутливі до регістру