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 ที่จะส่งเมื่อดูเพลง ดู MIDI Syntax สำหรับวิธีการแสดงคำสั่ง MIDI เป็นข้อความใน OnSong
• {midi-index: ...} คำสั่ง MIDI ที่จะทำให้เพลงนี้เปิดใน Song Viewer ดู MIDI Syntax สำหรับวิธีการแสดงคำสั่ง MIDI เป็นข้อความใน OnSong
• {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