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 命令。有关如何在 OnSong 中将 MIDI 命令表示为文本的信息，请参阅 MIDI Syntax。
• {midi-index: ...} 将触发此歌曲在 Song Viewer 中打开的 MIDI 命令。有关如何在 OnSong 中将 MIDI 命令表示为文本的信息，请参阅 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