Brukerhåndbok
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øllparenteser. 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 leverer, som går mellom kolon og den avsluttende krøllparentesen. For eksempel:
{title: Amazing Grace}
{key: G}
OnSong støtter følgende ChordPro-tagger:
- {title: ...} eller {t: ...} Sangtonens tittel.
- {subtitle: ...}, {st: ...} eller {su: ...} Kunstnernavnet eller annen bylineinformasjon. Du kan angi flere artister ved å skille navn med semikolon. - Kim Walker-Smith; Chris Quilala
- {album: ...} Navnet på albumet der sangen er lokalisert.
- {artist: ...} eller {a: ...} Kunstnernavnet eller annen bylineinformasjon. Du kan angi flere artister ved å skille navn med semikolon. - Kim Walker-Smith; Chris Quilala
- {author: ...} Navnet på personen som laget akkorddiagrammet. Dette vises nederst i akkorddiagrammet og i lyrikksvisning.
- {key: ...} eller {k: ...} eller {ok: ...} Sangtonens toneart skrevet som 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: ...} Tempoet i slag per minutt (BPM) - numerisk
- {time: ...} Taktarten - numerisk slag over takt f.eks. 3/4
- {duration: ...} Sanglengden for autoscroll - sekunder eller mm:ss
- {book: ...} Navnet på boken eller bøkene der sangen skal plasseres. Dette er en kommadelimittert liste over boknavnene der sangen skal plasseres. Hvis boken ikke finnes, vil den opprettes automatisk.
- {number: ...} Nummeret på sangen - numerisk, bruk for salmer, år osv. Du kan sortere sanger etter nummeret som referanse.
- {flow: ...} Arrangementet av seksjoner - liste over seksjonsetiketter. Se Flow for detaljer om å arrangere flyten av en sang.
- {midi: ...} MIDI-kommandoene som skal sendes når sangen vises. Se MIDI Syntax for hvordan du uttrykker MIDI-kommandoer som tekst i OnSong.
- {midi-index: ...} MIDI-kommandoene som vil utløse at denne sangen åpnes i Song Viewer. Se MIDI Syntax for hvordan du uttrykker MIDI-kommandoer som tekst i OnSong.
- {pitch: ...} Notenene som skal spilles når du bruker Pitch Pipe-funksjonen.
- {keywords: ...} eller {topic: ...} Listen over tagger som skal brukes med emnesøk. Se Topics for mer informasjon om å bla etter emne.
- {copyright: ...} eller {footer: ...} eller {f: ...} Angir copyright-foteksttekst som skal vises nederst på siden eller i lyrikksvisning.
- {ccli: ...} CCLI-nummeret på sangen.
- {restrictions: ...} Rettighetsstyringen for sangens kommadelimitterte liste over restriksjoner. Se Restrictions for detaljer om å angi restriksjoner for sangen din.
- {composer: ...} Personene som skrev musikken til sangen. Denne listen bør separeres med semikolon for separate verdier.
- {lyricist: ...} Personene som skrev tekstene til sangen. Denne listen bør separeres med semikolon for separate verdier.
Innebygde 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 Defining Chords 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 vers-seksjon med en valgfri seksjonsetikett.
- {end_of_verse} eller {eov} Deklarerer slutten på en vers-seksjon.
- {start_of_chorus: ...} eller {soc} Deklarerer starten på en chorus-seksjon med en valgfri seksjonsetikett.
- {end_of_chorus} eller {eoc} Deklarerer slutten på en chorus-seksjon.
- {start_of_bridge: ...} eller {sob} Deklarerer starten på en bridge-seksjon med en valgfri seksjonsetikett.
- {end_of_bridge} eller {eob} Deklarerer slutten på en bridge-seksjon.
- {start_of_part: ..} eller {sop} Deklarerer starten på en del med en valgfri seksjonsetikett.
- {end_of_part} eller {eop} Deklarerer slutten på en del.
- {start_of_tab} eller {sot} Deklarerer starten på tabulatur som OnSong gir i monospaced-skrift.
- {end_of_tab} eller {eot} Deklarerer slutten på en tabulatur-seksjon.
- {new_page} eller {np} Dette brukes til å deklarere en ny side.
- {new_physical_page} eller {npp} Dette brukes til å deklarere en ny side.
Formateringslabeler
Følgende tagger brukes til å definere standardskriftstørrelse og -størrelse for tekst og akkorder i akkorddiagrammet.
- {textsize: ...} Definerer størrelsen på teksten som en numerisk verdi i poeng.
- {textfont: ...} Definerer navnet på skriften som skal brukes for tekst. 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 filtyper
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å ulike måter og med ulike filtyper. OnSong støtter følgende filtyper når du importerer ChordPro-formaterte filer:
- .chopro
- .cho
- .chordpro
- .crd
- .pro
- .cpm