Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming. Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
40 lines
3.8 KiB
Markdown
40 lines
3.8 KiB
Markdown
# 7. ビューア・エディタ・連携アダプタ
|
|
|
|
状態:主要形式のビューアとホスト型エディタあり。ネイティブ起動・任意外部コード実行は保留。
|
|
|
|
## 正本と表示
|
|
|
|
文章はHTMLを正本にし、Markdownは編集・import形式として変換します。Office、PDF、画像、音声、動画、Canvas等のバイナリ・固有形式をすべてHTMLへ不可逆変換する意味ではありません。MIME、拡張子、限定された内容判定でProjectionを選びます。
|
|
|
|
拡張子のないテキストも文字コードと先頭内容を限定的に調べます。長いTXT/JSONは部分取得し、行番号・syntax highlight・ミニマップ等はブラウザのDOMやメモリ上限の中で動かします。
|
|
|
|
## 対応領域
|
|
|
|
CSV、コード、PDF、画像lightbox、音声・動画、ZIP等のarchive、コミック、EML、DEB/PEのメタデータ、Excalidraw等に初期実装があります。Office全般の完全再現や任意archiveの無制限展開を保証するものではありません。
|
|
|
|
PDFページ数・archiveメタデータ・サムネイルは原則キューで生成し、未生成ならアイコン・待機状態を返します。一部のentry展開はまだ限定された前景処理で、キャッシュ付き生成への移行が必要です。
|
|
|
|
## 連携アダプタ
|
|
|
|
アダプタはDocumentの表示・編集を担当します。MIME、対応操作、設定schema、外部origin、リソース上限を宣言します。ランキングやメール収集はアダプタではなくシステム拡張です。
|
|
|
|
code-server、vim.wasm等はホスト型連携として扱います。workspaceへの配下展開、HTML/Markdown変換、保存競合、短命なsessionをホスト側で制御し、通常のログインcredentialをそのまま渡しません。vim.wasmのruntime改善は現在保留です。ネイティブvim.exe等への直接受け渡しも保留し、補助アプリ不要で自由起動できるとは扱いません。
|
|
|
|
## HTMLの安全性
|
|
|
|
Viewer・履歴・印刷・Editor previewはinert allowlistを使い、保存されたscript/style/iframeを通常ページの権限で実行しません。正本バイト列を勝手に変更せず、表示段階の安全化として区別します。埋め込みは登録済みproviderとsandboxによる明示契約が必要です。
|
|
|
|
## ビューアのキーボード操作
|
|
|
|
通常のViewerでは、`e` 編集、`f` 検索、`v` 表示形式切替、`c` 配下への新規作成、`u` アップロード、`s` 共有リンク、`p` 権限導線を使えます。`Ctrl+↑` は親Path、`Ctrl+↓` は配下一覧、`Ctrl+→` / `Ctrl+←` は前後ページです。入力欄・select・textarea・contenteditable・開いているdialogではショートカットを停止します。
|
|
|
|
共有リンクは現在の正規URLをコピーし、X Web Intentをユーザー操作で開く方式です。これは公開権限を付与したり、未公開Pageを自動公開したりしません。権限ダイアログがその画面にない場合、City governanceの案内だけを表示します。
|
|
|
|
## Macroと変換の二つのモード
|
|
|
|
編集用のHTML→Markdownではchildren等のmacro宣言を保持します。表示・preview・export向けのProjectionでは認可済みの結果を展開します。展開された一覧を保存本文へ逆流させないことがround-tripの条件です。
|
|
|
|
## TODO
|
|
|
|
変換provider/version・警告・原本保持、未対応構文の欠落検知、draw.io・nwdiag等の統合、widgetの許可・同意・CSP、decoder隔離、プラグイン停止時の安全なfallback。HTML編集の段階的改善は第17章で具体化します。nwdiagはネットワーク構成を記述するソースと、静的SVG/画像としてのProjection、明示的な編集アダプタを分離して設計します。
|