Panduan Pengguna
ChordPro
Format file 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 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. Contohnya:
{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 untuk diatur sebagai jumlah fret - numerik
- {tempo: ...} Ketukan per menit (BPM) - numerik
- {time: ...} Tanda waktu - beat numerik di atas bar mis. 3/4
- {duration: ...} Panjang lagu untuk autoscroll - detik atau mm:ss
- {book: ...} Nama buku atau buku untuk menempatkan lagu. Ini adalah daftar nama buku yang dibatasi koma tempat lagu akan ditempatkan. Jika buku tidak ada, buku akan dibuat secara otomatis.
- {number: ...} Nomor lagu - numerik, gunakan untuk himne, tahun, dll. Anda dapat mengurutkan lagu berdasarkan nomor untuk referensi.
- {flow: ...} Pengaturan bagian - daftar label bagian. Lihat Flow untuk detail tentang mengatur alur lagu.
- {midi: ...} Perintah MIDI untuk dikirim saat lagu dilihat. Lihat MIDI Syntax untuk cara mengungkapkan perintah MIDI sebagai teks di OnSong.
- {midi-index: ...} Perintah MIDI yang akan memicu lagu ini untuk dibuka di Song Viewer. Lihat MIDI Syntax untuk cara mengungkapkan perintah MIDI sebagai teks di OnSong.
- {pitch: ...} Nada untuk dimainkan saat menggunakan fitur Pitch Pipe.
- {keywords: ...} atau {topic: ...} Daftar tag untuk digunakan dengan pencarian topik. Lihat Topics untuk informasi lebih lanjut tentang menjelajahi berdasarkan topik.
- {copyright: ...} atau {footer: ...} atau {f: ...} Menentukan teks footer hak cipta yang muncul di bagian bawah halaman atau proyeksi lirik.
- {ccli: ...} Nomor CCLI lagu.
- {restrictions: ...} Manajemen hak untuk daftar pembatasan yang dibatasi koma dalam lagu. Lihat Restrictions untuk detail tentang menetapkan pembatasan untuk lagu Anda.
- {composer: ...} Individu yang menulis musik untuk lagu. Daftar ini harus dipisahkan dengan titik koma untuk nilai-nilai terpisah.
- {lyricist: ...} Individu yang menulis lirik lagu. Daftar ini harus dipisahkan dengan titik koma untuk nilai-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 khusus. Lihat Defining Chords untuk informasi lebih lanjut.
- {comment: ...} atau {c: ...} Menentukan komentar dan muncul sebagai instruksi musik.
- {comment_bold: ...} atau {cb: ...} Menentukan teks yang muncul dalam bold.
- {comment_italic: ...} atau {ci: ...} Menentukan teks yang muncul sebagai italic.
- {guitar_comment: ...} atau {gc: ...} Menentukan komentar yang muncul sebagai instruksi musik.
- {start_of_verse: ..} atau {sov} Mendeklarasikan awal bagian verse dengan label bagian opsional.
- {end_of_verse} atau {eov} Mendeklarasikan akhir bagian verse.
- {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 bridge dengan label bagian opsional.
- {end_of_bridge} atau {eob} Mendeklarasikan akhir bagian bridge.
- {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 tablature yang OnSong render dalam font monospaced.
- {end_of_tab} atau {eot} Mendeklarasikan akhir bagian tablature.
- {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 numerik dalam poin.
- {textfont: ...} Menentukan nama font yang akan digunakan untuk lirik. Harus didukung di platform.
- {chordsize: ...} Menentukan ukuran akord sebagai nilai numerik dalam poin.
- {chordfont: ...} Menentukan nama font yang akan digunakan untuk akord. Harus didukung di platform.
Ekstensi File yang Didukung
Format file 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