03 / 关于
先做完整，
再做大。
我是橙照。这里记录我写过的代码、想清楚的问题，以及把一件小事做完整的过程。
我主要写 C++，也写 Python。喜欢那些边界清楚、能运行、别人拿到之后不需要再猜的小项目。比起“看起来很厉害”的架构，我更在意一个东西能不能被维护，能不能在半年后还打开。
这个网站最初只是想把散落的笔记放在一个地方。后来发现，整理本身也是一种练习：把问题拆开，把判断写清楚，把“我试过了”变成“你可以照着做”。所以这里的文章大多从一个具体的错误、一次构建失败，或者一个反复出现的疑问开始。
我还在学习。文章里会有不成熟的地方，项目也会继续改。如果某篇笔记帮你少踩一个坑，或者某个项目让你想动手做一个自己的版本，这个网站就有用了。
快速了解
- 正在做
- C++ 学习笔记、Quarto 写作工具、个人网站
- 常用的
- C++20、CMake、Python、Git、Quarto、Linux
- 写作方式
- 先跑通例子，再补解释；能复现的步骤优先
为什么是“做完整”
“完整”不是“完美”。一个完整的项目通常只需要几样东西：一条能复现的运行路径，一组能说明问题的测试，一份写到别人能上手的说明，以及一个不会在下次修改时立刻崩掉的结构。它们都不难，但需要有人愿意停下来做完。
我把这个标准用在自己的笔记上。每个 C++ 例子尽量能编译；每篇建站文章尽量说明版本和前置条件；每次发布尽量走同一条流水线。做不到的时候，就在文章里写清楚哪里还没做到。
这个网站怎么来的
网站用 Quarto 构建，主题是在 Bootstrap 之上写的一层 SCSS 和 CSS，没有前端框架，也没有后端。字体自托管，页面由 GitHub Actions 发布到 GitHub Pages。
它也是 dsh-quarto-website 这个插件的第一个使用者：主题、检查清单和发布流程先在这里跑通，再收回插件里。下次做类似的站点时，不需要从空白页开始。
一路走来
-
起点
开始系统整理 C++ 笔记
从环境配置和第一个编译错误开始，把每次卡住的地方记下来。
-
练习
把练习拆成能维护的工程
用 CMake、CTest 和清晰的目录结构重写小项目，开始在意“别人能不能跑起来”。
-
现在
重做个人网站
放弃现成模板，改为自定义主题和一条可重复的发布流程，同时把经验收进 DSH 插件。
几条工作原则
能运行的最小版本，比一张完美的架构图更有用。
笔记不是摘抄，是一次重新组织，让别人也能照着做。
构建、检查和部署应该重复、可预期，不靠记忆。
如果你也在做类似的事，欢迎写信。聊聊你手上的问题