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 命令。有关如何在 OnSong 中以文本形式表达 MIDI 命令的详细信息，请参阅 MIDI 语法。
• {midi-index: ...} 将触发在 歌曲查看器 中打开此歌曲的 MIDI 命令。有关如何在 OnSong 中以文本形式表达 MIDI 命令的详细信息，请参阅 MIDI 语法。
• {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