在 Mac 上继续维护 WZ ETF 博客

推荐方式：使用 Positron

1. 在 Mac 上安装 Positron。
2. 解压迁移包到 Documents 或其他普通文件夹。
3. 打开 Positron，选择 File → Open Folder。
4. 选择解压后的 wzetf-blog 文件夹。
5. 打开 index.qmd，点击编辑器右上角的 Preview。

Positron 自带 Quarto，因此用图形界面预览时通常不需要单独安装 Quarto CLI。

如果希望使用终端

安装 Quarto CLI 后，在博客目录中运行：

quarto check
quarto preview

生成正式静态网站：

quarto render

生成结果位于 _site。

常用文件

• index.qmd：主页内容
• research.qmd：研究文章列表页
• about.qmd：关于页面
• _quarto.yml：导航、域名和全站配置
• styles.css：字体、颜色、间距和手机布局
• posts/：所有博客文章

字体

样式会优先使用 macOS 自带的 PingFang SC 和 SF Pro，因此在 Mac、iPhone 和 iPad 上会自动获得苹果系统字体效果。字体文件没有被打包，也不需要另外安装。

重要提醒

• 修改 .qmd、_quarto.yml 和 styles.css 等源文件。
• 不要直接修改 _site 中的 HTML；重新渲染时它会被覆盖。
• 服务器仍只用于 Nginx 静态托管，不要在服务器安装 Quarto、Ghost、Node.js 或 MySQL。
• 本博客服务器是 47.102.143.59；不要操作另一个 ETF App 项目的服务器 43.161.227.156。
• 本迁移包不包含 SSH 密钥、密码或其他服务器凭据。