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: ...} أو {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