=== 빛과소금 피아노 악보 플레이어 ===
Version: 1.5.0

사용법
1. 플러그인을 설치하고 활성화합니다.
2. 고정 페이지(또는 글)에 숏코드를 넣습니다:  [lightsalt_piano_player]
3. 방문자는 MusicXML(.musicxml / .xml / .mxl) 파일을 열어 피아노 소리로 듣고, 음표를 클릭해 바로 수정한 뒤 MusicXML 또는 PDF로 저장할 수 있습니다.

숏코드 옵션
- width : 악보 영역 최대 너비(px). 기본 1240. 예) [lightsalt_piano_player width="1000"], 제한 없음은 width="0"
- top   : 스크롤할 때 상단 도구바가 멈추는 위치(px). 테마 헤더가 화면 상단에 고정되어 있다면 그 높이를 입력. 예) [lightsalt_piano_player top="70"]

연습 도구 (v1.4.0)
- 계이름 표시: [계이름 표시]를 켜면 음표 아래에 도레미가 나타납니다. 고정도(C=도) / 이동도(곡의 으뜸음=도) 선택, 설정은 브라우저에 기억됩니다.
- 느리게 재생: 속도 50% / 75% / 100% 버튼(슬라이더 40~200%는 그대로).
- 구간 반복: 음표 클릭(또는 재생 중) 후 [시작 A] [끝 B] 또는 [이 마디만] → [구간 반복 켜기]. 구간 끝에서 소리가 끊기지 않고 처음으로 이어집니다. 구간 밖을 직접 선택해 재생하면 반복이 꺼집니다.

연습 도구 2차 (v1.5.0)
- 손별 재생: [양손] [오른손만] [왼손만] 버튼. 꺼 둔 손의 음표는 악보에서 흐리게 보입니다. (기존 오른손/왼손 체크박스도 그대로 사용 가능)
- 가상 건반: 화면 아래에 악보 음역에 맞춘 건반이 붙고, 재생 중인 음이 오른손(빨강)/왼손(보라) 색으로 눌립니다. 건반을 직접 눌러 소리를 들을 수 있고, 계이름 표시를 켜면 건반에도 도레미가 나옵니다.
- 조옮김: [▼ 낮게] [▲ 높게]로 반음씩(Shift+클릭은 옥타브) 악보를 옮깁니다. 조표와 음표가 함께 바뀌고 되돌리기(Ctrl+Z)가 되며, 저장하면 바뀐 조로 저장됩니다. [원래 조로]로 처음 조로 복귀.
- [연습 도구 ▾] 버튼으로 연습 도구 줄을 접고 펼 수 있습니다(선택은 브라우저에 기억).

특징
- 오른손(위 단)/왼손(아래 단)이 같은 시각에 시작하도록 마디 시간을 정확히 계산 (backup/forward/화음/붙임줄/도돌이표 처리)
- 작곡가 이름은 악보 오른쪽 위에서 클릭해 바로 수정(제목 영역은 제거됨)
- 제목(굵은 글씨, 가운데)/부제목/작사·작곡 글자를 고딕체로 클릭해서 바로 수정 (작사·작곡은 오선 왼쪽 끝에 정렬, PDF에도 동일하게 출력)
- 저장: 우측 상단 [저장 ▾] → MusicXML(.musicxml) 또는 PDF(A4, 줄 단위로 쪽 나눔)
- 모든 처리는 브라우저 안에서만 이루어지며 파일이 서버로 전송되지 않음
- 악보 엔진(OpenSheetMusicDisplay 1.9.2), JSZip, jsPDF를 플러그인에 포함 - 외부 CDN 없이 동작(로드 실패 시에만 CDN 보조 사용)
- 한 페이지에 숏코드는 1개만 사용하세요.

키보드: Space 재생/일시정지, ←/→ 음표 이동, ↑/↓ 반음, Shift+↑/↓ 옥타브, 1~7 또는 A~G 음 이름, Delete 쉼표로, Ctrl+Z/Y 되돌리기, Ctrl+S MusicXML 저장
