ChordPro

ChordPro-filformatet er eit vanleg format som blir brukt i andre programvareanvendingar. OnSong forstår dette formatet naturleg. OnSong gjenkenner filer med følgjande filomfattingar: .chordpro, .chopro, .cho, .crd, .pro

ChordPro-formatet tillèt at songinformasjon blir uttrykt i merkelappar som er avgrensa av krøllparentesar. Denne informasjonen kan logisk delast inn i metadatamerkelappar og innebygde merkelappar.

Metadatamerkelappar

Desse er ChordPro-merkelappar som du ville bruke i metadatadelen av songen. I dei følgjande merkelappane representerer tre punkt (...) teksten du oppgjev, som går mellom kolonet og den avsluttande krøllparentesen. Til dømes:

{title: Amazing Grace}
{key: G}

OnSong støttar følgjande ChordPro-merkelappar:

• {title: ...} eller {t: ...} Tittelen på songen.
• {subtitle: ...}, {st: ...} eller {su: ...} Artistnamnet eller annan bylineinformasjon. Du kan spesifisere fleire artistar ved å skilje namn med eit semikol. - Kim Walker-Smith; Chris Quilala
• {album: ...} Namnet på albumet der songen er lagd.
• {artist: ...} eller {a: ...} Artistnamnet eller annan bylineinformasjon. Du kan spesifisere fleire artistar ved å skilje namn med eit semikol. - Kim Walker-Smith; Chris Quilala
• {author: ...} Namnet på personen som laga akkordiagrammet. Dette blir vist nedst på akkordiagrammet og i lyrikkprojeksjon.
• {key: ...} eller {k: ...} eller {ok: ...} Tonekøyen på songen skrive som ei tonekøy med enharmonisk preferanse og ein valfri "m" for å indikere minor. - alfabetisk, t.d. Bb eller Em
• {capo: ...} Kapoen som skal setjast som tal på bundane - numerisk
• {tempo: ...} Beatane per minutt (BPM) - numerisk
• {time: ...} Taktarten - numerisk slag over takt t.d. 3/4
• {duration: ...} Songlengda for automatisk blastring - sekund eller mm:ss
• {book: ...} Namnet på boka eller bokene som songen skal plasserast i. Dette er ei kommaseparert liste over boknamn som songen vil bli plassert i. Viss boka ikkje eksisterer, vil ho bli opprett automatisk.
• {number: ...} Nummeret på songen - numerisk, bruk for salmar, år osv. Du kan sortere songar etter nummeret for referanse.
• {flow: ...} Arrangementet av seksjonar - liste over seksjonsetiketter. Sjå Flyt for detaljar om korleis du ordnar flyten på ei song.
• {midi: ...} MIDI-kommandoane som skal sendast når songen blir viska. Sjå MIDI-syntaks for korleis du uttrykker MIDI-kommandar som tekst i OnSong.
• {midi-index: ...} MIDI-kommandoane som vil utløyse at denne songen blir opna i Songgransker. Sjå MIDI-syntaks for korleis du uttrykker MIDI-kommandar som tekst i OnSong.
• {pitch: ...} Notene som skal spelast når du brukar Toneavlesarfunksjonen.
• {keywords: ...} eller {topic: ...} Lista over merkelappar som skal brukast med emnesøk. Sjå Emne for meir informasjon om å bla gjennom etter emne.
• {copyright: ...} eller {footer: ...} eller {f: ...} Spesifiserer tekst for opphavsrettsfotnote som skal visast nedst på sida eller lyrikkprojeksjon.
• {ccli: ...} CCLI-nummeret på songen.
• {restrictions: ...} Rettsstyring for songen sin kommaseparerte liste over avgrensingar. Sjå Avgrensingar for detaljar om korleis du set avgrensingar for songen din.
• {composer: ...} Individa som skreiv musikken til songen. Denne lista bør separarerast med semikol for separate verdiar.
• {lyricist: ...} Individa som skreiv lyrikkane til songen. Denne lista bør separerast med semikol for separate verdiar.

Innebygde merkelappar

Desse merkelappane blir brukte innan innhaldet i songen og kan brukast til både å definere seksjonar eller til å formatere delar av songen.

• {define: ...} blir brukt til å definere eigendefinerte akkordiagram. Sjå Definering av akkordar for meir informasjon.
• {comment: ...} eller {c: ...} Definer ein kommentar og ser ut som ein musikalsk instruksjon.
• {comment_bold: ...} eller {cb: ...} Definer tekst som skal visast i feit.
• {comment_italic: ...} eller {ci: ...} Definer tekst som skal visast som kursiv.
• {guitar_comment: ...} eller {gc: ...} Definer ein kommentar som ser ut som ein musikalsk instruksjon.
• {start_of_verse: ..} eller {sov} Erklærer starten på ein versseeksjon med ein valfri seksjonsetikett.
• {end_of_verse} eller {eov} Erklærer slutten på ein versseeksjon.
• {start_of_chorus: ...} eller {soc} Erklærer starten på ein korus-eksjon med ein valfri seksjonsetikett.
• {end_of_chorus} eller {eoc} Erklærer slutten på ein korusseeksjon.
• {start_of_bridge: ...} eller {sob} Erklærer starten på ein bru-seeksjon med ein valfri seksjonsetikett.
• {end_of_bridge} eller {eob} Erklærer slutten på ein bruseeksjon.
• {start_of_part: ..} eller {sop} Erklærer starten på ein del med ein valfri seksjonsetikett.
• {end_of_part} eller {eop} Erklærer slutten på ein del.
• {start_of_tab} eller {sot} Erklærer starten på tabellering som OnSong renderer i ein monospassa skrift.
• {end_of_tab} eller {eot} Erklærer slutten på ein tabelleringseeksjon.
• {new_page} eller {np} Dette blir brukt til å erklære ei ny side.
• {new_physical_page} eller {npp} Dette blir brukt til å erklære ei ny side.

Formateringsmerkelappar

Dei følgjande merkelappane blir brukte til å definere standardskrifta og storleiken for lyrikk og akkordar i akkordiagrammet.

• {textsize: ...} Definer storleiken på lyrikkane som ein numerisk verdi i punkt.
• {textfont: ...} Definer namnet på skrifta som skal brukast for lyrikk. Må vera støtta på plattformen.
• {chordsize: ...} Definer storleiken på akkordane som ein numerisk verdi i punkt.
• {chordfont: ...} Definer namnet på skrifta som skal brukast for akkordar. Må vera støtta på plattformen.

Støtta filomfattingar

ChordPro-filformatet er unikt fordi det er ein vanlegt samtykt syntaks, men ikkje eit standardformat. Dette betyr at ulike leverandørar kan implementere det på ulike måtar og med ulike filomfattingar. OnSong støttar dei følgjande filomfattingane når du importerer ChordPro-formaterte filer:

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