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: ...} Ноти для відтворення при використанні функції Камертон.
• {keywords: ...} або {topic: ...} Список тегів для пошуку за темами. Дивіться Теми для отримання додаткової інформації про пошук за темами.
• {copyright: ...} або {footer: ...} або {f: ...} Задає текст авторських прав для появи внизу сторінки або при проекції тексту.
• {ccli: ...} Номер CCLI пісні.
• {restrictions: ...} Управління правами для пісні, список обмежень, розділений комами. Дивіться Обмеження для деталей щодо встановлення обмежень для вашої пісні.
• {composer: ...} Особи, які написали музику до пісні. Цей список повинен бути розділений крапками з комами для окремих значень.
• {lyricist: ...} Особи, які написали текст пісні. Цей список повинен бути розділений крапками з комами для окремих значень.

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

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

• {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