ChordPro

ChordPro-filformatet er et vanlig format som brukes i andre programvareapplikasjoner. OnSong forstår dette formatet innebygd. 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 logisk deles 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 punkter (...) 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: ...} Sangens tittel.
• {subtitle: ...}, {st: ...} eller {su: ...} Artistnavnet eller annen underlinjeinformasjon. Du kan spesifisere flere artister ved å separere navn med semikolon. - Kim Walker-Smith; Chris Quilala
• {album: ...} Navnet på albumet der sangen er plassert.
• {artist: ...} eller {a: ...} Artistnavnet eller annen underlinjeinformasjon. Du kan spesifisere flere artister ved å separere navn med semikolon. - Kim Walker-Smith; Chris Quilala
• {author: ...} Navnet på personen som opprettet ackordiagrammet. Dette vises nederst på ackordiagrammet og i lyrikkprojeksjon.
• {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: ...} Taktarten - numerisk slag over takt f.eks. 3/4
• {duration: ...} Sangens lengde for autoscroll - sekunder eller mm:ss
• {book: ...} Navnet på boken eller bøkene du vil plassere sangen i. Dette er en kommaavgrenset liste over boknavner som sangen vil bli plassert i. Hvis boken ikke finnes, vil den bli automatisk opprettet.
• {number: ...} Sangnummeret - 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 hvordan du ordner flyten 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 utløser at denne sangen åpnes i Sangvisningen. Se MIDI-syntaks for hvordan du uttrykker MIDI-kommandoer som tekst i OnSong.
• {pitch: ...} Notetilene som skal spilles når du bruker Tonegaffelen-funksjonen.
• {keywords: ...} eller {topic: ...} Listen over etiketter som skal brukes med emnesøk. Se Emner for mer informasjon om å bla etter emne.
• {copyright: ...} eller {footer: ...} Spesifiserer opphavsrettstekst som skal vises nederst på siden eller i lyrikkprojeksjon.
• {ccli: ...} CCLI-nummeret for sangen.
• {restrictions: ...} Rettighetsstyring for sangens kommaavgrenset liste over begrensninger. Se Begrensninger for detaljer om hvordan du angir 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 ackordiagrammer. Se Definer 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 skrift.
• {comment_italic: ...} eller {ci: ...} Definerer tekst som skal vises i kursiv.
• {guitar_comment: ...} eller {gc: ...} Definerer en kommentar som vises som en musikalsk instruksjon.
• {start_of_verse: ..} eller {sov} Deklarerer starten på en verseseksjon med en valgfri seksjonetikett.
• {end_of_verse} eller {eov} Deklarerer slutten på en verseseksjon.
• {start_of_chorus: ...} eller {soc} Deklarerer starten på en korseksjon med en valgfri seksjonetikett.
• {end_of_chorus} eller {eoc} Deklarerer slutten på en korseksjon.
• {start_of_bridge: ...} eller {sob} Deklarerer starten på en brokseksjon med en valgfri seksjonetikett.
• {end_of_bridge} eller {eob} Deklarerer slutten på en brokseksjon.
• {start_of_part: ..} eller {sop} Deklarerer starten på en del med en valgfri seksjonetikett.
• {end_of_part} eller {eop} Deklarerer slutten på en del.
• {start_of_tab} eller {sot} Deklarerer starten på tabulatur som OnSong gjengir i en monospaced font.
• {end_of_tab} eller {eot} Deklarerer slutten på en tabulaturseksjon.
• {new_page} eller {np} Dette brukes til å deklarere en ny side.
• {new_physical_page} eller {npp} Dette brukes til å deklarere en ny side.

Formateringstagger

Følgende tagger brukes til å definere standardskriften og størrelse for lyrics og akkorder i ackordiagrammet.

• {textsize: ...} Definerer størrelsen på lyrics som en numerisk verdi i poeng.
• {textfont: ...} Definerer navnet på skriften som skal brukes for lyrics. Må være støttet på plattformen.
• {chordsize: ...} Definerer størrelsen på akkordene som en numerisk verdi i poeng.
• {chordfont: ...} Definerer navnet på skriften som skal brukes for akkorder. Må være støttet på plattformen.

Støttede filutvidelser

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

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