Skip to content

saccohuo/org2wiz

Repository files navigation

Org2Wiz

插件介绍

为知笔记的一款插件,将 org-mode 文件作为附件加入笔记中,笔记内容替换为 org-mode 文件导出的 html 格式。

20200830版本修改为仅支持wsl版emacs。

感谢原作者 @myflocky 和为知笔记开发人员。

插件功能

  • 将笔记附件中“.org”文件对应的 html 格式作为笔记内容。
  • 对于后缀为“.org”但没有“.org”附件的笔记,添加空的 .org 附件,可自行设置编码方式:UTF8(默认),UTF8-BOM,GBK,Unicode。
  • MathJax 渲染“.org”后缀笔记。
  • 自动找到附件中的 org 文件,不需要一定在附件的第一位。
  • 进行 Org2Wiz 转换时,自动添加默认标签到文档,支持多标签。可选。
  • 进行 Org2Wiz 转换时,把 org 文件中的 Tag 自动添加到笔记中(覆盖)。可选。
  • 一键把与 org 同名的 tex 文件或/与 pdf 文件作为附件到文档。可选。
  • 使用 Org2Wiz 创建笔记时,把笔记创建时间复制到剪贴板;使用 Org2Wiz 更新笔记时,把笔记更新时间复制到剪贴板。可选。

插件安装

下面两种方法都可以。

  1. Releases 中下载对应版本的 Org2Wiz.wizplugin ,安装。
  2. 打包下载 repo 的 zip 压缩包,然后将 .zip 后缀改为 .wizplugin ,双击安装即可。

插件使用

  1. 笔记工具栏添加“Org2Wiz”按钮。对于后缀为“.org”的笔记,点击该按钮,若笔记不包含“.org”附件,则弹出对话框提示用户输入需要添加的“.org”文件名;若笔记中包含“.org”附件,则插件会对排序最靠前的“.org”文件进行操作,将笔记内容更新为对应的html格式。若需要导出的“.org”文件在所有“.org”附件并非排序最靠前,请修改附件名将其排序调整至最靠前,例如在文件名前加下划线等。
  2. 使用默认设置可以正常运行插件,若有额外需要,可以点击“菜单”->“工具”->“Org2Wiz选项”来对插件进行设置。
  3. 在设置选项中,“Org2Wiz 默认标签”用于设置点击“Org2Wiz”按钮时,需要为笔记额外添加的标签,当“Org2Wiz 标签选项”设置为“添加默认标签”时,此项才会生效。
  4. 在设置选项中,“Org2Wiz 标签选项”用于设置点击“Org2Wiz”按钮时,是否为笔记添加默认标签,是否使用“.org”附件中的“#+TAGS”替换笔记的标签。
  5. 在设置选项中,“Org2Wiz 附件选项”用于设置是否显示“AddAttach”按钮,以及点击“AddAttach”按钮时的操作。当在“不添加AddAttach”与其他选项之间切换时,需重启为知笔记才可以生效。
  6. 在设置选项中,“Org2Wiz 文件编码”用于设置在对后缀为“.org”且不包含“.org”附件的笔记自动添加“.org”附件时,该附件的编码方式。
  7. 在设置选项中,“Org2Wiz 脚本选项”用于设置在更新笔记时,是否保留“.org”文件导出的html文件内置的脚本。
  8. 在设置选项中,“Org2Wiz Html文件”用于设置在更新笔记后,是否保留导出的html文件。
  9. 在设置选项中,“Org2Wiz 复制时间”用于设置在更新笔记时,是否笔记的创建时间或者更新时间复制到剪贴板。

常见问题

无法正常生成html,提示“Cannot find html file exported by emacs”

  1. 可能是 wsl 无法正常工作,在命令行执行“wsl”,确认是否有“参考的对象类型不支持尝试的操作”的报错,如果有的话,在命令行执行“ netsh winsock reset ”。
  2. 可能是 wsl 对应的发行版没有调整成默认的,用 wslconfig 修改下 wsl 默认的发行版:“ wslconfig /setdefault <DistributionName> ”。

参考