`ruby` 機能は CJK テキストに読み仮名（ルビ）注釈を追加し、インライン構文を標準の HTML `<ruby>` マークアップへと描画します。

:::note[zfb 0.1.0-next.14 以降が必要]

`{base}^{ruby}` 構文は zfb `0.1.0-next.13` で SSR レンダリングが 500 を返していました（[#1815](https://github.com/zudolab/zudo-doc/issues/1815)）。zfb `0.1.0-next.14`（アップストリーム Takazudo/zudo-front-builder#600）で修正され、zudo-doc の `zfb.config.ts` で有効化されています — 以下のライブ例は実際のパイプラインで描画されたものです。

:::

## 設定

:::note[標準プリセットに含まれます]

`zudoDoc()` は Ruby を有効にします。個別の設定フィールドは不要です。

```ts title="zfb.config.ts"
import { defineConfig } from "zfb/config";
import { zudoDoc } from "@takazudo/zudo-doc/config";

export default defineConfig(
  zudoDoc({
    siteName: "My Docs",
  }),
);
```

`defineConfig({ markdown: { features: { ruby: true } } })` を直接書くと、プリセットの残り（githubAlerts、codeTabs、tocExport など）が失われます。代わりに `zudoDoc({...})` を使ってください。

:::

## 構文

注釈は、ベーステキストの直後にキャレットと波括弧で読みを記述する形式です — `{base}^{ruby}`。ベースはキャレットの直前にある連続した文字列です。

```md
日本語^{にほんご}
```

## ライブ例

上記のソースを、このページのパイプラインで描画した結果です。

日本語^{にほんご}

## HTML 出力

注釈は意味のある `<ruby>` マークアップとして描画されます。

```html
<ruby><rb>日本語</rb><rt>にほんご</rt></ruby>
```

## スコープ

この機能は明示的な `{base}^{ruby}` 構文のみを解析します。漢字の自動検出や形態素解析によるふりがなの自動付与は行いません — これは意図的にスコープ外としています。ベースはキャレット直前の連続した文字から貪欲に取られるため、注釈の範囲を狭めたい場合は前のテキストとの間に区切りを入れてください。