安裝 / Formulix 0.1.0
TinyMCE
穩定整合:在 TinyMCE 6、7 或 8 中部署單一用戶端。
建置與部署
在根目錄執行 npm run build,將 dist/formulix.min.js 放在 /formulix/0.1.0/ 等附版本號的 HTTPS 路徑。檔案包含介面、MathLive、MathML 轉換、語言、樣式與字型;TinyMCE 及 API 須另行設定。
設定
<script src="/tinymce/tinymce.min.js"></script>
<script>
tinymce.init({
selector: 'textarea',
external_plugins: { formulix: '/formulix/0.1.0/formulix.min.js' },
formulix_servidor: 'https://api.formulix.example',
formulix_chave: 'YOUR_PUBLIC_KEY',
formulix_idioma: 'zh-Hant',
toolbar: 'equacao contaarmada grafico quimica',
images_upload_url: '/upload',
automatic_uploads: true
});
</script>/upload 屬於你的應用程式,必須實作相容 TinyMCE 的上傳,驗證使用者身分、PNG 及大小。CSP 須允許 API 連線、行內樣式與 font-src data:。保留舊版以便還原。舊名稱 equacao 亦能註冊外掛。
API / 公開金鑰
設定營運方提供的 HTTPS API 網址及帳戶公開金鑰,在控制台登記編輯器網域;子網域亦受涵蓋。https://api.formulix.example 與 YOUR_PUBLIC_KEY 都是佔位範例,並非實際服務網址或金鑰。
預覽及插入內容會傳送至 API。瀏覽器只能放綁定網域的公開金鑰,切勿放入管理端、SMTP 或 Mercado Pago 憑證。
教師使用
從工具列開啟「公式」「直式計算」「函數圖形」或「化學」,調整預覽並確認插入。重新開啟項目,檢查儲存及重新載入。公式欄位可貼上 Word 內容;TinyMCE 亦保留專用 OMML/RTF 剪貼簿流程。
已知限制
- 舊版 Word 公式依賴瀏覽器提供 RTF,否則可能成為圖片。實際剪貼簿驗證仍未完成。
- 舊 Wiris MathML 轉 LaTeX 可能改變罕見結構。
- 乘法進位只在第二個因數為一位數時顯示;自動函數分析只支援一次與二次函數。
- 同時使用不同語言需要隔離。請另行檢查 TinyMCE 本身的授權。
閱讀已儲存 HTML不依賴外掛或有效訂閱。