这里怎么写文章

2026-11-06 · 指南

这个博客用最朴素的方式工作:每一篇文章就是 posts/ 目录下的一个 HTML 文件,不需要数据库,也不需要构建。

新增一篇文章

  1. 复制 posts/_template.html,改名为一个好记的短名,例如 my-first-trip.html。
  2. 打开它,改标题、日期和正文。
  3. 回到根目录的 index.html,在 data-station="blog" 那个卡片的 <div class="links"> 里加一行链接:
<a href="posts/my-first-trip.html" target="_blank" rel="noopener">
  <span data-en="My First Trip">我的第一趟旅行</span>
</a>

刷新页面就能看到。文章页和首页共用配色,不用再单独调样式。

写正文

常用标签就够:<h2> 小节标题、<p> 段落、<ul>/<ol> 列表、<blockquote> 引用、<pre><code> 代码块、<strong> 加粗、<a> 链接。

发布

本地预览用 python3 tools/serve.py;上线时运行 bash tools/build.sh,把生成的 dist/ 部署到静态托管即可(posts/ 会自动包含进去)。


就这么多。写下去,比写得好更重要。