Chú âm Ruby (Ruby Annotation)
Chữ nhỏ được đặt phía trên các ký tự đích (khi viết ngang) hoặc bên phải (khi viết dọc) để chỉ cách đọc của chữ Hán hoặc từ ngoại lai. Trong HTML, chú âm này được triển khai bằng phần tử <ruby>.
Ruby (ruby annotation) là furigana, tức chữ kana nhỏ chỉ cách đọc của chữ Hán. Tên gọi bắt nguồn từ tên gọi cỡ chữ in trong in typo: vì con chữ cỡ 5,5 point nhập từ Anh được gọi là ruby, nên furigana được sắp bằng con chữ này dần được gọi là ruby. Ruby được dùng rộng rãi trong sách, báo và sách giáo khoa tiếng Nhật, và đặc biệt là yếu tố ghi chép không thể thiếu trong nội dung dành cho trẻ em hoặc văn bản có chứa chữ Hán khó đọc.
Để triển khai ruby trong HTML, dùng phần tử <ruby>. Khi viết <ruby>漢字<rt>かんじ</rt></ruby>, chữ "かんじ" (kanji) sẽ được hiển thị nhỏ phía trên "漢字" (chữ Hán). Nếu ghi kèm phần tử <rp>, ở môi trường không hiểu ruby, chữ sẽ được hiển thị nối tiếp kèm dấu ngoặc như "漢字 (かんじ)". Tính đến tháng 8 năm 2026, các trình duyệt chính đều hỗ trợ <ruby>, <rt>, <rp>, nên những trường hợp cơ chế dự phòng phát huy tác dụng khi hiển thị trên trình duyệt là có hạn, nhưng khi đi qua công cụ chỉ trích xuất văn bản từ HTML thì dấu ngoặc sẽ còn lại.
Ruby được gọi bằng các tên khác nhau tùy theo cách gắn. Mono ruby là cách ghi cách đọc cho từng chữ Hán một, như "東京" (Tokyo), giúp cách đọc của từng chữ trở nên rõ ràng, và được dùng trong sách giáo khoa hoặc tài liệu học tập, nơi sự tương ứng giữa chữ và cách đọc là quan trọng. Group ruby là cách ghi cách đọc cho cả từ, hiển thị như "東京". Với jukujikun (cách đọc gán cho cả cụm chữ) như "きょう" (kyō, hôm nay) cho "今日", vì không thể gán cách đọc cho từng chữ một, nên chỉ có thể chọn group ruby. Cách bố trí vừa xử lý cả từ ghép như một khối vừa giữ sự tương ứng giữa chữ và cách đọc đôi khi được gọi riêng là jukugo ruby. Cũng có cách gọi theo phạm vi gắn: ghi cho tất cả chữ Hán là sō-ruby, chỉ ghi cho những từ khó là para-ruby. Trong HTML, nếu xếp xen kẽ chữ gốc và <rt> bên trong một <ruby> thì tương đương mono ruby, còn nếu viết từ ghép và cách đọc thành 1 cặp thì tương đương group ruby.
Cách xử lý ruby khi đếm ký tự rất phức tạp. Có tính văn bản ruby (phần furigana) vào số ký tự hay không là tùy mục đích. Khi đếm số ký tự trên genkō yōshi (giấy kẻ ô viết bản thảo), ruby không được tính vào số ký tự. Mặt khác, trong mã nguồn HTML, văn bản bên trong <rt> cũng tồn tại như một chuỗi ký tự, nên khi lấy nội dung văn bản của DOM, phần thân và ruby sẽ bị nối liền như "漢字かんじ". Dấu ngoặc đặt trong <rp> cũng bị nối liền theo cách tương tự, nên xử lý loại trừ ruby cần nhắm vào cả <rt> lẫn <rp>. Vì có trường hợp chỉ muốn đếm phần thân và có trường hợp muốn đếm cả ruby, nên cần quyết định trước sẽ đếm theo cách nào.
CSS có ruby-position quyết định đặt ruby ở trên hay ở dưới, ruby-align quyết định cách căn khi độ dài của chữ gốc và ruby khác nhau, và ruby-overhang quyết định có cho phép ruby tràn lên trên ký tự bên cạnh hay không. Các giá trị của ruby-align là start, center, space-between, space-around, và giá trị ban đầu là space-around, phân bổ khoảng trống cả ở phía trước và phía sau. ruby-position và ruby-align đã dùng được trên các trình duyệt chính từ tháng 12 năm 2024, nhưng vì có trình duyệt chưa hỗ trợ ruby-overhang, nên tính đến tháng 8 năm 2026 vẫn không thể thiết kế dựa trên giả định điều khiển được phần tràn. Trong dàn trang, nguyên tắc cơ bản là dùng cỡ chữ bằng một nửa chữ gốc cho ruby, nên với 2 chữ Hán thì cách đọc tối đa 4 ký tự sẽ nằm gọn trong độ rộng của chữ gốc. Với cách đọc vượt quá mức này, ví dụ khi ghi cách đọc 3 ký tự cho 1 chữ như "さくら" (sakura) cho "桜" (hoa anh đào), ruby sẽ dài hơn chữ gốc, nên cần điều chỉnh như nới khoảng cách giữa các chữ gốc, thu hẹp hình chữ của ruby, hoặc cho tràn sang các chữ phía trước và phía sau.
Về khả năng truy cập, cần lưu ý rằng cách đọc ruby khác nhau tùy theo trình đọc màn hình. Có loại đọc ruby tiếp theo sau phần thân, có loại không đọc ruby, có loại chuyển đổi được bằng thiết lập, nên không phải môi trường nào cũng truyền đạt được cách đọc. Tránh cách viết khiến thông tin bị thiếu khi ruby không được đọc, và viết sao cho chỉ riêng phần thân cũng đủ hiểu nghĩa. Với những từ muốn truyền đạt chắc chắn cách đọc, cũng có cách ghi bằng dấu ngoặc ngay trong phần thân ở lần xuất hiện đầu tiên như "薔薇 (ばら)" (hoa hồng).