ChordPro

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

Format ChordPro memungkinkan informasi lagu untuk diungkapkan 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 berikan, yang berada di antara titik dua dan kurung kurawal penutup. Misalnya:

{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 diagram akord. Ini ditampilkan di bagian bawah diagram 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. - alfabetik, mis. Bb atau Em
• {capo: ...} Capo yang ditetapkan sebagai jumlah fret - angka
• {tempo: ...} Ketukan per menit (BPM) - angka
• {time: ...} Tanda waktu - angka beat over bar mis. 3/4
• {duration: ...} Panjang lagu untuk autoscroll - detik atau mm:ss
• {book: ...} Nama buku atau buku tempat menempatkan lagu. Ini adalah daftar nama buku yang dipisahkan dengan koma ke mana lagu akan ditempatkan. Jika buku tidak ada, akan dibuat secara otomatis.
• {number: ...} Nomor lagu - angka, gunakan untuk himne, tahun, dll. Anda dapat mengurutkan lagu berdasarkan nomor untuk referensi.
• {flow: ...} Pengaturan bagian - daftar label bagian. Lihat Alur untuk detail tentang mengatur alur lagu.
• {midi: ...} Perintah MIDI yang akan 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 dibuka di Penampil Lagu. Lihat Sintaks MIDI untuk cara mengekspresikan perintah MIDI sebagai teks di OnSong.
• {pitch: ...} Nada yang akan dimainkan saat menggunakan fitur Pitch Pipe.
• {keywords: ...} atau {topic: ...} Daftar tag untuk digunakan dengan pencarian topik. Lihat Topik untuk informasi lebih lanjut tentang penelusuran berdasarkan topik.
• {copyright: ...} atau {footer: ...} atau {f: ...} Menentukan teks footer hak cipta untuk muncul di bagian bawah halaman atau proyeksi lirik.
• {ccli: ...} Nomor CCLI lagu.
• {restrictions: ...} Manajemen hak untuk daftar pembatasan lagu yang dipisahkan dengan koma. Lihat Pembatasan untuk detail tentang menetapkan pembatasan untuk lagu Anda.
• {composer: ...} Individu yang menulis musik lagu. Daftar ini harus dipisahkan dengan titik koma untuk nilai terpisah.
• {lyricist: ...} Individu yang menulis lirik lagu. Daftar ini harus dipisahkan dengan titik koma untuk nilai terpisah.

Tag Inline

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

• {define: ...} digunakan untuk menentukan diagram akord kustom. 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 chorus dengan label bagian opsional.
• {end_of_chorus} atau {eoc} Mendeklarasikan akhir bagian chorus.
• {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 tablatur yang OnSong render dalam font monospaced.
• {end_of_tab} atau {eot} Mendeklarasikan akhir bagian tablatur.
• {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 menentukan font dan ukuran default untuk lirik dan akord dalam diagram akord.

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

Ekstensi File yang Didukung

Format ChordPro unik karena merupakan sintaks yang disepakati secara umum, 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