Implement Knowledge City platform, organizer and DAV integration
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.
This commit is contained in:
1 parent
288e6e94ac
commit
c1175d389f
699 files changed
+110197
-4117
No files matched your search
@@ -0,0 +1,38 @@
|
||||
# 17. HTMLパーツとWYSIWYGの判断
|
||||
|
||||
状態:設計案。全面WYSIWYG採用は未決定。既存エディタを置換しない段階的改善を第一案とします。
|
||||
|
||||
## 解決したい問題
|
||||
|
||||
表、画像とcaption、引用、注意書き、コード、リンク、macro、埋め込みを毎回手書きする負荷を減らします。単にHTMLを隠すことより、既存文書を壊さず効率よく編集できることを重視します。
|
||||
|
||||
## 段階案
|
||||
|
||||
1. Source+Projection previewを保ち、HTMLパーツ挿入paletteを加える。
|
||||
2. 選択範囲の整形、リンク・表・画像の型付きdialogを追加する。
|
||||
3. 対応するblockだけを視覚編集し、未知blockはread-only islandまたはsource編集へ戻す。
|
||||
4. 完全WYSIWYGはfixture評価と操作上の効果が確認できた場合だけ採用判断する。
|
||||
|
||||
HTMLパーツは安定ID、版、schema、HTML template、preview、許可属性、必要providerを持ちます。挿入時に文書へ具体化するパーツと、動的macroを区別します。パーツ更新で過去Revisionを勝手に書き換えません。
|
||||
|
||||
## 保存契約
|
||||
|
||||
canonical HTMLと編集モデルと安全な表示HTMLは別です。preview展開済みchildren、閲覧者ごとのリンク、署名URL、session値を保存しません。unknownな属性を無言で削除するeditorは、その文書を視覚編集できると表示してはいけません。
|
||||
|
||||
保存は対象Page、編集開始Revision、言語、期待versionを照合し、競合時に選択・差分確認へ戻します。autosaveは下書きと本Revisionのどちらかを明示し、previewしただけで公開headを進めません。自動公開範囲では保存が公開へ直結することを表示します。
|
||||
|
||||
## round-trip fixture
|
||||
|
||||
- children等のmacro、asset provenanceと固定hash、embedded-object。
|
||||
- code/pre、入れ子list、table、caption、非ASCII Path、RTL、複数言語。
|
||||
- 未対応HTML、コメント、アクセシビリティ属性、長文・巨大table。
|
||||
- paste時のscript/event属性/外部参照、安全化後と正本の違い。
|
||||
- undo/redo、IME変換中、選択維持、キーボード、screen reader。
|
||||
|
||||
比較はbyte一致だけでなく、許可した正規化以外の意味・依存参照・未知blockを失わないことを検査します。変更なしで保存した場合に大量diffを作るeditorも不合格候補です。
|
||||
|
||||
## 採用判断の条件
|
||||
|
||||
HTMLパーツだけで主な不便が解決するならそこで止めます。完全WYSIWYGは、round-trip・IME・大規模文書・保守性・ライセンス・bundle負荷を比較したADRを作ってから選びます。特定ライブラリ採用や共同編集CRDTの導入は今回決めません。
|
||||
|
||||
EDITOR-1:fixtureとpalette schema。EDITOR-2:少数パーツの挿入。EDITOR-3:限定block prototype。EDITOR-4:比較評価とgo/no-go。共有編集は別の権限・競合・接続設計を必要とする後続事項です。
|
||||
Reference in new issue
Block a user