关于用户手册

[ZnPdCo]

lemonlime 的用户手册已经几年没有更新过了，在这几年间 lemonlime 加了一些功能。看起来需要更新一下。

线上版本

用户手册是通过 latex 写的，只有离线版本。我正在考虑是否应该开发一个在线版本，因为大部分人遇到问题之后喜欢在搜索引擎上搜，开发一个在线版本是不是会好一点。

具体架构是：

• 将 latex 换成 markdown，然后通过 material for mkdocs 部署一个线上 docs，这个用 github pages 部署就好了
• 通过 pandoc 将 markdown 转为 latex 然后在 ci 中自动构建离线 pdf 版本

这个可以考虑另开一个 repo 来存储，然后在这个仓库中以 submodules 的形式引入。直接在这个 repo 里加也是可以的，但那就很乱了。

手册内容

• 快速上手：感觉需要增加一个 demo 小节，方便第一次用 lemon 快速学习，而非在网上找各种教程。
• 以 Watcher 运行：详见 feat: Execute as watcher for UNIX #250 ，而且需要提供一个小 demo
• Q&A：应当增加更多内容，例如 macos 相关，杀毒软件相关，空间相关

[CoelacanthusHex]

我建议放在同一个仓库，方便同时更新代码和文档。
其实我更建议 pandoc 直接把 latex 转 html

[ZnPdCo]

其实主要是觉得 material for mkdocs 好看，有什么网页上展示 tex 的方案吗？

[CoelacanthusHex]

我主要是嫌 md 功能不足，干啥都得扩展语法。其实有一个方案是 Typst，语法功能强大，同时支持 PDF 和 HTML 输出

[ZnPdCo]

可以试试

[ZnPdCo]

@CoelacanthusHex 您有什么比较好的模板吗？我尝试转写了一下发现样式还是有很大的区别，搜索了一下发现也没什么好的模板。 🤔