ChordPro

ChordPro 파일 형식은 다른 소프트웨어 응용 프로그램에서 사용되는 일반적인 형식입니다. OnSong은 이 형식을 기본적으로 이해합니다. OnSong은 다음 파일 확장자를 가진 파일을 인식합니다: .chordpro, .chopro, .cho, .crd, .pro

ChordPro 형식을 사용하면 곡 정보를 중괄호로 구분된 태그로 표현할 수 있습니다. 이 정보는 논리적으로 메타데이터 태그와 인라인 태그로 나눌 수 있습니다.

메타데이터 태그

이것들은 곡의 메타데이터 부분에서 사용할 ChordPro 태그입니다. 다음 태그에서 세 개의 점(...)은 사용자가 제공하는 텍스트를 나타내며, 이는 콜론과 닫는 중괄호 사이에 위치합니다. 예를 들면:

{title: Amazing Grace}
{key: G}

OnSong은 다음 ChordPro 태그를 지원합니다:

• {title: ...} 또는 {t: ...} 곡의 제목입니다.
• {subtitle: ...}, {st: ...} 또는 {su: ...} 아티스트 이름 또는 기타 부제 정보입니다. 세미콜론으로 이름을 구분하여 여러 아티스트를 지정할 수 있습니다. - Kim Walker-Smith; Chris Quilala
• {album: ...} 곡이 위치한 앨범의 이름입니다.
• {artist: ...} 또는 {a: ...} 아티스트 이름 또는 기타 부제 정보입니다. 세미콜론으로 이름을 구분하여 여러 아티스트를 지정할 수 있습니다. - Kim Walker-Smith; Chris Quilala
• {author: ...} 코드 차트를 만든 사람의 이름입니다. 이는 코드 차트 아래와 가사 프로젝션에 표시됩니다.
• {key: ...} 또는 {k: ...} 또는 {ok: ...} 곡의 키는 음역 선호도와 마이너를 나타내는 선택적 "m"으로 작성됩니다. - 알파벳 예: Bb 또는 Em
• {capo: ...} 프렛 수로 설정할 카포 - 숫자
• {tempo: ...} 분당 비트(BPM) - 숫자
• {time: ...} 박자표 - 숫자 박자/마디 예: 3/4
• {duration: ...} 자동 스크롤을 위한 곡의 길이 - 초 또는 mm:ss
• {book: ...} 곡을 배치할 책 또는 책들의 이름입니다. 이것은 곡이 배치될 책 이름의 쉼표로 구분된 목록입니다. 책이 존재하지 않으면 자동으로 생성됩니다.
• {number: ...} 곡의 번호 - 숫자, 찬송가, 연도 등에 사용합니다. 참조를 위해 번호로 곡을 정렬할 수 있습니다.
• {flow: ...} 섹션의 배열 - 섹션 레이블 목록입니다. 곡의 흐름을 배열하는 방법에 대한 자세한 내용은 흐름을 참조하세요.
• {midi: ...} 곡을 볼 때 보낼 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법은 MIDI 구문을 참조하세요.
• {midi-index: ...} 곡 뷰어에서 이 곡을 열기 위해 트리거할 MIDI 명령입니다. OnSong에서 MIDI 명령을 텍스트로 표현하는 방법은 MIDI 구문을 참조하세요.
• {pitch: ...} 음정 파이프 기능을 사용할 때 재생할 음표입니다.
• {keywords: ...} 또는 {topic: ...} 토픽 검색에 사용할 태그 목록입니다. 토픽별로 검색하는 방법에 대한 자세한 내용은 토픽을 참조하세요.
• {copyright: ...} 또는 {footer: ...} 또는 {f: ...} 페이지 아래 또는 가사 프로젝션에 표시될 저작권 푸터 텍스트를 지정합니다.
• {ccli: ...} 곡의 CCLI 번호입니다.
• {restrictions: ...} 곡의 권리 관리를 위한 쉼표로 구분된 제한 사항 목록입니다. 곡에 대한 제한 사항 설정에 대한 자세한 내용은 제한 사항을 참조하세요.
• {composer: ...} 곡의 음악을 작곡한 사람들입니다. 이 목록은 별도의 값을 위해 세미콜론으로 구분되어야 합니다.
• {lyricist: ...} 곡의 가사를 작곡한 사람들입니다. 이 목록은 별도의 값을 위해 세미콜론으로 구분되어야 합니다.

인라인 태그

이 태그들은 곡의 내용 내에서 사용되며 섹션을 정의하거나 곡의 부분을 포맷하는 데 사용할 수 있습니다.

• {define: ...} 사용자 정의 코드 다이어그램을 정의하는 데 사용됩니다. 자세한 내용은 코드 정의를 참조하세요.
• {comment: ...} 또는 {c: ...} 주석을 정의하고 음악 지시 사항으로 나타납니다.
• {comment_bold: ...} 또는 {cb: ...} 굵게 표시될 텍스트를 정의합니다.
• {comment_italic: ...} 또는 {ci: ...} 기울임꼴로 표시될 텍스트를 정의합니다.
• {guitar_comment: ...} 또는 {gc: ...} 음악 지시 사항으로 표시되는 주석을 정의합니다.
• {start_of_verse: ..} 또는 {sov} 선택적 섹션 레이블이 있는 절의 시작을 선언합니다.
• {end_of_verse} 또는 {eov} 절 섹션의 끝을 선언합니다.
• {start_of_chorus: ...} 또는 {soc} 선택적 섹션 레이블이 있는 후렴의 시작을 선언합니다.
• {end_of_chorus} 또는 {eoc} 후렴 섹션의 끝을 선언합니다.
• {start_of_bridge: ...} 또는 {sob} 선택적 섹션 레이블이 있는 브릿지 섹션의 시작을 선언합니다.
• {end_of_bridge} 또는 {eob} 브릿지 섹션의 끝을 선언합니다.
• {start_of_part: ..} 또는 {sop} 선택적 섹션 레이블이 있는 부분의 시작을 선언합니다.
• {end_of_part} 또는 {eop} 부분의 끝을 선언합니다.
• {start_of_tab} 또는 {sot} OnSong이 모노스페이스 글꼴로 렌더링하는 태블러처의 시작을 선언합니다.
• {end_of_tab} 또는 {eot} 태블러처 섹션의 끝을 선언합니다.
• {new_page} 또는 {np} 새 페이지를 선언하는 데 사용됩니다.
• {new_physical_page} 또는 {npp} 새 페이지를 선언하는 데 사용됩니다.

포맷팅 태그

다음 태그는 코드 차트에서 가사 및 코드의 기본 글꼴 및 크기를 정의하는 데 사용됩니다.

• {textsize: ...} 가사의 크기를 포인트 단위의 숫자 값으로 정의합니다.
• {textfont: ...} 가사에 사용할 글꼴의 이름을 정의합니다. 플랫폼에서 지원해야 합니다.
• {chordsize: ...} 코드의 크기를 포인트 단위의 숫자 값으로 정의합니다.
• {chordfont: ...} 코드에 사용할 글꼴의 이름을 정의합니다. 플랫폼에서 지원해야 합니다.

지원되는 파일 확장자

ChordPro 파일 형식은 일반적으로 합의된 구문이지만 표준 형식이 아니라는 점에서 고유합니다. 이는 다양한 공급업체가 다양한 방식과 다양한 파일 확장자로 이를 구현할 수 있음을 의미합니다. OnSong은 ChordPro 형식의 파일을 가져올 때 다음 파일 확장자를 지원합니다:

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