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: ...} إدارة الحقوق للأغنية — قائمة محددة بفواصل من القيود. راجع القيود للحصول على تفاصيل حول تعيين القيود للأغنية الخاصة بك.
• {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