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: ...} 章节的排列 - 章节标签列表。请参阅 流程 以了解有关排列歌曲流程的详细信息。
• {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