ChordPro

Định dạng tệp ChordPro là một định dạng phổ biến được sử dụng trong các ứng dụng phần mềm khác. OnSong hiểu định dạng này một cách tự nhiên. OnSong nhận ra các tệp có các phần mở rộng tệp sau: .chordpro, .chopro, .cho, .crd, .pro

Định dạng ChordPro cho phép thông tin bài hát được biểu diễn trong các thẻ được phân tách bằng dấu ngoặc nhọn. Thông tin này có thể được chia logic thành các thẻ siêu dữ liệu và các thẻ nội tuyến.

Các Thẻ Siêu Dữ Liệu

Đây là các thẻ ChordPro mà bạn sẽ sử dụng trong phần siêu dữ liệu của bài hát. Trong các thẻ sau, ba dấu chấm (...) đại diện cho văn bản bạn cung cấp, nằm giữa dấu hai chấm và dấu ngoặc nhọn đóng. Ví dụ:

{title: Amazing Grace}
{key: G}

OnSong hỗ trợ các thẻ ChordPro sau:

• {title: ...} hoặc {t: ...} Tiêu đề của bài hát.
• {subtitle: ...}, {st: ...} hoặc {su: ...} Tên nghệ sĩ hoặc bất kỳ thông tin chú thích nào khác. Bạn có thể chỉ định nhiều nghệ sĩ bằng cách tách tên bằng dấu chấm phẩy. - Kim Walker-Smith; Chris Quilala
• {album: ...} Tên của album nơi chứa bài hát.
• {artist: ...} hoặc {a: ...} Tên nghệ sĩ hoặc bất kỳ thông tin chú thích nào khác. Bạn có thể chỉ định nhiều nghệ sĩ bằng cách tách tên bằng dấu chấm phẩy. - Kim Walker-Smith; Chris Quilala
• {author: ...} Tên của người tạo bảng hợp âm. Phần này được hiển thị ở dưới cùng của bảng hợp âm và trong phép chiếu lời bài hát.
• {key: ...} hoặc {k: ...} hoặc {ok: ...} Tone của bài hát được viết dưới dạng tone với sở thích enharmonic và dấu "m" tùy chọn để chỉ định minor. - chữ, ví dụ: Bb hoặc Em
• {capo: ...} Capo được đặt làm số phím - số
• {tempo: ...} Nhịp mỗi phút (BPM) - số
• {time: ...} Chữ ký thời gian - số nhịp trên số đo, ví dụ: 3/4
• {duration: ...} Độ dài bài hát cho cuộn tự động - giây hoặc mm:ss
• {book: ...} Tên của cuốn sách hoặc các cuốn sách để đặt bài hát vào. Đây là danh sách các tên sách được phân tách bằng dấu phẩy mà bài hát sẽ được đặt vào. Nếu cuốn sách không tồn tại, nó sẽ được tạo tự động.
• {number: ...} Số của bài hát - số, sử dụng cho bài hát thánh ca, năm, v.v. Bạn có thể sắp xếp bài hát theo số để tham khảo.
• {flow: ...} Sự sắp xếp các phần - danh sách nhãn phần. Xem Luồng để biết chi tiết về sắp xếp luồng của bài hát.
• {midi: ...} Các lệnh MIDI được gửi khi bài hát được xem. Xem Cú pháp MIDI để biết cách biểu diễn các lệnh MIDI dưới dạng văn bản trong OnSong.
• {midi-index: ...} Các lệnh MIDI sẽ kích hoạt bài hát này được mở trong Trình xem bài hát. Xem Cú pháp MIDI để biết cách biểu diễn các lệnh MIDI dưới dạng văn bản trong OnSong.
• {pitch: ...} Các nốt được phát khi sử dụng tính năng Ống dẫn nốt.
• {keywords: ...} hoặc {topic: ...} Danh sách các thẻ để sử dụng với tìm kiếm chủ đề. Xem Chủ đề để biết thêm thông tin về duyệt theo chủ đề.
• {copyright: ...} hoặc {footer: ...} hoặc {f: ...} Chỉ định văn bản chân trang bản quyền để xuất hiện ở dưới cùng của trang hoặc phép chiếu lời bài hát.
• {ccli: ...} Số CCLI của bài hát.
• {restrictions: ...} Quản lý quyền cho danh sách các hạn chế được phân tách bằng dấu phẩy của bài hát. Xem Hạn chế để biết chi tiết về cách đặt hạn chế cho bài hát của bạn.
• {composer: ...} Các cá nhân đã viết nhạc cho bài hát. Danh sách này phải được tách bằng dấu chấm phẩy cho các giá trị riêng biệt.
• {lyricist: ...} Các cá nhân đã viết lời cho bài hát. Danh sách này phải được tách bằng dấu chấm phẩy cho các giá trị riêng biệt.

Các Thẻ Nội Tuyến

Những thẻ này được sử dụng trong nội dung của bài hát và có thể được sử dụng để xác định các phần hoặc định dạng các phần của bài hát.

• {define: ...} được sử dụng để xác định sơ đồ hợp âm tùy chỉnh. Xem Định nghĩa hợp âm để biết thêm thông tin.
• {comment: ...} hoặc {c: ...} Xác định một bình luận và xuất hiện như một hướng dẫn âm nhạc.
• {comment_bold: ...} hoặc {cb: ...} Xác định văn bản để xuất hiện in đậm.
• {comment_italic: ...} hoặc {ci: ...} Xác định văn bản để xuất hiện dưới dạng in nghiêng.
• {guitar_comment: ...} hoặc {gc: ...} Xác định một bình luận xuất hiện như một hướng dẫn âm nhạc.
• {start_of_verse: ..} hoặc {sov} Khai báo phần bắt đầu của một câu thơ với nhãn phần tùy chọn.
• {end_of_verse} hoặc {eov} Khai báo phần kết thúc của một câu thơ.
• {start_of_chorus: ...} hoặc {soc} Khai báo phần bắt đầu của một điệp khúc với nhãn phần tùy chọn.
• {end_of_chorus} hoặc {eoc} Khai báo phần kết thúc của một điệp khúc.
• {start_of_bridge: ...} hoặc {sob} Khai báo phần bắt đầu của một cầu với nhãn phần tùy chọn.
• {end_of_bridge} hoặc {eob} Khai báo phần kết thúc của một cầu.
• {start_of_part: ..} hoặc {sop} Khai báo phần bắt đầu của một phần với nhãn phần tùy chọn.
• {end_of_part} hoặc {eop} Khai báo phần kết thúc của một phần.
• {start_of_tab} hoặc {sot} Khai báo phần bắt đầu của bản nhạc được OnSong hiển thị bằng phông chữ cách đều.
• {end_of_tab} hoặc {eot} Khai báo phần kết thúc của phần bản nhạc.
• {new_page} hoặc {np} Được sử dụng để khai báo một trang mới.
• {new_physical_page} hoặc {npp} Được sử dụng để khai báo một trang mới.

Các Thẻ Định Dạng

Các thẻ sau được sử dụng để xác định phông chữ và kích thước mặc định cho lời bài hát và hợp âm trong bảng hợp âm.

• {textsize: ...} Xác định kích thước của lời bài hát dưới dạng giá trị số tính bằng điểm.
• {textfont: ...} Xác định tên của phông chữ để sử dụng cho lời bài hát. Phải được hỗ trợ trên nền tảng.
• {chordsize: ...} Xác định kích thước của hợp âm dưới dạng giá trị số tính bằng điểm.
• {chordfont: ...} Xác định tên của phông chữ để sử dụng cho hợp âm. Phải được hỗ trợ trên nền tảng.

Các Phần Mở Rộng Tệp Được Hỗ Trợ

Định dạng tệp ChordPro là duy nhất ở chỗ nó là một cú pháp được thỏa thuận chung, nhưng không phải là một định dạng tiêu chuẩn. Điều này có nghĩa là các nhà cung cấp khác nhau có thể triển khai nó theo những cách khác nhau và với các phần mở rộng tệp khác nhau. OnSong hỗ trợ các phần mở rộng tệp sau khi nhập các tệp được định dạng ChordPro:

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