跳到主要內容

Portable Text 編輯器

以結構化富文字建立可驗證、可引用、可演進的內容,同時保留未來與 REZICS Markdown 一對一轉換的方向。

目前狀態已可使用

Portable Text 富文字編輯、格式工具、連結、劇透、圖片、單元提及與斜線指令入口已實作;CodeMirror 6/Markdown 雙向編輯仍在延伸。

核心定位

REZICS 不把富文字當成一段不透明顯示標記。編輯器直接操作 Portable Text 結構,使段落、標題、清單、標記、連結、圖片、單元提及與自訂區塊都能被驗證、轉換與安全渲染。

編輯器產生的內容會包在 Block Schema 的 Portable Text 文件中,保有 _type_key 與文件版本語義;儲存與讀取時都會重新驗證,不只相信編譯期型別。

現在已經能做什麼

  1. 編輯一般段落、標題、引言、項目符號與編號清單。
  2. 套用粗體、斜體、連結與劇透等樣式標記/註解。
  3. 插入與驗證圖片及其他受支援區塊。
  4. 以單元提及把作品、人物與其他身份放進正文,不只儲存顯示文字。
  5. 透過斜線指令/提及入口搜尋並插入結構化內容。
  6. 依不同產品限制可用能力,讓評論、回覆或維基只使用合法內容形態。
  7. 正規化外部輸入,對不支援的標記與錯誤網址採取明確降級。

Portable Text 帶來什麼

Portable Text 把呈現與語義分開:連結的連結目標、劇透標記、單元提及 ID 與圖片資源都有可驗證形狀;渲染器能依內容動態預覽、文章詳情或其他表面選擇適合的呈現,而不改寫原始內容。

同一份內容也能計算語言感知的字數、閱讀時間與內容指標,並透過區塊身份支援未來的段落評論和更細歷史。

CodeMirror 6 與 REZICS Markdown

長期方向會以 CodeMirror 6 提供一般文字/程式碼編輯能力,並維持自訂 Portable Text 結構規範與 REZICS Markdown 語法的一對一語義關係。目標不是做一次性匯出,而是讓富文字與 Markdown 能可靠往返,形成可在富文字和純文字間自由切換的編輯體驗。

這部分仍在延伸;目前已可使用的是 Portable Text 富文字編輯器,而不是尚未完成的完整 Markdown 雙向工作流。

關係與邊界

編輯器不等於內容模型,也不把每次鍵盤操作寫成正式歷史。貼文等產品決定欄位與權限,Block Schema 驗證文件,發布邊界才交由歷史建立可追溯修訂。