目前的静态博客如vitepress，主要是用markdown来写内容。
markdown虽然可读性比较好，但有以下几个疼点：
1、文章中贴图片有点麻烦，需要先保存图片到asset目录下，然后在markdown中写图片地址。
2、语法虽然简单，但有时还是记不住（年经大了，记忆力下降）
3、不能方便的插入图表，流程图之类的。
4、换行很讨厌，如果不强制换行，所有的东西全挤在一行里。
平时工作主要用飞书写文档，觉得很方便，所以就想能不能在飞书写文档，然后自动将飞书的文档导出成博客的文章。
- 将飞书文档导出成markdown文件（集成到了github action，自动）
- 生成导出的文章的静态博客系统(使用vitepress实现，集成到了github action，自动)
- 自动翻译中文文档为英文(目前不是自动，因为机器翻译的文章经常会把一些空格或者符号搞乱，导致编译不过，需要手动修改，所以暂时先手动)
- 集成了umami访问统计（修改了一部分源码）
- 集成了artalk评论系统 （功能可用，但后台管理页面丑陋，后面找到合适的系统，再换掉）
git clone https://github.com/ftyszyx/feishu-vitepress.git切到工程目录feishu_vitepress下
npm install修改feishu-pages-》.env.bak为.env
并配置好对应的飞书参数（在上一节中有说明）
FEISHU_APP_ID=
FEISHU_APP_SECRET
FEISHU_SPACE_ID=
OUTPUT_DIR=../blog #markdown输出目录
DOC_DIR_NAME=docs #输出目录名
RES_BASE_URL="/"npm run export会导出到/blog/docs目录下
修改blog-》.env.bak为.env
并修改
BASE_URL="/" #网站根目录，一般是/,运行
npm run dev成功后，显示
以上流程都已集成到github action,可以实现自动化，具体参考 github action自动化流程
同时也实现了自动同步到国内阿里云流程，具体参考博客自动同步到阿里云
导出飞书文档参考：链接
博客样式参考：链接
本人博客演示效果
- 文本内的格式化内容，转成markdown时要去掉空格
比如：
**ab ** 是无效的 **ab** 要转成这样才行
artalk后台不好用，今天通过网友介绍，发现giscus这个评论系统，它依赖于github的discussions功能，自己不用部署服务器，非常简洁
步骤： 先按照giscus配置好你的github项目 https://giscus.app/zh-CN
配置好后，拿到你的配置
<script src="https://giscus.app/client.js"
data-repo="ftyszyx/feishu-vitepress"
data-repo-id=""
data-category="[在此输入分类名]"
data-category-id="[在此输入分类 ID]"
data-mapping="pathname"
data-strict="0"
data-reactions-enabled="1"
data-emit-metadata="0"
data-input-position="bottom"
data-theme="light_tritanopia"
data-lang="zh-CN"
crossorigin="anonymous"
async>
</script>
修改blog\docs.vitepress\theme\site_config.ts下的giscus配置
giscus: {
repo: "ftyszyx/feishu-vitepress",
repoId: "",
category: "General",
categoryId: "",
data_mapping: "pathname",
},
完成
效果如下：
完美
这样就可以不用写yaml了，飞书文档如下：
博客效果：
飞书可以编辑封面
效果
文章页面：
首页排序：
好处是以后文章的地址不会变了 坏处就是，之前的文章地址全丢了