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 в виде текста в OnSong см. в разделе Синтаксис MIDI.
• {midi-index: ...} Команды MIDI, которые будут вызывать открытие этой песни в Просмотрщике песен. Подробнее о выражении команд MIDI в виде текста в OnSong см. в разделе Синтаксис MIDI.
• {pitch: ...} Ноты для воспроизведения при использовании функции Камертон.
• {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