ChordPro

ChordPro-filformatet er et vanlig format som brukes i andre programvareapplikasjoner. OnSong forstår dette formatet nativt. OnSong gjenkjenner filer med følgende filutvidelser: .chordpro, .chopro, .cho, .crd, .pro

ChordPro-formatet tillater at sanginformasjon uttrykkes i tagger avgrenset av krøllede parenteser. Denne informasjonen kan deles logisk inn i metadatatagger og innebygde tagger.

Metadatatagger

Dette er ChordPro-tagger som du ville brukt i metadatadelen av sangen. I følgende tagger representerer tre prikker (...) teksten du oppgir, som går mellom kolonet og den avsluttende krøllede parentesen. For eksempel:

{title: Amazing Grace}
{key: G}

OnSong støtter følgende ChordPro-tagger:

• {title: ...} eller {t: ...} Sangenes tittel.
• {subtitle: ...}, {st: ...} eller {su: ...} Artistnavnet eller annen undertekstinformasjon. Du kan oppgi flere artister ved å skille navnene med semikolon. - Kim Walker-Smith; Chris Quilala
• {album: ...} Navnet på albumet der sangen er lokalisert.
• {artist: ...} eller {a: ...} Artistnavnet eller annen undertekstinformasjon. Du kan oppgi flere artister ved å skille navnene med semikolon. - Kim Walker-Smith; Chris Quilala
• {author: ...} Navnet på personen som opprettet akkorddiagrammet. Dette vises nederst på akkorddiagrammet og i lyrikkprojeksjon.
• {key: ...} eller {k: ...} eller {ok: ...} Sangenes toneart skrevet som en toneart med enharmonisk preferanse og en valgfri "m" for å indikere moll. - alfabetisk, f.eks. Bb eller Em
• {capo: ...} Kapodastren som skal settes som antall bånd - numerisk
• {tempo: ...} Tempoet i slag per minutt (BPM) - numerisk
• {time: ...} Taktarten - numerisk slag over takt f.eks. 3/4
• {duration: ...} Sanglengden for autoskrolling - sekunder eller mm:ss
• {book: ...} Navnet på boken eller bøkene for å plassere sangen i. Dette er en kommaseparert liste over boknavn som sangen skal plasseres i. Hvis boken ikke finnes, opprettes den automatisk.
• {number: ...} Sangenes nummer - numerisk, brukes for hymner, år osv. Du kan sortere sanger etter nummeret som referanse.
• {flow: ...} Arrangementet av seksjoner - liste over seksjonsmerker. Se Flyt for detaljer om å arrangere flyt av en sang.
• {midi: ...} MIDI-kommandoene som skal sendes når sangen vises. Se MIDI-syntaks for hvordan du uttrykker MIDI-kommandoer som tekst i OnSong.
• {midi-index: ...} MIDI-kommandoene som vil utløse at denne sangen åpnes i Sangviseren. Se MIDI-syntaks for hvordan du uttrykker MIDI-kommandoer som tekst i OnSong.
• {pitch: ...} Notenene som skal spilles når du bruker funksjonen Tonekaliber.
• {keywords: ...} eller {topic: ...} Listen over tagger som skal brukes med emnesøk. Se Emner for mer informasjon om å bla gjennom emner.
• {copyright: ...} eller {footer: ...} Angir kopieringsfooter-tekst som skal vises nederst på siden eller lyrikkprojeksjon.
• {ccli: ...} CCLI-nummeret på sangen.
• {restrictions: ...} Rettighetsstyringen for sangenes kommaseparerte liste over begrensninger. Se Begrensninger for detaljer om å angi begrensninger for sangen din.

Innebygde tagger

Disse taggene brukes i innholdet av sangen og kan brukes til enten å definere seksjoner eller formatere deler av sangen.

• {define: ...} brukes til å definere egendefinerte akkorddiagrammer. Se Definere akkorder for mer informasjon.
• {comment: ...} eller {c: ...} Definerer en kommentar og vises som en musikalsk instruksjon.
• {comment_bold: ...} eller {cb: ...} Definerer tekst som skal vises i fet.
• {comment_italic: ...} eller {ci: ...} Definerer tekst som skal vises som kursiv.
• {guitar_comment: ...} eller {gc: ...} Definerer en kommentar som vises som en musikalsk instruksjon.
• {start_of_verse: ..} eller {sov} Deklarerer starten på en verstrofe-seksjon med en valgfri seksjonsmerker.
• {end_of_verse} eller {eov} Deklarerer slutten på en verstrofe-seksjon.
• {start_of_chorus: ...} eller {soc} Deklarerer starten på en omkveding-seksjon med en valgfri seksjonsmerker.
• {end_of_chorus} eller {eoc} Deklarerer slutten på en omkveding-seksjon.
• {start_of_bridge: ...} eller {sob} Deklarerer starten på en bru-seksjon med en valgfri seksjonsmerker.
• {end_of_bridge} eller {eob} Deklarerer slutten på en bru-seksjon.
• {start_of_part: ..} eller {sop} Deklarerer starten på en del med en valgfri seksjonsmerker.
• {end_of_part} eller {eop} Deklarerer slutten på en del.
• {start_of_tab} eller {sot} Deklarerer starten på tabulering som OnSong gjengir i en monoskriftet font.
• {end_of_tab} eller {eot} Deklarerer slutten på en tabulerings-seksjon.
• {new_page} eller {np} Dette brukes til å deklarere en ny side.
• {new_physical_page} eller {npp} Dette brukes til å deklarere en ny side.

Formatteringstagger

Følgende tagger brukes til å definere standard font og størrelse for lyrikklinjer og akkorder i akkorddiagrammet.

• {textsize: ...} Definerer størrelsen på lyrikklinjer som en numerisk verdi i poeng.
• {textfont: ...} Definerer navnet på fonten som skal brukes for lyrikklinjer. Må støttes på plattformen.
• {chordsize: ...} Definerer størrelsen på akkordene som en numerisk verdi i poeng.
• {chordfont: ...} Definerer navnet på fonten som skal brukes for akkorder. Må støttes på plattformen.

Støttede filutvidelser

ChordPro-filformatet er unikt ved at det er en vanlig avtalt syntaks, men ikke et standardformat. Dette betyr at ulike leverandører kan implementere det på forskjellige måter og med forskjellige filutvidelser. OnSong støtter følgende filutvidelser ved import av ChordPro-formaterte filer:

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