ChordPro

Format ChordPro adalah format umum yang digunakan dalam aplikasi perangkat lunak lainnya. OnSong memahami format ini secara native. OnSong mengenali file dengan ekstensi file berikut: .chordpro, .chopro, .cho, .crd, .pro

Format ChordPro memungkinkan informasi lagu untuk diekspresikan dalam tag yang dibatasi oleh kurung kurawal. Informasi ini dapat dibagi secara logis menjadi tag metadata dan tag inline.

Tag Metadata

Ini adalah tag ChordPro yang akan Anda gunakan di bagian metadata lagu. Dalam tag berikut, tiga titik (...) mewakili teks yang Anda suplai, yang berada di antara titik dua dan kurung kurawal penutup. Sebagai contoh:

{title: Amazing Grace}
{key: G}

OnSong mendukung tag ChordPro berikut:

• {title: ...} atau {t: ...} Judul lagu.
• {subtitle: ...}, {st: ...} atau {su: ...} Nama artis atau informasi byline lainnya. Anda dapat menentukan beberapa artis dengan memisahkan nama dengan titik koma. - Kim Walker-Smith; Chris Quilala
• {album: ...} Nama album tempat lagu berada.
• {artist: ...} atau {a: ...} Nama artis atau informasi byline lainnya. Anda dapat menentukan beberapa artis dengan memisahkan nama dengan titik koma. - Kim Walker-Smith; Chris Quilala
• {author: ...} Nama orang yang membuat bagan akord. Ini ditampilkan di bagian bawah bagan akord dan dalam proyeksi lirik.
• {key: ...} atau {k: ...} atau {ok: ...} Kunci lagu yang ditulis sebagai kunci dengan preferensi enharmonik dan opsional "m" untuk menunjukkan minor. - alphabetic, e.g. Bb or Em
• {capo: ...} Kapo untuk ditetapkan sebagai jumlah fret - numeric
• {tempo: ...} Irama per menit (BPM) - numeric
• {time: ...} Tanda birama - numeric beat over bar e.g. 3/4
• {duration: ...} Panjang lagu untuk scroll otomatis - seconds or mm:ss
• {book: ...} Nama buku atau buku tempat lagu akan ditempatkan. Ini adalah daftar nama buku yang dibatasi dengan koma tempat lagu akan ditempatkan. Jika buku tidak ada, buku akan dibuat secara otomatis.
• {number: ...} Nomor lagu - numeric, use for hymns, years, etc. You can sort songs by the number for reference.
• {flow: ...} Susunan bagian - daftar label bagian. Lihat Alur untuk detail tentang mengatur alur lagu.
• {midi: ...} Perintah MIDI untuk dikirim saat lagu dilihat. Lihat Sintaks MIDI untuk cara mengekspresikan perintah MIDI sebagai teks di OnSong.
• {midi-index: ...} Perintah MIDI yang akan memicu lagu ini untuk dibuka di Penampil Lagu. Lihat Sintaks MIDI untuk cara mengekspresikan perintah MIDI sebagai teks di OnSong.
• {pitch: ...} Nada yang dimainkan saat menggunakan fitur Pitch Pipe.
• {keywords: ...} atau {topic: ...} Daftar tag untuk digunakan dengan pencarian topik. Lihat Topik untuk informasi lebih lanjut tentang browsing berdasarkan topik.
• {copyright: ...} atau {footer: ...} Menentukan teks footer hak cipta untuk muncul di bagian bawah halaman atau proyeksi lirik.
• {ccli: ...} Nomor CCLI lagu.
• {restrictions: ...} Manajemen hak untuk daftar pembatasan yang dibatasi koma dari lagu. Lihat Pembatasan untuk detail tentang menetapkan pembatasan untuk lagu Anda.

Tag Inline

Tag ini digunakan dalam konten lagu dan dapat digunakan untuk menentukan bagian atau memformat bagian lagu.

• {define: ...} digunakan untuk mendefinisikan diagram akord khusus. Lihat Mendefinisikan Akord untuk informasi lebih lanjut.
• {comment: ...} atau {c: ...} Mendefinisikan komentar dan muncul sebagai instruksi musik.
• {comment_bold: ...} atau {cb: ...} Mendefinisikan teks untuk muncul dalam bold.
• {comment_italic: ...} atau {ci: ...} Mendefinisikan teks untuk muncul sebagai italic.
• {guitar_comment: ...} atau {gc: ...} Mendefinisikan komentar yang muncul sebagai instruksi musik.
• {start_of_verse: ..} atau {sov} Mendeklarasikan awal bagian ayat dengan label bagian opsional.
• {end_of_verse} atau {eov} Mendeklarasikan akhir bagian ayat.
• {start_of_chorus: ...} atau {soc} Mendeklarasikan awal bagian refrein dengan label bagian opsional.
• {end_of_chorus} atau {eoc} Mendeklarasikan akhir bagian refrein.
• {start_of_bridge: ...} atau {sob} Mendeklarasikan awal bagian jembatan dengan label bagian opsional.
• {end_of_bridge} atau {eob} Mendeklarasikan akhir bagian jembatan.
• {start_of_part: ..} atau {sop} Mendeklarasikan awal bagian dengan label bagian opsional.
• {end_of_part} atau {eop} Mendeklarasikan akhir bagian.
• {start_of_tab} atau {sot} Mendeklarasikan awal tabulasi yang OnSong render dalam font monospace.
• {end_of_tab} atau {eot} Mendeklarasikan akhir bagian tabulasi.
• {new_page} atau {np} Ini digunakan untuk mendeklarasikan halaman baru.
• {new_physical_page} atau {npp} Ini digunakan untuk mendeklarasikan halaman baru.

Tag Pemformatan

Tag berikut digunakan untuk mendefinisikan font dan ukuran default untuk lirik dan akord dalam bagan akord.

• {textsize: ...} Mendefinisikan ukuran lirik sebagai nilai numerik dalam poin.
• {textfont: ...} Mendefinisikan nama font yang akan digunakan untuk lirik. Harus didukung di platform.
• {chordsize: ...} Mendefinisikan ukuran akord sebagai nilai numerik dalam poin.
• {chordfont: ...} Mendefinisikan nama font yang akan digunakan untuk akord. Harus didukung di platform.

Ekstensi File yang Didukung

Format file ChordPro unik karena merupakan sintaks yang disepakati bersama, tetapi bukan format standar. Ini berarti berbagai vendor dapat mengimplementasikannya dengan cara yang berbeda dan dengan ekstensi file yang berbeda. OnSong mendukung ekstensi file berikut saat mengimpor file berformat ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm