利用案内の参照資料
1. 導入と更新
利用者向けの正本は docs/ja/Getting_Started.md である。導入を案内するときは、次の順序を基本とする。
1. GitHub Releases の Assets から、通常版または Lite版の ZIP を一つ選ぶ。ソースコード ZIP はアプリ配布物ではない。
2. ZIP を書き込み可能なローカルフォルダへ展開する。ZIP 内を直接実行しない。
3. EXE、DLL、通常版の LibreOffice runtime、pdf_workspace_setup.json は同じ配布フォルダに置いたままにする。
4. 配布フォルダとは別のローカルフォルダをワークスペースとして開く。
5. 更新時は新しい ZIP を別フォルダへ展開して起動を確認し、ワークスペースを新しいアプリから開く。
通常版は DOCX/PPTX のローカル PDF 変換を含む。Lite版はその変換を含まない。変換は試験的なため、結果を確認してから使う。
EVIDENCE:
docs/ja/Getting_Started.mddocs/ja/README.mdREADME.md
2. 利用者が変更できる範囲
利用者がアプリ内の設定画面から調整できる項目には、一般設定、ノート設定、マークアップ設定、注釈設定、カラーパレット設定がある。ノート、PDFテキスト、IME変換中は入力を優先する。注釈ツールのショートカットは設定画面で確認でき、設定ファイルはワークスペース内の __resource__/__settings__/tool_shortcuts.json に置かれる。
ノートと注釈では、既定の選択肢にあるフォントを選べる。ノート内の font / f タグによる部分的なフォント指定も扱う。フォントの字幅により折り返し位置が変わることがある。
次はカスタマイズの対象として案内しない。
- 配布フォルダ内の EXE、DLL、runtime、
pdf_workspace_setup.jsonを個別に移動・混在・改名すること - stage、バックアップ、復旧用の
__resource__配下を、内容確認前に手動削除すること - PDFの既定アプリを、利用者の明示操作なしに変更すること
設定ファイルの手編集、未掲載の設定値、版ごとの画面差については、ファイル例だけから断定しない。該当版の設定画面と利用者向け文書を確認する。
EVIDENCE:
docs/ja/Getting_Started.mddocs/ja/Troubleshooting.md
3. 保存・復元の段階
保存は、編集内容を原本へ即時に書く処理ではない。説明では次を区別する。
| 段階 | 意味 | 利用者の操作・注意 |
|---|---|---|
| stage 保護 | 編集途中の内容を保護する | 自動保護は原本への統合を意味しない |
| 差分確認 | 未統合の変更を確認する | 「操作 > 差分管理...」または「保存 > 差分管理...」を使う |
| 統合保存 | Ctrl+S または保存メニューで、バックアップ作成後に原本へ安全に反映する | 区切りのよい時点で行う |
| 復元 | 保存済みバックアップへ戻す | 未統合 stage との関係を確認してから「保存 > 復元/バックアップ...」を使う |
| 失敗時の退避 | ノート保存に失敗した内容を退避する | stage、バックアップ、退避データを削除せず、表示内容と時刻を控える |
主な保護領域は次の通りである。
stage: __resource__/__tmp__/__stage__/
backup: __resource__/__escape__/backup/
note recovery: __resource__/__escape__/note_recovery/
保存後の undo/redo と、保存済みの以前の状態への復元は別である。前者は編集画面の undo/redo、後者は復元/バックアップを案内する。
EVIDENCE:
docs/ja/Save_and_Recovery.mddocs/ja/Using_the_App.mddocs/ja/Troubleshooting.md
4. 支援依頼と開発者への連絡
このリポジトリには、利用者向けのメールアドレスや、常時利用できる問い合わせフォームは文書化されていない。開発者が返信すること、新規 Issue を作成できること、特定の外部連絡手段が使えることを保証しない。
GitHubリポジトリの Issues や Discussions を案内する場合は、案内時点で投稿可否と利用規約を確認する。問題を整理する支援では、外部送信を実行せず、次を利用者に確認する。
- アプリの版、通常版かLite版か、Windows の版
- 対象ファイルの種類と、保存前・保存後・未統合 stage のどの状態か
- 再現手順、期待した結果、実際の結果、表示されたエラー文
- 原本、stage、バックアップを削除・改名・上書きしていないこと
セキュリティ上の問題は、通常の公開報告を促す前に .github/SECURITY.md を確認する。
EVIDENCE:
docs/ja/Troubleshooting.md.github/SECURITY.mdhttps://github.com/soone-y/OPEN_PDF-Note-Workspace