ChordPro

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

ChordPro-formatet tillater at sanginformasjon uttrykkes i tagger avgrenset av krøllete parenteser. Denne informasjonen kan logisk deles inn i metadatatagger og inline-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øllparentesen. For eksempel:

{title: Amazing Grace}
{key: G}

OnSong støtter følgende ChordPro-tagger:

• {title: ...} eller {t: ...} Sangenes tittel.
• {subtitle: ...}, {st: ...} eller {su: ...} Kunstnernavnet eller annen bylineinformasjon. Du kan angi flere kunstnere ved å skille navn med semikolon. - Kim Walker-Smith; Chris Quilala
• {album: ...} Navnet på albumet der sangen befinner seg.
• {artist: ...} eller {a: ...} Kunstnernavnet eller annen bylineinformasjon. Du kan angi flere kunstnere ved å skille navn med semikolon. - Kim Walker-Smith; Chris Quilala
• {author: ...} Navnet på personen som opprettet akkorddiagrammet. Dette vises nederst i akkorddiagrammet og i lyrikkprojektion.
• {key: ...} eller {k: ...} eller {ok: ...} Sangens toneart skrevet som en toneart med enharmonisk preferanse og en valgfri "m" for å indikere moll. - alfabetisk, f.eks. Bb eller Em
• {capo: ...} Kapoen som skal settes som antall bånd - numerisk
• {tempo: ...} Slag per minutt (BPM) - numerisk
• {time: ...} Tidsignaturen - numerisk slag over takt, f.eks. 3/4
• {duration: ...} Sanglengde for autoscroll - sekunder eller mm:ss
• {book: ...} Navnet på boken eller bøkene der sangen skal plasseres. Dette er en kommadelimitert liste over boknavn som sangen skal plasseres i. Hvis boken ikke finnes, blir den automatisk opprettet.
• {number: ...} Sangenes nummer - numerisk, bruk for salmer, år osv. Du kan sortere sanger etter nummeret for referanse.
• {flow: ...} Arrangementet av seksjoner - liste over seksjonsetiketter. Se Flow for detaljer om arrangering av sangens flyt.
• {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 Sangsviseren. Se MIDI-syntaks for hvordan du uttrykker MIDI-kommandoer som tekst i OnSong.
• {pitch: ...} Notenene som skal spilles når du bruker funksjonen Pitch Pipe.
• {keywords: ...} eller {topic: ...} Listen over tagger som skal brukes ved emnesøk. Se Emner for mer informasjon om å bla etter emne.
• {copyright: ...} eller {footer: ...} eller {f: ...} Angir tekst for opphavsrettfooter som skal vises nederst på siden eller i lyrikkprojektion.
• {ccli: ...} CCLI-nummeret for sangen.
• {restrictions: ...} Rettighetsforvaltningen for sangens kommadelimiterte liste over restriksjoner. Se Restriksjoner for detaljer om å angi restriksjoner for sangen din.
• {composer: ...} Personene som skrev musikken til sangen. Denne listen skal separeres med semikolon for separate verdier.
• {lyricist: ...} Personene som skrev lyrikkene til sangen. Denne listen skal separeres med semikolon for separate verdier.

Inline-tagger

Disse taggene brukes innenfor innholdet i 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} Erklærer starten på en vers-seksjon med en valgfri seksjonsetikett.
• {end_of_verse} eller {eov} Erklærer slutten på en vers-seksjon.
• {start_of_chorus: ...} eller {soc} Erklærer starten på en korus-seksjon med en valgfri seksjonsetikett.
• {end_of_chorus} eller {eoc} Erklærer slutten på en korus-seksjon.
• {start_of_bridge: ...} eller {sob} Erklærer starten på en bru-seksjon med en valgfri seksjonsetikett.
• {end_of_bridge} eller {eob} Erklærer slutten på en bru-seksjon.
• {start_of_part: ..} eller {sop} Erklærer starten på en del med en valgfri seksjonsetikett.
• {end_of_part} eller {eop} Erklærer slutten på en del.
• {start_of_tab} eller {sot} Erklærer starten på tabulering som OnSong gjengir i monospace-font.
• {end_of_tab} eller {eot} Erklærer slutten på en tabuleringsseksjon.
• {new_page} eller {np} Dette brukes til å erklære en ny side.
• {new_physical_page} eller {npp} Dette brukes til å erklære en ny side.

Formateringstagger

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

• {textsize: ...} Definerer størrelsen på lyrikkene som en numerisk verdi i poeng.
• {textfont: ...} Definerer navnet på fonten som skal brukes for lyrikkene. Må være støttet 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å være støttet på plattformen.

Støttede filtyper

ChordPro-filformatet er unikt ved at det er en allment avtalt syntaks, men ikke et standardformat. Dette betyr at ulike leverandører kan implementere det på ulike måter og med ulike filtyper. OnSong støtter følgende filtyper når ChordPro-formaterte filer importeres:

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