# Rakugaki Block

**日本語** | [English](#english)

---

## 日本語

色鉛筆で落書きするGutenbergブロック。ブログに手書きの温かさを添えます。

### 概要

**Rakugaki Block** は、投稿や固定ページの好きな場所に、色鉛筆で描いたような手書きの落書きをそっと添えるためのGutenbergブロックです。

高機能なお絵かきツールではなく、**数秒で書ける余白の走り書き**をコンセプトにしています。

### 機能

- 色鉛筆ブラシ（かすれ・ざらつきを表現）
- 12色の色鉛筆パレット
- キャンバスサイズ 3種類（S / M / L）
- 背景色の自由な選択
- ペンタブレット対応・筆圧感知
- Undo（元に戻す）/ クリア機能
- アクセシビリティ対応（alt属性設定）

### 動作環境

| 項目 | バージョン |
|---|---|
| WordPress | 6.6 以上 |
| PHP | 8.1 以上 |
| テスト済み | WordPress 7.0 |

### インストール

```
WordPress管理画面 → プラグイン → 新規追加 → 「Rakugaki Block」を検索
```

または zip ファイルをダウンロードして手動でアップロード。

### 使い方

1. 投稿または固定ページの編集画面を開く
2. ブロック追加ボタン（＋）をクリック
3. 「落書きメモ」を検索して追加
4. キャンバスにマウス・タッチ・ペンタブで自由に描く
5. 右サイドバーでサイズや背景色を変更

### ペンタブレットについて

Pointer Events API に対応しているため、ペンタブレットをお使いの場合は筆圧が線の太さ・濃さに反映されます。

### ライセンス

[GPL-3.0-or-later](https://www.gnu.org/licenses/gpl-3.0.html)

---

## English

<a name="english"></a>

A Gutenberg block for adding colored-pencil doodles to your posts and pages.

### Overview

**Rakugaki Block** lets you place a small hand-drawn doodle — like a quick colored-pencil sketch — anywhere in your posts or pages.

The goal is not a full-featured drawing app, but a **lightweight scribble you can finish in seconds**.

### Features

- Colored-pencil brush with texture (roughness and fading)
- 12-color pencil palette
- Three canvas sizes: S / M / L
- Freely configurable background color
- Pen tablet support with pressure sensitivity
- Undo and Clear functions
- Accessibility support (alt text for the canvas)

### Requirements

| Item | Version |
|---|---|
| WordPress | 6.6 or higher |
| PHP | 8.1 or higher |
| Tested up to | WordPress 7.0 |

### Installation

```
WordPress Admin → Plugins → Add New → Search "Rakugaki Block"
```

Or download the zip file and upload it manually.

### How to Use

1. Open the post or page editor
2. Click the block inserter ( + )
3. Search for "Rakugaki Block" and add it
4. Draw freely with your mouse, touch, or pen tablet
5. Adjust size and background color in the sidebar

### Pen Tablet Support

The block uses the Pointer Events API, so pen pressure is reflected in line width and opacity when drawing with a compatible tablet.

### License

[GPL-3.0-or-later](https://www.gnu.org/licenses/gpl-3.0.html)