Yank Note 安装和配置指南
1. 项目基础介绍和主要编程语言
项目介绍
Yank Note 是一个高度可扩展的 Markdown 编辑器,专为提高生产力而设计。它支持版本控制、AI 助手、思维导图、文档加密、代码片段运行、集成终端、图表嵌入、HTML 小部件、Reveal.js 插件和宏替换等功能。
主要编程语言
Yank Note 主要使用以下编程语言和框架:
- TypeScript: 用于核心逻辑和插件开发。
- Vue.js: 用于前端界面开发。
- JavaScript: 用于部分功能实现。
- HTML/CSS: 用于页面布局和样式设计。
2. 项目使用的关键技术和框架
关键技术和框架
- Electron: 用于构建跨平台的桌面应用程序。
- Monaco Editor: 提供类似 VSCode 的编辑体验。
- Reveal.js: 用于创建演示文稿。
- PlantUML/Drawio/ECharts/Mermaid: 用于嵌入图表和图形。
- OpenAI: 用于 AI 自动补全功能。
3. 项目安装和配置的准备工作和详细安装步骤
准备工作
- Node.js: 确保已安装 Node.js(建议版本 14.x 或更高)。
- Git: 用于克隆项目代码。
- Yarn: 用于管理项目依赖(可选,可以使用 npm 替代)。
详细安装步骤
步骤 1: 克隆项目代码
首先,打开终端并运行以下命令克隆项目代码:
git clone https://github.com/purocean/yn.git
步骤 2: 进入项目目录
进入克隆下来的项目目录:
cd yn
步骤 3: 安装依赖
使用 Yarn 或 npm 安装项目依赖:
yarn install
或
npm install
步骤 4: 运行项目
安装完成后,运行以下命令启动项目:
yarn start
或
npm start
步骤 5: 构建项目(可选)
如果你想构建项目以生成可执行文件,可以运行以下命令:
yarn build
或
npm run build
配置指南
Yank Note 的配置文件位于项目根目录下的 config
文件夹中。你可以根据需要修改这些配置文件来定制编辑器的行为。
示例配置
{
"editor": {
"theme": "dark",
"fontSize": 14
},
"openai": {
"apiKey": "your-openai-api-key"
}
}
常见问题
- 依赖安装失败: 确保 Node.js 和 npm/yarn 版本符合要求,并尝试重新安装依赖。
- 运行失败: 检查终端输出以获取详细的错误信息,并根据错误提示进行修复。
通过以上步骤,你应该能够成功安装并运行 Yank Note 编辑器。如果有任何问题,请参考项目的 GitHub 页面或社区论坛获取帮助。