ChordPro

ChordPro-filformatet er et almindeligt format, der bruges i andre softwareapplikationer. OnSong forstår dette format naturligt. OnSong genkender filer med følgende filtyper: .chordpro, .chopro, .cho, .crd, .pro

ChordPro-formatet tillader, at sanginformationer udtrykkes i tags afgrænset af krølede parenteser. Disse informationer kan logisk opdeles i metadatatags og inline-tags.

Metadatatags

Disse er ChordPro-tags, som du ville bruge i metadatadelen af sangen. I følgende tags repræsenterer tre prikker (...) den tekst, du angiver, som går mellem kolonet og den afsluttende krøllede parentes. For eksempel:

{title: Amazing Grace}
{key: G}

OnSong understøtter følgende ChordPro-tags:

• {title: ...} eller {t: ...} Sangens titel.
• {subtitle: ...}, {st: ...} eller {su: ...} Kunstnernavnet eller anden vejledeninformation. Du kan angive flere kunstnere ved at adskille navne med et semikolon. - Kim Walker-Smith; Chris Quilala
• {album: ...} Albumnavnet, hvor sangen er placeret.
• {artist: ...} eller {a: ...} Kunstnernavnet eller anden vejledeninformation. Du kan angive flere kunstnere ved at adskille navne med et semikolon. - Kim Walker-Smith; Chris Quilala
• {author: ...} Navnet på den person, der oprettede akkorddiagrammet. Dette vises nederst i akkorddiagrammet og i lyrisk projektion.
• {key: ...} eller {k: ...} eller {ok: ...} Sangens toneart skrevet som en toneart med enharmonisk præference og et valgfrit "m" for at angive minor. - alfabetisk, f.eks. Bb eller Em
• {capo: ...} Capo'en, der skal indstilles som antal bånd - numerisk
• {tempo: ...} Slagene pr. minut (BPM) - numerisk
• {time: ...} Taktarten - numerisk slag over takt f.eks. 3/4
• {duration: ...} Sanglængden til autoscroll - sekunder eller mm:ss
• {book: ...} Navnet på bogen eller bøgerne, som sangen skal placeres i. Dette er en kommasepareret liste over bogtitler, som sangen vil blive placeret i. Hvis bogen ikke findes, bliver den automatisk oprettet.
• {number: ...} Sangens nummer - numerisk, bruges til hymner, år osv. Du kan sortere sange efter nummeret til reference.
• {flow: ...} Arrangementet af sektioner - liste over sektionsetiketter. Se Flow for detaljer om at arrangere flowet af en sang.
• {midi: ...} MIDI-kommandoerne, der skal sendes, når sangen vises. Se MIDI-syntaks for at se, hvordan du udtrykker MIDI-kommandoer som tekst i OnSong.
• {midi-index: ...} MIDI-kommandoerne, der vil udløse denne sang til at blive åbnet i Sangglas. Se MIDI-syntaks for at se, hvordan du udtrykker MIDI-kommandoer som tekst i OnSong.
• {pitch: ...} Noterne, der skal afspilles, når du bruger Pitch Pipe-funktionen.
• {keywords: ...} eller {topic: ...} Listen over tags, der skal bruges med emnesøgning. Se Emner for mere information om browsing efter emne.
• {copyright: ...} eller {footer: ...} eller {f: ...} Angiver ophavsretsfooter-tekst, der skal vises nederst på siden eller i lyrisk projektion.
• {ccli: ...} Sangens CCLI-nummer.
• {restrictions: ...} Rettighedsstyring for sangens kommaseparerede begrænsningsliste. Se Restrictions for detaljer om at indstille begrænsninger for din sang.
• {composer: ...} De personer, der skrev musikken til sangen. Denne liste skal adskilles med semikoloner for separate værdier.
• {lyricist: ...} De personer, der skrev teksterne til sangen. Denne liste skal adskilles med semikoloner for separate værdier.

Inline-tags

Disse tags bruges inden for sangen og kan bruges til enten at definere sektioner eller at formatere dele af sangen.

• {define: ...} bruges til at definere brugerdefinerede akkorddiagrammer. Se Definering af akkorder for mere information.
• {comment: ...} eller {c: ...} Definerer en kommentar og vises som en musikalsk instruktion.
• {comment_bold: ...} eller {cb: ...} Definerer tekst, der skal vises med fed.
• {comment_italic: ...} eller {ci: ...} Definerer tekst, der skal vises som kursiv.
• {guitar_comment: ...} eller {gc: ...} Definerer en kommentar, der vises som en musikalsk instruktion.
• {start_of_verse: ..} eller {sov} Erklærer starten på en versessektion med en valgfri sektionsetiket.
• {end_of_verse} eller {eov} Erklærer slutningen på en versessektion.
• {start_of_chorus: ...} eller {soc} Erklærer starten på en korussektion med en valgfri sektionsetiket.
• {end_of_chorus} eller {eoc} Erklærer slutningen på en korussektion.
• {start_of_bridge: ...} eller {sob} Erklærer starten på en bro-sektion med en valgfri sektionsetiket.
• {end_of_bridge} eller {eob} Erklærer slutningen på en bro-sektion.
• {start_of_part: ..} eller {sop} Erklærer starten på en del med en valgfri sektionsetiket.
• {end_of_part} eller {eop} Erklærer slutningen på en del.
• {start_of_tab} eller {sot} Erklærer starten på tabulator, som OnSong gengiver i en monospaced-skrifttype.
• {end_of_tab} eller {eot} Erklærer slutningen på en tabulatorsektion.
• {new_page} eller {np} Dette bruges til at erklære en ny side.
• {new_physical_page} eller {npp} Dette bruges til at erklære en ny side.

Formateringstags

Følgende tags bruges til at definere standardskrifttypen og størrelse for tekst og akkorder i akkorddiagrammet.

• {textsize: ...} Definerer størrelsen på teksterne som en numerisk værdi i punkter.
• {textfont: ...} Definerer navnet på skrifttypen, der skal bruges til tekst. Skal understøttes på platformenen.
• {chordsize: ...} Definerer størrelsen på akkorderne som en numerisk værdi i punkter.
• {chordfont: ...} Definerer navnet på skrifttypen, der skal bruges til akkorder. Skal understøttes på platformenen.

Understøttede filtyper

ChordPro-filformatet er unikt, fordi det er en almindeligt aftalt syntaks, men ikke et standardformat. Det betyder, at forskellige leverandører kan implementere det på forskellige måder og med forskellige filtyper. OnSong understøtter følgende filtyper, når ChordPro-formaterede filer importeres:

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