HeredicTree JS Portable テスト利用ガイド
========================================

起動方法
--------

「index.html」をダブルクリックしてください。
MacとWindowsの一般的なブラウザで、Node.jsやPythonをインストールせずに利用できます。

このHTMLにはアプリ本体、画面デザイン、日本語フォント、6つのサンプルデータが内蔵されています。インターネット接続は不要です。

v0.1.36では、2026年9月29日版のロゴを画面ヘッダー・ヘルプ・別ウィンドウ・ブラウザのタブアイコンへ反映しています。ロゴもHTMLに内蔵されています。

兄弟姉妹の追加・順番変更（v0.1.37）
-----------------------------------

個人を選び、詳細の「前に兄弟姉妹を追加」「後に兄弟姉妹を追加」を押すと、同じ親の子として挿入します。
後ろの番号と親子・配偶者・養子・双子の参照もまとめて更新します。
「兄弟姉妹の中で前へ／後へ」は隣の兄弟姉妹と順番を交換します。
親の組が複数ある場合は操作する組を選びます。親を表示しない兄弟にも対応しています。
新しい人には養子・双子の指定をコピーしません。
操作した世代の手動配置は解除します。「元に戻す」で番号・関係・配置をまとめて復元できます。
JSONのデータ形式は従来どおりです。

ラベルと性別・記号の編集
----------------------

一覧のラベル欄は、編集中に最大6行まで広がります。詳細欄は4〜10行で編集でき、長い文章は縦スクロールします。
Enterで入力した改行は家系図にも反映されます。
性別・記号は候補を選ぶほか、N3・N4・M3・F4・Nnなどを直接入力できます。未対応のコードは保持して警告を表示します。

発端者と相談者の表示
--------------------

発端者だけの場合は、人物記号の左下にPを表示します。相談者でもある場合は、Pを矢印の始点に添えます。
周囲の説明文や記号に応じて位置を調整し、近親度表示を切り替えてもPと矢印の位置を保ちます。SVG・PNGにも同じ配置を反映します。

近親度の表示
------------

家系図の「近親度を表示（遺伝医学）」をオンにすると、発端者から第1〜3度の血縁者を濃いマゼンタから淡いピンクで表示します。
発端者が複数いる場合は基準の1人を選択します。発端者がいない場合は個人の詳細で指定してください。
人をクリックすると続柄と近親度を確認できます。「近親度の見方・判定ルール」から法律上の親等との違いを確認できます。
画像に色を含める場合は、エクスポートで「近親度の色・ラベル・凡例を含める」を選択します。通常の画像保存は白黒です。
この表示設定は通常のJSONへ保存されませんが、再編集用データ付き画像には保存されます。親の情報が不足する場合は判定を推測しません。

SVG・PNGからの編集再開（v0.1.35）
--------------------------------

SVG・PNGには標準で再編集用データを埋め込みます。「ファイルを開く（JSON・SVG・PNG）」で画像を選択すると、家系図・レイアウト・手動配置・出力時の近親度表示と凡例・言語を復元します。
「再編集用データを含める」をオフにすると通常の画像になります。オンの場合は、図に表示されないメモなども含みます。
v2では添付ファイルの原本もJSON・SVG・PNGの再編集用データに含まれます。固定容量上限はありませんが、扱える容量は端末とブラウザに依存します。画像の再保存・最適化でデータが消えた場合やスクリーンショットからは復元できません。通常のJSON保存も利用できます。

注意事項
--------

- 編集内容は自動保存されません。終了前にJSONを保存してください。
- SVG、PNG、JSONを保存できます。
- PWAとしてのインストール機能はありません。
- 診断や医療上の助言を行うアプリケーションではありません。
- HTMLファイルの名前は変更できますが、内容は変更しないでください。
- ファイルが破損していないか確認する場合はSHA256SUMS.txtを利用できます。

画面右下の「注意事項・引用情報」「ライセンス」で文書を読めます。引用情報とフォントのライセンスは「注意事項・引用情報」の下部で展開できます。「閉じる」またはEscキーで戻ります。文書は内蔵しており、インターネット接続は不要です。
原文は同じフォルダのLICENSE、NOTICE.md、CITATION.cff、fonts/OFL.txtにも同梱しています。

交差する関係線の飛び越し表示（v0.1.34）
接続していない線の交差を自動で飛び越し線にします。
レイアウトの「詳細設定」→「飛び越し線を表示」で切り替えられます。
標準はオンです。設定をJSONに保存し、SVG・PNGにも同じ表示を反映します。
同一直線上を長く重なる線の経路変更は対象外です。

添付ファイル（v2.0.0）
人物を選択し、詳細の「添付ファイル」で複数ファイルを追加できます。
表示名・日付・メモを編集でき、プレビューまたは原本ダウンロードで確認できます。
添付の追加・削除・情報編集は「元に戻す」に対応します。
人物の複製では添付をコピーしません。人物番号の変更・並べ替えでは元の人物に付いたままです。
「再編集用データを含める」がオンのSVG・PNGからも添付を復元できます。
添付を外部送信しません。Base64は暗号化ではありません。
従来版向けには「v1用JSONを書き出す（添付なし）」を使用します。

同じ世代の並び替えと再採番（v2.1.0）
人物を選び「並び順を変更」で同世代の人物と左右を指定します。
「配偶者の隣へ」からも移動先を指定できます。複数の配偶者は候補から選びます。
変更後の配置と旧番号→新番号を確認し「適用」を押すと、対象世代全員を再採番します。
家族関係・添付は元の人物に保持し、対象世代の手動配置だけを解除します。
キャンセルでは変更せず、1回の元に戻す／やり直すで番号・関係・配置を復元します。

配偶者の追加（v2.2.0）
人物を選び「配偶者を追加」で左右・性別・ラベルを指定し、プレビューを確認して追加します。
片親の家族がある場合は「子とのつながり」で追加先を選択できます。
「新しい夫婦関係を作る」では既存の子を移しません。複数候補があるときは追加先を選んでください。
同世代全員を左から再採番し、家族関係と添付を元の人物に保持します。その世代の手動配置だけを解除します。
1回の元に戻す／やり直すで復元でき、JSON・再編集用SVG・PNGにも反映します。
