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 المراد إرسالها عند عرض الأغنية. انظر بناء جملة MIDI لمعرفة كيفية التعبير عن أوامر MIDI كنص في OnSong.
• {midi-index: ...} أوامر MIDI التي ستؤدي إلى فتح هذه الأغنية في عارض الأغنية. انظر بناء جملة MIDI لمعرفة كيفية التعبير عن أوامر MIDI كنص في OnSong.
• {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