vnote/zh_cn/docs/用户/常见问题.md
Leilei Chui 2dba7e8458
WIP: feature/add_code_sign_doc (#2512)
* WIP: feature/add_code_sign_doc

* Add documentation on "how to resolve the issue of macOS blocking the VNote application from opening".

* WIP: add more information and format markdown
2024-06-17 11:01:54 +08:00

2.9 KiB
Raw Blame History

常见问题

如何指定自定义MathJax脚本

VNote使用MathJax 3渲染数学公式。要指定使用的MathJax脚本请执行以下步骤

  1. 打开默认配置文件夹,复制其中的web/js/mathjax.js到用户配置文件夹,保留路径web/js/mathjax.js,然后就可以修改该mathjax.js文件了。这样VNote就会使用复制后的文件而不是默认的文件。
  2. 编辑mathjax.js文件。使用的MathJax脚本由这一行指定
            this.mathJaxScript = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-svg.js';
    

您可以下载MathJax并指定一个本地的MathJax脚本

this.mathJaxScript = 'file://c:/Users/foo/mathjax/tex-svg.js';

更新后启动失败

一般是由于跨多个版本号进行更新引起的。打开用户配置文件夹,并删除其中的vnotex.json即可。

界面无响应

编辑模式中光标不可见

打开一个笔记时程序崩溃

当出现在Windows上时以上三个问题都可能是因为显卡驱动的原因。可以逐步尝试以下3个步骤

  1. 尝试更新显卡驱动;
  2. 尝试将VNote指定使用集成显卡
  3. 尝试在设置对话框里面指定OpenGL的值,逐个值进行尝试。

每一步操作都需要重启VNote来验证是否有用。

macOS 下无法打开 App

打开 App 时弹出对话框,提示

Apple 无法验证“VNote.app”是否包含可能危害 Mac 安全或泄漏隐私的恶意软件。

macOS 中包含一项名为“门禁”的技术,旨在确保只有受信任的软件才能在 Mac 上运行。你可以尝试以下方案来解决问题。

  1. 首次打开 Vnote App弹出对话框后点击“完成”按钮关闭对话框。打开“系统设置”点按“隐私与安全性”向下滚动然后点按“仍要打开”按钮即可启动 Vnote且不再受阻止。

  2. 执行以下命令,对 Vnote 进行签名。

    # 移除指定应用的所有扩展属性,包括导致应用被隔离的属性
    # xattr 是 macOS 系统中用于管理文件扩展属性的命令
    # -c 选项表示清除所有的扩展属性
    # -r 选项表示递归处理,即包括指定目录下的所有文件和子目录
    xattr -cr '/Applications/VNote.app'
    
    # 重新签名指定的应用
    # codesign 是 macOS 系统中用于给应用程序签名的命令
    # --force 选项表示强制重新签名,即使之前已经签过名
    # --deep 选项表示递归签名应用内的所有可执行文件和框架
    # --sign - 选项表示使用一个匿名的证书进行签名
    # 这通常用于去除应用程序的现有签名,或者在没有有效开发者证书的情况下重新签名应用
    codesign --force --deep --sign - '/Applications/VNote.app'