# Japanese Calendar

A calendar plugin for Obsidian with full support for Japanese public holidays, wareki (Japanese era), rokuyo, and kichijitsu (auspicious/inauspicious days). Click any date to create or open a daily note automatically.

## Features

- Japanese public holidays highlighted in red (official Cabinet Office data)
- Holiday names displayed inside calendar cells
- Wareki (Japanese era: Reiwa, Heisei, Showa) display
- Rokuyo (Taian, Butsumetsu, etc.) display
- **Kichijitsu display** — 天赦日 (Tenshanichi), 一粒万倍日 (Ichiryū Manbai-nichi), 不成就日 (Fujōju-nichi)
- **Hover tooltip** — hover over any date to see holiday name, rokuyo, and kichijitsu at a glance
- Click a date to create or open a daily note
- Automatic holiday callout insertion in daily notes
- Color-coded weekends (Saturday/Sunday)
- Previous and next month dates shown
- Automatically follows Obsidian light/dark theme

---

日本の祝日・振替休日に対応した Obsidian 用カレンダープラグインです。

## 機能

- 日本の祝日・振替休日を赤色で表示（内閣府公式データ）
- 祝日名をカレンダーセル内に表示
- 和暦（令和・平成・昭和）表示対応
- 六曜（大安・仏滅など）表示対応
- **吉凶日表示** — 天赦日・一粒万倍日・不成就日をカレンダーに表示
- **ホバーツールチップ** — 日付にマウスを乗せると祝日名・六曜・吉凶日をポップアップ表示
- 日付クリックでデイリーノートを自動作成・オープン
- デイリーノートに祝日 callout を自動挿入
- 土曜・日曜の色分け表示
- 前月・翌月の日付も表示
- Obsidian のライト / ダークテーマに自動追従

## Installation

### Community plugins

1. Open **Settings → Community plugins → Browse**
2. Search for "Japanese Calendar"
3. Click **Install**, then **Enable**

### Manual installation

Download `main.js`, `manifest.json`, and `styles.css` from the latest [Release](https://github.com/dualyze-ai/obsidian-japanese-calendar/releases), then place them in your vault under `.obsidian/plugins/japanese-calendar/`.

---

## インストール方法

### コミュニティプラグイン経由

1. Obsidian の **設定 → コミュニティプラグイン → 検索**
2. "Japanese Calendar" を検索
3. **インストール** → **有効化**

### 手動インストール

最新の [Release](https://github.com/dualyze-ai/obsidian-japanese-calendar/releases) から
`main.js` / `manifest.json` / `styles.css` をダウンロードし、
Vault 内の `.obsidian/plugins/japanese-calendar/` に配置してください。

## 設定

| 設定名 | デフォルト | 説明 |
|--------|-----------|------|
| デイリーノートの保存フォルダ | Daily Notes | ノートの保存先フォルダ |
| ファイル名フォーマット | YYYY-MM-DD | moment.js フォーマット |
| テンプレートファイルのパス | （空欄） | カスタムテンプレートのパス |
| 和暦を表示する | ON | ヘッダーに令和〇年を表示 |
| 祝日名を表示する | ON | セル内に祝日名を表示 |
| 六曜を表示する | OFF | 大安・仏滅などを表示 |
| 吉凶日を表示する | ON | 天赦日・一粒万倍日・不成就日を表示 |
| 　天赦日 | ON | 天赦日の表示（吉日） |
| 　一粒万倍日 | ON | 一粒万倍日の表示（吉日） |
| 　不成就日 | ON | 不成就日の表示（凶日） |
| ホバーで詳細を表示する | ON | マウスオーバーで祝日・六曜・吉凶日をポップアップ |
| 週の開始曜日 | 日曜日 | 日曜 or 月曜始まり |
| 祝日を自動挿入する | ON | 祝日のノートに callout を挿入 |
| ステータスバーに祝日数を表示する | ON | 今月の祝日数を表示 |

## 吉凶日について

| 種類 | 説明 | 周期 |
|------|------|------|
| 天赦日 | 年に5〜6回。すべての罪が許される最上の大吉日 | 干支60日サイクル×季節 |
| 一粒万倍日 | 月に数回。小さな物事が大きく育つとされる吉日 | 旧暦月×日の地支 |
| 不成就日 | 月に数回。何事も成就しないとされる凶日 | 旧暦月×日の地支 |

## テンプレート変数

カスタムテンプレートで使用できるプレースホルダー：

| 変数 | 説明 |
|------|------|
| `{{date}}` | 日付（設定フォーマット） |
| `{{date:YYYY}}` | 年 |
| `{{date:MM}}` | 月 |
| `{{date:DD}}` | 日 |
| `{{holiday}}` | 祝日名（祝日でない場合は空） |
| `{{rokuyo}}` | 六曜 |
| `{{wareki}}` | 和暦（例：令和8年） |

## 技術スタック

- TypeScript
- Obsidian Plugin API
- [@holiday-jp/holiday_jp](https://github.com/holiday-jp/holiday_jp-js) — 日本の祝日データ（内閣府公式）

## Changelog

### v1.0.12
- **吉凶日表示** — 天赦日・一粒万倍日・不成就日をカレンダーに表示（種類別ON/OFF対応）
- **ホバーツールチップ** — 日付にマウスを乗せると祝日・六曜・吉凶日をポップアップ表示
- author を DualyzeAI、authorUrl を dualyzeai.com に変更

### v1.0.9
- カレンダーのセル高さが祝日名の折り返しでずれる問題を修正

### v1.0.8
- 初回コミュニティプラグイン公開

---

## ライセンス

MIT