ChordPro

פורמט הקובץ ChordPro הוא פורמט נפוץ המשמש בתוכנות אחרות. OnSong מבין פורמט זה באופן מקורי. OnSong מזהה קבצים עם הסיומות הבאות: .chordpro, .chopro, .cho, .crd, .pro

פורמט ChordPro מאפשר לבטא מידע על השיר בתגיות המסומנות בסוגריים מסולסלים. ניתן לחלק מידע זה באופן הגיוני לתגיות metadata ותגיות inline.

תגיות Metadata

אלה הן תגיות ChordPro שבהן תוכל להשתמש בחלק ה-metadata של השיר. בתגיות הבאות, שלוש נקודות (...) מייצגות את הטקסט שאתה מספק, שמופיע בין הקולון לסוגר המסולסל הסוגר. לדוגמה:

{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: ...} סדור של קטעים - רשימת תוויות קטעים. ראה Flow לפרטים על סידור זרימת השיר.
• {midi: ...} פקודות MIDI שישלחו כאשר משקיפים את השיר. ראה MIDI Syntax כדי ללמוד כיצד לבטא פקודות MIDI כטקסט ב-OnSong.
• {midi-index: ...} פקודות MIDI שתפעיל את השיר להיפתח ב-Song Viewer. ראה MIDI Syntax כדי ללמוד כיצד לבטא פקודות MIDI כטקסט ב-OnSong.
• {pitch: ...} התווים שיש להשמיע בשימוש בתכונת Pitch Pipe.
• {keywords: ...} או {topic: ...} רשימת התגיות לשימוש בחיפוש נושא. ראה Topics למידע נוסף על דפדוף לפי נושא.
• {copyright: ...} או {footer: ...} מציין טקסט כותרת זכויות יוצרים שיופיע בתחתית הדף או בהקרנת הטקסט.
• {ccli: ...} מספר ה-CCLI של השיר.
• {restrictions: ...} ניהול הזכויות של רשימת המגבלות של השיר המופרדת בפסיקים. ראה Restrictions לפרטים על הגדרת הגבלות לשיר שלך.

תגיות Inline

תגיות אלה משמשות בתוך תוכן השיר וניתן להשתמש בהן כדי להגדיר קטעים או לעצב חלקים של השיר.

• {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} מכריז על התחלת tablature שה-OnSong משרטט בגופן זקוף.
• {end_of_tab} או {eot} מכריז על סיום קטע tablature.
• {new_page} או {np} משמש כדי להכריז על דף חדש.
• {new_physical_page} או {npp} משמש כדי להכריז על דף חדש.

תגיות עיצוב

התגיות הבאות משמשות להגדרת הגופן והגודל של ברירת המחדל לטקסט ואקורדים בתרשים האקורדים.

• {textsize: ...} מגדיר את גודל הטקסט כערך נומרי בנקודות.
• {textfont: ...} מגדיר את שם הגופן שיש להשתמש בו לטקסט. חייב להיות נתמך בפלטפורמה.
• {chordsize: ...} מגדיר את גודל האקורדים כערך נומרי בנקודות.
• {chordfont: ...} מגדיר את שם הגופן שיש להשתמש בו לאקורדים. חייב להיות נתמך בפלטפורמה.

סיומות קבצים נתמכות

פורמט הקובץ ChordPro ייחודי בכך שהוא תחביר שהוסכם בדרך כלל, אך לא פורמט סטנדרטי. משמעות הדבר היא כי ספקים שונים יכולים ליישם אותו בדרכים שונות ועם סיומות קבצים שונות. OnSong תומך בסיומות הקבצים הבאות בעת ייבוא קבצים בפורמט ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm