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 dạng 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 thị dưới dạng các thẻ được phân định bởi 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.

Thẻ Siêu Dữ Liệu

Đây là những 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, xuất hiện 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 dòng 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 bài hát được đặt.
• {artist: ...} hoặc {a: ...} Tên nghệ sĩ hoặc bất kỳ thông tin dòng 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 biểu đồ hợp âm. Điều này được hiển thị ở dưới cùng của biểu đồ hợp âm và trong phép chiếu lời bài hát.
• {key: ...} hoặc {k: ...} hoặc {ok: ...} Phím của bài hát được viết dưới dạng một phím có sở thích enharmonic và một "m" tùy chọn để chỉ ra nhỏ. - theo bảng chữ cái, ví dụ Bb hoặc Em
• {capo: ...} Capo được đặt làm số của các phím - số
• {tempo: ...} Số nhịp trên phút (BPM) - số
• {time: ...} Chữ ký thời gian - số nhịp trên biện pháp, ví dụ 3/4
• {duration: ...} Độ dài bài hát để cuộn tự động - giây hoặc mm:ss
• {book: ...} Tên của cuốn sách hoặc những 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ự động tạo.
• {number: ...} Số của bài hát - số, sử dụng cho bài thánh ca, năm, v.v. Bạn có thể sắp xếp các bài hát theo số để tham khảo.
• {flow: ...} Sự sắp xếp của các phần - danh sách các 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 để gửi khi bài hát được xem. Xem Cú pháp MIDI để biết cách biểu thị 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 thị các lệnh MIDI dưới dạng văn bản trong OnSong.
• {pitch: ...} Các nốt để chơi khi sử dụng tính năng Ống Pitch.
• {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: ...} 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ề việc đặt hạn chế cho bài hát của bạn.

Thẻ Nội Tuyến

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

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

Thẻ Định Dạng

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

• {textsize: ...} Định nghĩa kích thước của lời bài hát là giá trị số tính bằng điểm.
• {textfont: ...} Định nghĩa 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: ...} Định nghĩa kích thước của các hợp âm là giá trị số tính bằng điểm.
• {chordfont: ...} Định nghĩa 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.

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 công nhận rộng rãi, 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ể thực hiện 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