安裝 / Formulix 0.1.0

Tiptap 3

使用 ProseMirror 原子節點與原生歷程的擴充功能。

安裝

執行 npm run build:integrations，在建立編輯器前載入 dist/integrations/tiptap/formulix-ui.min.js，以 ESM 匯入 dist/integrations/tiptap/index.js，加入既有 extensions。附原始碼及授權的交付使用 npm run package:integrations。使用應用程式內同一份 Tiptap。已執行版本為 3.32.0。

設定

import Formulix from './formulix/index.js';
Formulix.configure({
  servidor: 'https://api.formulix.example',
  chave: 'YOUR_PUBLIC_KEY',
  idioma: 'zh-Hant',
  upload: uploadPng
});
editor.commands.openFormulix('formula'); // conta, grafico, quimica

在應用程式實作 uploadPng(blob)：上傳 PNG，回傳解析為 URL 的 Promise。圖形與繪圖必須提供 upload 回呼；媒體伺服器須驗證使用者、PNG、大小及權限。

API / 公開金鑰

設定營運方提供的 HTTPS API 網址及帳戶公開金鑰，在控制台登記編輯器網域；子網域亦受涵蓋。https://api.formulix.example 與 YOUR_PUBLIC_KEY 都是佔位範例，並非實際服務網址或金鑰。

預覽及插入內容會傳送至 API。瀏覽器只能放綁定網域的公開金鑰，切勿放入管理端、SMTP 或 Mercado Pago 憑證。

API · 隱私說明 — 翻譯草稿

儲存與限制

openFormulix 支援 formula / conta / grafico / quimica；按兩下再次編輯。formulixInline 與 formulixBloco 是保存已清理 HTML 的原子節點。儲存 editor.getJSON() 或 editor.getHTML()，伺服器清理時保留 MathML、表格及 data-*。對話框開啟期間選取範圍隨交易映射；若 API 回應前目標已刪除，則拒絕更新；唯讀模式禁止變更。遠端協作/Yjs 尚未驗證。3.32.0 已驗證四類內容、JSON/HTML、歷程、選取映射、清理及唯讀。

Word 的 OMML/RTF 剪貼簿處理仍是 TinyMCE 專用。Alpha 轉接器的同等貼上能力、多語言同時使用、Firefox/WebKit 與行動裝置均待驗證。