使用文档
没有框架就没有「黑盒」：改文字、换颜色、加页面，每一步都直白可见。
快速开始
三步完成第一次修改
1
用任意编辑器打开
VS Code、记事本都行。建议从 index.html 看起，结构一目了然。
2
改内容并保存
标题、按钮文字、卡片简介都是普通文本，保存后刷新浏览器即生效。
3
检查其他页面
头部导航与页脚在每个页面里各有一份副本，改名 / 增删栏目时记得同步。
文件结构
整站就这些文件
| 文件 | 作用 |
|---|---|
index.html | 首页：hero 区、六张栏目大卡片、三步上手 |
style.css | 全站唯一样式表，顶部 :root 为设计变量 |
features.html | 功能介绍页（卡片网格 + 对比表） |
docs.html | 本页：使用与自定义文档 |
blog.html | 博客列表页（标签 + 日期卡片） |
faq.html | 常见问题页（原生 details 手风琴） |
download.html | 获取与部署：打包、GitHub Pages、nginx |
about.html | 关于本站：设计说明与扩展建议 |
posts/*.md | 博客文章源文件（Markdown 写作，文件头带 frontmatter） |
posts/img/ | 文章本地图片子文件夹 |
build.py | 构建脚本：md → 文章页，并自动刷新博客卡片列表（零依赖，仅需 Python 3） |
tutorials/ | 分功能简易教程（每个功能一篇 md） |
自定义指南
最常用的三个改动
🎨
换主色
改 style.css 顶部三个变量，全站按钮、链接、高亮同步变色。
:root {
--primary: #16a34a;
--primary-dark: #15803d;
--primary-soft: #f0fdf4;
}
🏷️
改站点名称
每个页面的 <title>、头部 logo 文字、页脚 logo 三处，全局替换即可。
<a class="logo" href="index.html"> <span class="logo-mark">A</span> 你的站名 </a>
➕
增删栏目按钮
在每个页面的 site-nav 里复制 / 删除一行按钮，改 href 与文字。
<nav class="site-nav">
<a class="nav-btn active"
href="index.html">首页</a>
<!-- 复制一行即可新增栏目 -->
</nav>