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øllede klammer. Disse oplysninger kan logisk opdeles i metadatatags og inline-tags.

Metadatatags

Dette er ChordPro-tags, som du ville bruge i metadatadelen af sangen. I de følgende tags repræsenterer tre punkter (...) den tekst, du udfylder, som placeres mellem kolonet og den lukkende krøllet klammer. 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 eventuelle andre undertekstoplysninger. Du kan angive flere kunstnere ved at adskille navne med semikolon. - Kim Walker-Smith; Chris Quilala
• {album: ...} Navnet på det album, hvor sangen er placeret.
• {artist: ...} eller {a: ...} Kunstnernavnet eller eventuelle andre undertekstoplysninger. Du kan angive flere kunstnere ved at adskille navne med semikolon. - Kim Walker-Smith; Chris Quilala
• {author: ...} Navnet på den person, der oprettede akkordskemaet. Dette vises nederst på akkordskemaet og i lyriken-projektion.
• {key: ...} eller {k: ...} eller {ok: ...} Sangens toneart skrevet som en toneart med enharmonisk præference og en valgfri "m" for at angive mol. - alfabetisk, f.eks. Bb eller Em
• {capo: ...} Kapo'en, som skal indstilles som antal bånd - numerisk
• {tempo: ...} Slag pr. minut (BPM) - numerisk
• {time: ...} Taktarten - numerisk slag over takt, f.eks. 3/4
• {duration: ...} Sanglængde til automatisk scroll - 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, oprettes den automatisk.
• {number: ...} Sangens nummer - numerisk, bruges til hymner, år osv. Du kan sortere sange efter nummeret til reference.
• {flow: ...} Arrangeringen af sektioner - liste over sektionsetiketter. Se Flow for detaljer om at arrangere flowet af en sang.
• {midi: ...} De MIDI-kommandoer, der skal sendes, når sangen vises. Se MIDI-syntaks for hvordan man udtrykker MIDI-kommandoer som tekst i OnSong.
• {midi-index: ...} De MIDI-kommandoer, der vil udløse, at denne sang åbnes i Sangvisualisering. Se MIDI-syntaks for hvordan man udtrykker MIDI-kommandoer som tekst i OnSong.
• {pitch: ...} Noterne, der skal afspilles, når funktionen Tonepibe bruges.
• {keywords: ...} eller {topic: ...} Listen over tags til brug med emnesøgning. Se Emner for mere information om browsing efter emne.
• {copyright: ...} eller {footer: ...} eller {f: ...} Angiver copyrightfooter-tekst, der skal vises nederst på siden eller i lyriken-projektion.
• {ccli: ...} Sangens CCLI-nummer.
• {restrictions: ...} Rettighedsstyringen for sangens kommaseparerede liste over begrænsninger. Se Begrænsninger 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 lyriken til sangen. Denne liste skal adskilles med semikoloner for separate værdier.

Inline-tags

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

• {define: ...} bruges til at definere brugerdefinerede akkorddiagrammer. Se Definition 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 i 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 vers-sektion med en valgfri sektionetiket.
• {end_of_verse} eller {eov} Erklærer slutningen på en vers-sektion.
• {start_of_chorus: ...} eller {soc} Erklærer starten på en kor-sektion med en valgfri sektionetiket.
• {end_of_chorus} eller {eoc} Erklærer slutningen på en kor-sektion.
• {start_of_bridge: ...} eller {sob} Erklærer starten på en bro-sektion med en valgfri sektionetiket.
• {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 sektionetiket.
• {end_of_part} eller {eop} Erklærer slutningen på en del.
• {start_of_tab} eller {sot} Erklærer starten på tabulatur, som OnSong gengiver i en monospace-skrifttype.
• {end_of_tab} eller {eot} Erklærer slutningen på en tabulatur-sektion.
• {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

De følgende tags bruges til at definere standardskrifttype og -størrelse for lyriken og akkorder i akkordskemaet.

• {textsize: ...} Definerer størrelsen på lyriken som en numerisk værdi i punkter.
• {textfont: ...} Definerer navnet på den skrifttype, der skal bruges til lyriken. Skal være understøttet på platformen.
• {chordsize: ...} Definerer størrelsen på akkordef som en numerisk værdi i punkter.
• {chordfont: ...} Definerer navnet på den skrifttype, der skal bruges til akkorder. Skal være understøttet på platformen.

Understøttede filtyper

ChordPro-filformatet er unikt, idet 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 man importerer ChordPro-formaterede filer:

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