安装 / 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-Hans',
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不依赖插件或有效订阅。