Posts

前几天给同事分享文档的时候一直在用 语雀啥的。突然想到，如果要维护一个像 vue 或者vite 那一类的文档给用户看该怎么快速搭建的。理应有前辈完成这种工作。让 grok 搜了一下。顺便解惑原来对于 wiki doc 等的认识，有兴趣的小伙伴们自己搜搜，我这里就不贴 grok 的长篇大论了 总之找到了 vite press。确实是曾经认识过它（好像是在鱼皮那里） 那么这篇博客就记录一下搭建过程（跟官方文档一致）Getting Started | VitePress 首先准备 node 环境。因为最近在开发 mcp 应用。所以心血来潮用了 bun 1 2 3 bun add -D vitepress bun vitepress init 随后会有一次互动式的初始化 显示已折叠代码（30 行） 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 ┌ Welcome to VitePress! │ ◇ Where should VitePress initialize the config? │ ./docs │ ◇ Where should VitePress look for your markdown files? │ ./docs │ ◇ Site title: │ My Awesome Project │ ◇ Site description: │ A VitePress Site │ ◇ Theme: │ Default Theme │ ◇ Use TypeScript for config and theme files? │ Yes │ ◇ Add VitePress npm scripts to package.json? │ Yes │ ◇ Add a prefix for VitePress npm scripts? │ Yes │ ◇ Prefix for VitePress npm scripts: │ docs │ └ Done! Now run pnpm run docs:dev and start writing. 这里对于初始化的目录结构会对后面有一定的影响。由于我是使用的./作为默认目录，也可以在已有的项目中构建 docs 目录跟项目结合在一起 ...

参考 把 Obsidian 变为 Hugo 博客的集成管理平台 | 胡说 参考这位佬的文章，一共三篇。主要以下几个点 实现 关于我的博客是使用 github 管理，但是部署是在 cloudflare 上。这里原先的流程是这样的 编辑器打开仓库 （可选）git pull hugo new post/xxx.md 编辑 md，往往是我在别的编辑器（Obsidian） copy 进来的 编辑完后 git commit 然后 git push 这样的流程最大的问题出现在 写博客的位置和发布时的割裂 这也是我抓紧时间切换 md 编辑器到 Obsidian 的原因。插件万岁 使用插件有以下 Auto Link Title 粘贴链接自动获取标题 Charts 生图 Dataview 查看数据 Emoji Toolbar 挑选 emoji Git 进行 git 管理 Homepage 制作看板页 Image auto upload 结合 picgo 实现粘贴图片自动上传 QuickAdd 制作按钮 具体参考文章开头引用的 大佬的博客 有几个坑 倒是有热心网友在评论区提到了。看一下即可。

惯例先放网址，我这里参考了 好多，但是终究没有能抄的作业 hugo-theme-stack/config.yaml at master · CaiJimmy/hugo-theme-stack · GitHub 独立部署 | Waline waline/assets/waline.sqlite at main · walinejs/waline · GitHub 知乎 # 博客建站10 - 选择博客评论系统 系统架构 网站示例： Ray Blog 服务器: Cloudflare pages + 一台 aws 白嫖的服务器独立部署 waline 服务器系统： Ubuntu 24.04 LTS 博客框架： The world’s fastest framework for building websites 网站主题： Stack | Card-style Hugo theme designed for bloggers 安装 waline 这里根据官方文档独立部署目录下的指引 以及评论区的提示，我就不走多余的路。直接拉取官方镜像 直接写 docker-compose.yml 显示已折叠代码（17 行） 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 services: waline: container_name: waline image: lizheming/waline:latest restart: always ports: - 8360:8360 volumes: - ${PWD}/data:/app/data environment: TZ: 'Asia/Shanghai' SQLITE_PATH: '/app/data' JWT_TOKEN: 'Your token' SITE_NAME: 'Your site name' SITE_URL: 'https://example.com' SECURE_DOMAINS: 'example.com' AUTHOR_EMAIL: '[email protected]' 这里配置的环境变量似乎都没怎么用上。说实话我没看明白这个配置。直接运行后。在上一篇文章提到的 nginx 中进行反代。 ...

Nginx and Let’s Encrypt with Docker 这篇主要都是来自 medium 的这篇文章 Nginx and Let’s Encrypt with Docker in Less Than 5 Minutes | by Philipp | Medium 非常简单，我也就不多赘述，如果有不明白的问问 g 老师或者 c 老师即可 配完后确保域名解析到服务器即可（一直忘记改 cf，懵了好一会儿） 主要是为了下一篇文章 配置评论系统

显示已折叠代码（28 行） 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 server { listen 1043 ssl default_server; server_name 172.16.99.32; ssl_certificate /etc/nginx/ssl/1043/server.crt; ssl_certificate_key /etc/nginx/ssl/1043/server.key; access_log /var/log/nginx/1043_access.log; error_log /var/log/nginx/1043_error.log warn; location / { add_header Access-Control-Allow-Origin "*"; add_header Access-Control-Allow-Methods "GET, POST, OPTIONS"; add_header Access-Control-Allow-Headers "Authorization, Content-Type"; add_header Access-Control-Allow-Credentials true; proxy_pass http://X.X.X.X:1030; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # 处理 OPTIONS 预检请求 if ($request_method = OPTIONS) { return 204; } } } 这个 nginx 配置做了什么事情 ...