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: ...} ה-capo להגדרה כמספר הפרטים - מספרי
• {tempo: ...} הקצב בקצבים לדקה (BPM) - מספרי
• {time: ...} חתימת הזמן - מספרי של פעימה לחנה, למשל 3/4
• {duration: ...} אורך השיר לגלילה אוטומטית - שניות או mm:ss
• {book: ...} שם הספר או הספרים שבהם יש למקם את השיר. זהו רשימה מופרדת בפסיקים של שמות ספרים שאליהם יוצב השיר. אם הספר אינו קיים, הוא ייווצר באופן אוטומטי.
• {number: ...} מספר השיר - מספרי, בשימוש להימנונים, שנים וכו'. אתה יכול למיין שירים לפי המספר להפניה.
• {flow: ...} סדר הסעיפים - רשימת תוויות סעיף. ראה זרימה לפרטים על סדר הזרימה של שיר.
• {midi: ...} פקודות MIDI לשלוח כאשר השיר מוצג. ראה MIDI Syntax כיצד לבטא פקודות MIDI כטקסט ב-OnSong.
• {midi-index: ...} פקודות MIDI שיפעילו את פתיחת השיר ב-מצפה השירים. ראה MIDI Syntax כיצד לבטא פקודות 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