ChordPro

ChordProファイル形式は、他のソフトウェアアプリケーションで使用されている一般的な形式です。OnSongはこの形式をネイティブで理解します。OnSongは以下のファイル拡張子を持つファイルを認識します：.chordpro、.chopro、.cho、.crd、.pro

ChordPro形式では、曲情報を波括弧で区切られたタグで表現できます。この情報は論理的にメタデータタグとインラインタグに分割できます。

メタデータタグ

これらはChordProタグで、曲のメタデータ部分で使用します。以下のタグでは、3つのドット（...）はあなたが指定するテキストを表し、コロンと閉じ波括弧の間に入ります。例えば：

{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: ...} ページの下部または歌詞投影に表示される著作権フッターテキストを指定します。
• {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