周周工 / 技术笔记搜索 ↗
← 返回文章列表
软件实践 / 2026-10-22

从 Markdown 到网页:这本技术笔记如何更新

把文章与图片保存在自己的项目里,构建、检查,再发布到服务器。

用文件保存文章

这个博客使用 Astro,文章保存在 src/content/blog/ 目录。每篇 Markdown 文件开头包含标题、日期、分类和标签。

---
title: 新的技术笔记
description: 用一句话描述这篇文章
date: 2026-10-24
category: 数控技术
tags: [FANUC]
draft: true
---

草稿不会出现在构建后的站点。准备正式发布时,将 draft 改为 false。这篇文章本身为建站示例,真实内容请新建文件。

图片和视频

图片可以放入 public/images/,文章中使用站内路径引用。发布前检查是否包含敏感信息,并填写有意义的图片说明。

视频将通过专用播放器组件接入。文章只保存视频标识,播放时通过后端获取临时权限。当前版本尚未接入真实视频平台,没有可用的视频播放功能,也不具备已验证的防盗链能力。

构建与发布

npm ci
npm run build

构建输出位于 dist/。ECS 上的 Nginx 提供这些静态文件,服务器无需为静态博客持续运行 Node.js。

更新之前检查什么

确认内容准确、图片可以访问、文章链接稳定,并在桌面和手机上预览。部署前保留旧版本,以便出现问题时回滚。

— 记录到这里,实践仍在继续。—