Användarmanual
ChordPro
ChordPro-filformatet är ett vanligt format som används i andra programvaruapplikationer. OnSong förstår detta format internt. OnSong känner igen filer med följande filtillägg: .chordpro, .chopro, .cho, .crd, .pro
ChordPro-formatet tillåter att låtinformation uttrycks i taggar avgränsade av lockiga parenteser. Denna information kan logiskt delas in i metadatatagggar och infogade taggar.
Metadatatagggar
Dessa är ChordPro-taggar som du skulle använda i metadatadelen av låten. I följande taggar representerar tre punkter (...) texten du anger, som går mellan kolonet och den avslutande lockiga parentesen. Till exempel:
{title: Amazing Grace}
{key: G}
OnSong stöder följande ChordPro-taggar:
- {title: ...} eller {t: ...} Låtens titel.
- {subtitle: ...}, {st: ...} eller {su: ...} Artistnamn eller annan rubrikinformation. Du kan ange flera artister genom att separera namn med ett semikolon. - Kim Walker-Smith; Chris Quilala
- {album: ...} Namnet på albumet där låten finns.
- {artist: ...} eller {a: ...} Artistnamn eller annan rubrikinformation. Du kan ange flera artister genom att separera namn med ett semikolon. - Kim Walker-Smith; Chris Quilala
- {author: ...} Namnet på personen som skapade ackordschemat. Detta visas längst ned på ackordschemat och i lysprojektion.
- {key: ...} eller {k: ...} eller {ok: ...} Låtens tonart skriven som en tonart med enharmonisk preferens och valfritt "m" för att ange moll. - alfabetisk, t.ex. Bb eller Em
- {capo: ...} Capoen som antal band - numerisk
- {tempo: ...} Takten per minut (BPM) - numerisk
- {time: ...} Taktarten - numerisk slag över takt, t.ex. 3/4
- {duration: ...} Låtlängden för autoscroll - sekunder eller mm:ss
- {book: ...} Namnet på boken eller böcker där låten ska placeras. Detta är en kommaavgränsad lista över boknamn där låten kommer att placeras. Om boken inte finns kommer den att skapas automatiskt.
- {number: ...} Låtnumret - numerisk, använd för hymner, år osv. Du kan sortera låtar efter numret som referens.
- {flow: ...} Arrangeringen av sektioner - lista över sektionsetiketter. Se Flöde för detaljer om hur du arrangerar flödet i en låt.
- {midi: ...} MIDI-kommandona som ska skickas när låten visas. Se MIDI-syntax för hur du uttrycker MIDI-kommandon som text i OnSong.
- {midi-index: ...} MIDI-kommandona som utlöser att denna låt öppnas i Låtvyn. Se MIDI-syntax för hur du uttrycker MIDI-kommandon som text i OnSong.
- {pitch: ...} Noterna som ska spelas när du använder funktionen Pitch Pipe.
- {keywords: ...} eller {topic: ...} Listan över taggar som ska användas med ämnessökning. Se Ämnen för mer information om att söka efter ämne.
- {copyright: ...} eller {footer: ...} eller {f: ...} Anger copyrighttext i sidfot som ska visas längst ned på sidan eller i lysprojektion.
- {ccli: ...} CCLI-numret för låten.
- {restrictions: ...} Rättighetshanteringen för låtens kommaavgränsade lista över begränsningar. Se Begränsningar för detaljer om hur du ställer in begränsningar för din låt.
- {composer: ...} Personerna som skrev musiken till låten. Denna lista bör separeras med semikolon för separata värden.
- {lyricist: ...} Personerna som skrev texten till låten. Denna lista bör separeras med semikolon för separata värden.
Infogade taggar
Dessa taggar används inom innehållet i låten och kan användas för att antingen definiera sektioner eller formatera delar av låten.
- {define: ...} används för att definiera anpassade ackordsdiagram. Se Definiera ackord för mer information.
- {comment: ...} eller {c: ...} Definierar en kommentar och visas som en musikalisk instruktion.
- {comment_bold: ...} eller {cb: ...} Definierar text som ska visas i fetstil.
- {comment_italic: ...} eller {ci: ...} Definierar text som ska visas i kursiv stil.
- {guitar_comment: ...} eller {gc: ...} Definierar en kommentar som visas som en musikalisk instruktion.
- {start_of_verse: ..} eller {sov} Deklarerar början av en versssektion med en valfri sektionsetikett.
- {end_of_verse} eller {eov} Deklarerar slutet på en verssektion.
- {start_of_chorus: ...} eller {soc} Deklarerar början av en refräng-sektion med en valfri sektionsetikett.
- {end_of_chorus} eller {eoc} Deklarerar slutet på en refräng-sektion.
- {start_of_bridge: ...} eller {sob} Deklarerar början av en brosektion med en valfri sektionsetikett.
- {end_of_bridge} eller {eob} Deklarerar slutet på en brosektion.
- {start_of_part: ..} eller {sop} Deklarerar början av en del med en valfri sektionsetikett.
- {end_of_part} eller {eop} Deklarerar slutet på en del.
- {start_of_tab} eller {sot} Deklarerar början av tablaturtablå som OnSong renderar i ett monospaced-teckensnitt.
- {end_of_tab} eller {eot} Deklarerar slutet på en tablaturssektion.
- {new_page} eller {np} Detta används för att deklarera en ny sida.
- {new_physical_page} eller {npp} Detta används för att deklarera en ny sida.
Formateringstaggar
Följande taggar används för att definiera standardtypsnittet och storleken för texterändar och ackord i ackordschemat.
- {textsize: ...} Definierar storleken på texten som ett numeriskt värde i punkter.
- {textfont: ...} Definierar namnet på teckensnittet som ska användas för text. Måste stödjas på plattformen.
- {chordsize: ...} Definierar storleken på ackorden som ett numeriskt värde i punkter.
- {chordfont: ...} Definierar namnet på teckensnittet som ska användas för ackord. Måste stödjas på plattformen.
Filtillägg som stöds
ChordPro-filformatet är unikt genom att det är en allmänt accepterad syntax, men inte en standardiserad format. Detta innebär att olika leverantörer kan implementera det på olika sätt och med olika filtillägg. OnSong stöder följande filtillägg när du importerar ChordPro-formaterade filer:
- .chopro
- .cho
- .chordpro
- .crd
- .pro
- .cpm