1.6 KiB
1.6 KiB
LinkTool文档库
简介
本仓库为基于Vitepress的LinkTool文档库，内容涵盖LinkTool的开发过程、使用方法等。
协作指南
项目结构
所有文件名和文件夹均使用英文命名，单词之间使用-连接，不留空格。项目根目录下分设web、plugin、agent文件夹，分别对应Web端、插件端和智能体的部分，每个部分内区分“开发指南”何“使用方法”两个部分，即dev和usage文件夹，两部分的文档分别面向开发者和用户。
参与协作
可直接使用Visual Studio Code（推荐）或Intellij Idea、PyCharm等集成开发环境打开本项目，创建自己的分支后，直接开始编辑相应的文档。
如果需要添加新的文章，在/.vitepress/config.mts中的sidebar添加相应的item，原则上不允许添加新的侧边栏组，nav中也不允许添加其它的子项目，文档中涉及的图片全部放到assets文件夹中，严禁在Markdown文档所在文件夹放图片。
语法参考
由于本项目基于Vitepress搭建，所以也支持Vitepress中对于Markdown语法的扩展，可以排版出美观的项目文档，具体参考Vitepress官方文档
文档预览
对于普通Markdown语法部分（占据文档库的大部分内容）可以直接使用Visual Studio Code自带的Markdown预览器预览效果，对于Vitepress拓展部分，可以通过npm run docs:dev命令开启实时预览，开启后，每次文档内容有更新就会自动刷新；也可以通过npm run docs:build生成相应的html文件。