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: ...} Расположение секций — список меток секций. Подробнее см. в разделе Flow.
• {midi: ...} Команды MIDI, которые отправляются при просмотре песни. Подробнее см. в разделе MIDI Syntax.
• {midi-index: ...} Команды MIDI, которые будут открывать эту песню в Song Viewer. Подробнее см. в разделе MIDI Syntax.
• {pitch: ...} Ноты для воспроизведения при использовании функции Pitch Pipe.
• {keywords: ...} или {topic: ...} Список тегов для использования при поиске по темам. Подробнее см. в разделе Topics.
• {copyright: ...} или {footer: ...} или {f: ...} Указывает текст копирайта, который появляется внизу страницы или при проекции текстов песен.
• {ccli: ...} Номер CCLI песни.
• {restrictions: ...} Управление правами на песню — разделенный запятыми список ограничений. Подробнее см. в разделе Restrictions.
• {composer: ...} Лица, которые написали музыку к песне. Этот список должен быть разделен точками с запятой для отдельных значений.
• {lyricist: ...} Лица, которые написали текст песни. Этот список должен быть разделен точками с запятой для отдельных значений.

Встроенные теги

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

• {define: ...} используется для определения пользовательских диаграмм аккордов. Подробнее см. в разделе Defining Chords.
• {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