ChordPro

Формат файлу ChordPro — це поширений формат, який використовується в інших програмних застосунках. OnSong розуміє цей формат нативно. OnSong розпізнає файли з такими розширеннями: .chordpro, .chopro, .cho, .crd, .pro

Формат ChordPro дозволяє виражати інформацію про пісню в тегах, розділених фігурними дужками. Цю інформацію можна логічно розділити на теги метаданих і вбудовані теги.

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

Це теги ChordPro, які ви використовуватимете в розділі метаданих пісні. У наступних тегах три крапки (...) представляють текст, який ви надаєте, що розміщується між двокрапкою та закриваючою фігурною дужкою. Наприклад:

{title: Amazing Grace}
{key: G}

OnSong підтримує такі теги ChordPro:

• {title: ...} або {t: ...} Назва пісні.
• {subtitle: ...}, {st: ...} або {su: ...} Ім'я виконавця або будь-яка інша інформація в підзаголовку. Ви можете вказати кількох виконавців, розділивши імена крапкою з комою. - Kim Walker-Smith; Chris Quilala
• {album: ...} Назва альбому, в якому розташована пісня.
• {artist: ...} або {a: ...} Ім'я виконавця або будь-яка інша інформація в підзаголовку. Ви можете вказати кількох виконавців, розділивши імена крапкою з комою. - Kim Walker-Smith; Chris Quilala
• {author: ...} Ім'я особи, яка створила таблицю акордів. Це відображається внизу таблиці акордів і в проекції текстів.
• {key: ...} або {k: ...} або {ok: ...} Тональність пісні, написана як тональність з енгармонічною перевагою та необов'язковою літерою «m» для позначення мінору. - буквено-цифровий, наприклад Bb або Em
• {capo: ...} Капо, встановлене як кількість ладів - цифровий
• {tempo: ...} Кількість ударів на хвилину (BPM) - цифровий
• {time: ...} Розмір такту - цифровий, частка на такт, наприклад 3/4
• {duration: ...} Тривалість пісні для автоскролінгу - секунди або мм:сс
• {book: ...} Назва книги або книг, у яких розташовується пісня. Це список імен книг, розділених комами, в які буде розміщена пісня. Якщо книга не існує, вона буде створена автоматично.
• {number: ...} Номер пісні - цифровий, використовується для гімнів, років тощо. Ви можете сортувати пісні за номером для посилання.
• {flow: ...} Розташування розділів — список міток розділів. Див. Послідовність для деталей про розташування послідовності пісні.
• {midi: ...} Команди MIDI для відправлення при перегляді пісні. Див. Синтаксис MIDI для інформації про те, як виразити команди MIDI як текст у OnSong.
• {midi-index: ...} Команди MIDI, які запустять цю пісню для відкриття в Переглядачі пісень. Див. Синтаксис MIDI для інформації про те, як виразити команди MIDI як текст у OnSong.
• {pitch: ...} Ноти для програвання при використанні функції Pitch Pipe.
• {keywords: ...} або {topic: ...} Список тегів для використання з пошуком за темами. Див. Теми для отримання додаткової інформації про перегляд за темами.
• {copyright: ...} або {footer: ...} Визначає текст копірайту внизу сторінки або проекції текстів.
• {ccli: ...} Номер CCLI пісні.
• {restrictions: ...} Управління правами для списку обмежень пісні, розділених комами. Див. Обмеження для деталей про встановлення обмежень для вашої пісні.

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

Ці теги використовуються у вмісті пісні і можуть використовуватися для визначення розділів або форматування частин пісні.

• {define: ...} використовується для визначення користувацьких діаграм акордів. Див. Визначення акордів для отримання додаткової інформації.
• {comment: ...} або {c: ...} Визначає коментар і відображається як музична інструкція.
• {comment_bold: ...} або {cb: ...} Визначає текст, який повинен відображатися жирним шрифтом.
• {comment_italic: ...} або {ci: ...} Визначає текст, який повинен відображатися курсивом.
• {guitar_comment: ...} або {gc: ...} Визначає коментар, який відображається як музична інструкція.
• {start_of_verse: ..} або {sov} Оголошує початок розділу куплету з необов'язковою міткою розділу.
• {end_of_verse} або {eov} Оголошує кінець розділу куплету.
• {start_of_chorus: ...} або {soc} Оголошує початок розділу припіву з необов'язковою міткою розділу.
• {end_of_chorus} або {eoc} Оголошує кінець розділу припіву.
• {start_of_bridge: ...} або {sob} Оголошує початок розділу переходу з необов'язковою міткою розділу.
• {end_of_bridge} або {eob} Оголошує кінець розділу переходу.
• {start_of_part: ..} або {sop} Оголошує початок частини з необов'язковою міткою розділу.
• {end_of_part} або {eop} Оголошує кінець частини.
• {start_of_tab} або {sot} Оголошує початок таблатури, яку OnSong відображає моноширинним шрифтом.
• {end_of_tab} або {eot} Оголошує кінець розділу таблатури.
• {new_page} або {np} Це використовується для оголошення нової сторінки.
• {new_physical_page} або {npp} Це використовується для оголошення нової сторінки.

Теги форматування

Наступні теги використовуються для визначення стандартного шрифту та розміру для текстів і акордів у таблиці акордів.

• {textsize: ...} Визначає розмір текстів як числове значення в пунктах.
• {textfont: ...} Визначає назву шрифту для використання текстів. Повинен бути підтримуваний на платформі.
• {chordsize: ...} Визначає розмір акордів як числове значення в пунктах.
• {chordfont: ...} Визначає назву шрифту для використання акордів. Повинен бути підтримуваний на платформі.

Підтримувані розширення файлів

Формат файлу ChordPro унікальний тим, що це загальноприйнятий синтаксис, але не стандартний формат. Це означає, що різні постачальники можуть реалізовувати його по-різному та з різними розширеннями файлів. OnSong підтримує наступні розширення файлів при імпорті файлів у форматі ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm