基于 VitePress 的 MipMap Link 文档站点,支持多语言和本地搜索。
本文档开发需要先配置Node环境,访问NodeJS官网下载LTS版本进行安装。
打开Windows终端,执行以下命令安装yarn。
npm install -g yarn在本项目根目录下安装项目所需依赖:
yarn需要更新文档时,执行以下命令启动开发服务:
yarn dev开发服务启动后,可以在浏览器打开4002端口来预览文档,在编辑器中修改文档内容后,浏览器可以看到文档视图实时更新。
完成编辑后,执行以下命令生成部署安装包:
yarn build构建完成后,将 build/ 目录部署到你的托管服务。
导出pdf之前,需要先在主机安装 Pandoc,下载最新的安装包按提示安装即可。
默认使用 xelatex 作为 PDF 引擎,Windows 建议安装 MiKTeX 或 TeX Live,可以从MikTex官网下载安装。
安装完以上环境后可使用以下命令将文档导出为pdf导出,其中--lang参数可指定需要导出的语言版本。
yarn export:pdf -- --lang=fr常用命令:
# 导出英文版文档
yarn export:pdf:en
# 导出中文版文档
yarn export:pdf:zh可选参数:
npm run export:pdf -- --lang=zh-Hans --engine=xelatex导出文件位于 build/pdf/,文件名形如 mipmap-desktop-docs-cn.pdf。