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: ...} Длительность песни для автопрокрутки - в секундах или в формате mm:ss
• {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