उपयोगकर्ता मैनुअल
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: ...} या {f: ...} पृष्ठ के नीचे या लिरिक्स प्रोजेक्शन में दिखाई देने वाले कॉपीराइट फुटर टेक्स्ट को निर्दिष्ट करता है।
- {ccli: ...} गीत की CCLI संख्या।
- {restrictions: ...} गीत के अधिकार प्रबंधन की अल्पविराम-सीमांकित सूची प्रतिबंध। अपने गीत के लिए प्रतिबंध सेट करने के विवरण के लिए प्रतिबंध देखें।
- {composer: ...} व्यक्ति जिन्होंने गीत का संगीत लिखा। इस सूची को अलग-अलग मानों के लिए अर्धविराम से अलग किया जाना चाहिए।
- {lyricist: ...} व्यक्ति जिन्होंने गीत के गीत लिखे। इस सूची को अलग-अलग मानों के लिए अर्धविराम से अलग किया जाना चाहिए।
इनलाइन टैग
ये टैग गीत की सामग्री के भीतर उपयोग किए जाते हैं और सेक्शन को परिभाषित करने या गीत के भागों को प्रारूपित करने के लिए उपयोग किए जा सकते हैं।
- {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