2026 年 4 月 リリース(v0.3.1)
本リリースは、マニュアルサイトを Apple iPhone ユーザーガイドを参考にした v2 フレームワーク へ全面刷新し、初めて Prod 環境(https://www.act-node.com/manual/)へ公開した節目のリリースです。
#v0.3.1 パッチ(2026-04-24)
初回 v0.3.0 デプロイ直後のメタデータ整備パッチ:
- 17 章を
status: publishedに昇格 — 作物・作型別マニュアル 4 章 + FAQ 13 件。AI Bot から検索・引用可能に。- アプリマニュアル 13 章 / コネクト機能マニュアル 8 章 は、legacy PDF からの画像を使用しているため一時的に
draftのまま維持。PWA 撮影で画像を差し替えてから順次published化予定。
- アプリマニュアル 13 章 / コネクト機能マニュアル 8 章 は、legacy PDF からの画像を使用しているため一時的に
- llms.txt 生成パイプラインのバグ修正 —
sitemap-llm.jsonでdatetime.dateが直列化できずに失敗していた問題を解消(PR #82) - マニュアル 2 INDEX ページ生成機構 —
/manual2/の WP ランディングページを自動生成するgenerate-wp-index.mjs/publish-wp-index.mjsと Claude Code スキル/manual-wp-indexを追加(PR #80)
画像再撮影の進捗に応じて、個別章の draft → published を段階的に進めていきます。
#ハイライト
#🎨 読みやすい UI への刷新
- 階層サイドバー + 章内目次モーダル
- Apple 風ヒーロー + ステップカード
- 画像サイズの標準化(iPhone / PC / 概念図の 3 タイプ)
- 章末に関連章の See-also カードグリッド
- 「次へ」一方向のページャー(iPhone ガイド準拠)
- フィードバック UI の再設計(「役に立ちましたか? はい / いいえ」)
#📚 コンテンツの拡充
- FAQ 13 件 を公式サイトから移植し、検索 + タグフィルタ + アコーディオン展開で提供
- 用語集(20 用語 / 8 カテゴリ)を新設、本文で自動
<abbr>ツールチップ - 作物・作型別マニュアル を新カテゴリとして新設(養鶏ブロイラー / マルドリ栽培 / 陸上養殖 / アクアポニックス のスケルトン)
- ロール別エントリカード(🌱 初めての方 / 👥 管理者 / 📡 IoT 担当者)
#🛠️ 運用機能の強化
- 章単位 PDF ダウンロード に対応(
/pdf/<id>.pdf) - 英語対応の土台(
/en/ルート、言語切替トグル、hreflang) - コネクト機能マニュアル入口にデバイスギャラリー(TempHawk / IoTボタン / AIカメラ / カム・カード)
- 章末の「うまくいかない時」セクション(
:::troubleshoot) - オフライン閲覧(PWA / Service Worker v19)
#🤖 コンテンツ管理者向けスキル
Claude Code から呼べるスキルを整備し、継続的なブラッシュアップの土台を作成:
/manual-onboard— 新任向けオンボーディングガイド/manual-list— コンテンツ一覧・棚卸し/manual-edit-discuss— 既存章を対話で更新/manual-add— 新規コンテンツのスケルトン生成/manual-verify-app— 実アプリで手順検証 + スクショ取得
#構造比較レポート(Apple iPhone ガイド vs 本サイト)
14 項目中 8 項目(🔴 高 3 件 / 🟡 中 5 件)を実装完了。残る 🟢 低 6 件(バージョン切替 UI / 逆引き UI / 互換性マトリクス 等)は後続リリースで対応。
#既知の制限事項
- 個別章本文の英訳は未対応(UI chrome のみ英訳、本文は JA ページへのリンク)
- 一部の章は hero 画像が
_legacy/PDF 由来のため低解像度(manual-verify-appskill で順次撮り直し予定) - 動画コンテンツは未配信
#次のリリース以降の計画
- 各章 hero 画像の撮り直し(iPhone / PC スタイル別)
- 章本文の英訳(優先度の高い章から順に)
- FAQ の継続的追加(Bot 未解決ログから抽出)
- A-4 Hero 画像強化 / A-5 バージョン切替 UI / C-7 互換性マトリクスなど低優先項目
#対応 PR 一覧(主なもの)
| PR | 概要 |
|---|---|
| #59 | 🔴高 A-2 Next pager / A-3 See-also / C-3 :::troubleshoot |
| #60 | 🟡中 C-1 ロール別エントリ + A-1 章タイトル動詞化 |
| #61 | 🟡中 カテゴリ頭文字 + 章番号シンプル化 |
| #62 | 🟡中 C-4 用語集 + <abbr> 自動付与 |
| #63 | 🟡中 C-2 デバイスギャラリー |
| #64 | コンテンツ管理者向け 4 スキル |
| #65 | コンテンツ管理者オンボーディング |
| #66 | 画像標準サイズ(:::figure 3 タイプ) |
| #67 | ナビ末尾を iPhone 式 1 方向 Next-only に |
| #68 | フィードバック UI を iPhone ガイド準拠に再設計 |
| #69 | 章単位 PDF ダウンロード導線 |
| #70 | SVG アイコンが黒塗り四角になる問題を修正 |
| #71 | :::hero placeholder + 低画質 hero 画像 4 件を置換 |
| #72 | 英語対応の土台(/en/ ルート + 言語切替) |
| #73 | README 初学者向けセットアップ手順(Mac/Windows 分岐) |
| #74 | FAQ 13 件を初期コンテンツとして追加 |
| #75 | トップページのカテゴリカードに説明文 |
| #76 | 章単位 PDF を publish パイプラインで生成・配信 |
| #77 | カテゴリ D「作物・作型別 利用方法マニュアル」新設 |
| #78 | FAQ アコーディオン + 検索 + タグフィルタ |
| #80 | /manual2/ WP INDEX ページ生成 + WP REST API 投稿 + スキル |
| #81 | 全 38 章を status: published に昇格 |
| #82 | sitemap-llm.json の datetime.date 直列化バグを修正 |
関連する章
このページは役に立ちましたか?
ご意見ありがとうございます。マニュアル改善に活用します。