उपयोगकर्ता मैनुअल
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: ...} अनुभागों की व्यवस्था - अनुभाग लेबल की सूची। गीत के प्रवाह को व्यवस्थित करने के विवरण के लिए प्रवाह देखें।
- {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