Метаданні

Метатеги — це спосіб надання інформації про пісню, яка виражається в розділі метаданих. Метадані виражаються в першому розділі пісні перед першим порожнім рядком або до тих пір, поки не будуть знайдені метатеги. Метатеги — це пари назва/значення, де назва знаходиться зліва, а значення справа, розділені двокрапкою. На одному рядку може з'явитися лише один метатег. Будь ласка, зверніться до Формату файлу 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: Нота або ноти для відтворення при використанні функції Pitch Pipe. Це визначається як список ніт, розділених пробілами, з опціональними октавами. - наприклад 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: можна використовувати для застосування каподастра в середині пісні, модулюючи пісню вниз для надання акордів для гри з застосованим каподастром. Ви можете відрегулювати напрямок модуляції в Параметрах Capo. Зазвичай це позитивне число (від 1 до 11), але також може бути встановлено від'ємне число для видалення попереднього каподастра. - числове
• Key: для явного встановлення ключа в пісні. Якщо ви оточите значення дужками при використанні дужкових акордів, результуючий ключ також буде транспонований. - буквено-цифровий, наприклад Bb або Em
• Transpose: транспонує пісню на бажану кількість півтонів. Це позитивне або негативне число. Наприклад, використовуйте 2 або +2 для транспонування пісні на цілий тон вгору, або використовуйте -3 для транспонування вниз на три півтони. - числове

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

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

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

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