← 返回全部文章
Programming 5 MIN READ

Wayline World:把文章放进一个可以驾驶的世界

Wayline World 是一个 world-first 的 Hugo 主题,它把文章、履历和影像投影成山路上的探索节点。

起初,3D 只是博客里的一个附加模式。

点击导航栏里的按钮,页面会覆盖成一个可驾驶的小岛。读者可以开车靠近文章节点,打开正文,完成阅读后再关闭弹层。

这个实验很快暴露出一个更根本的问题:如果 3D 只是普通博客上的彩蛋,它永远会被当成“多出来的入口”。用户真正想看的仍然是文章列表,而我们要花很多精力解释为什么另一条路径值得进入。

所以最后我们把 3D 从 Wayline 中完整拆出,做成一个独立主题:

Wayline World。

它不是“带 3D 效果的博客主题”,而是一个世界本身就是首页的主题。

首页不再是一个按钮

Wayline World 的首页没有普通站点导航、文章卡片或“进入 3D”按钮。

打开站点,看到的就是世界。

没有退出按钮,Esc 不能关闭,点击背景也不能关闭。这里的首页不是覆盖层,而是产品本身。

这改变了整个交互设计。

在普通博客里,3D 是“可选模式”;在 Wayline World 里,普通页面反而成为辅助页面。归档、关于和影像从空间地标开始,文章通过道路节点被发现。

内容没有被搬进 Three.js

3D 世界不直接解析 Markdown。

Hugo 仍然负责内容:

Hugo content
    |
    v
layouts/world.json
    |
    v
app.js controller
    |
    v
world.js

layouts/world.json 把文章、履历和照片投影成三组结构化数据:

{
  "archive": [],
  "about": [],
  "gallery": []
}

每个节点包含日期、标题、副标题、描述、图片、HTML 正文和标签。

world.js 只负责把这些数据放进场景。它不需要知道内容来自哪个 Markdown 文件,也不需要理解 Hugo 的页面结构。

这层分离很重要。它意味着 3D 世界可以替换视觉表现,但内容和阅读页仍然属于普通网站。

一条真正连续的山路

最初的版本用一段段方块拼成道路,转弯时会出现明显断裂。

现在的道路由连续曲面和密集曲线采样生成。地形在道路附近被压低,形成自然的道路走廊;路面、路肩、边线和反光路桩共享同一条曲线。

车辆也不是悬浮在场景上的一个模型。

每一帧都会采样最近的道路位置和路面高度:

  • 车辆高度跟随当前道路截面;
  • 左右移动被限制在车道范围内;
  • 阴影和光环作为车辆子节点一起移动;
  • 接触阴影使用软边椭圆纹理,而不是硬边圆圈。

这些细节不会让人第一眼就注意到,但少了任何一项,整个场景都会立刻显得“假”。

文章是一条可以靠近的信号

文章节点不是简单的发光方块。

每个节点会显示当前文章的标题、日期和“点击阅读”提示。靠近节点后,HUD 会显示阅读进度和节点编号;点击标记会直接打开正文。

阅读层仍然覆盖在 3D 世界上,不会跳转到普通文章页。关闭阅读后,车辆还停在原来的道路位置。

正文阅读支持:

  • 阅读进度;
  • Q / Escape 退出;
  • 长代码块独立横向滚动;
  • 图片、表格和长文本不撑破面板;
  • 阅读完成后发放标签徽章。

徽章会去重并保存在浏览器本地。它不是积分系统,而是把文章标签变成可收藏的探索记录。

三种内容,对应三条空间时间线

Wayline World 目前把内容分成三种时间线:

  • 归档:从 Hugo 的 posts 生成;
  • 影像:从独立的 gallery 生成;
  • 关于:从结构化履历生成。

首页地标也是动态的。没有照片数据时,影像地标不会出现;没有履历数据时,关于地标也不会占据空间。

每个节点沿道路的弧长均匀分布。内容越多,道路上的节点越密;如果想拉大探索距离,只需要调整路线长度或节点数量。

白天、低多边形与可读性

场景采用白天山间公路,而不是常见的夜色霓虹。

原因很简单:这个主题的主题是“探索内容”,不是展示 GPU 特效。白天场景能让道路、节点和文字拥有更稳定的阅读环境,也更容易和博客本身保持距离。

环境使用 CC0 的 Poly Haven HDR;车辆和树木来自 Kenney 的低多边形资源;全部资源自托管,不依赖运行时 CDN。

界面则保持克制:

  • 低饱和的浅色 HUD;
  • 深色正文,不把文字压在复杂背景上;
  • 导航只保留归档、影像和关于三个入口;
  • 移动端把任务栏和节点卡压缩到屏幕边缘。

3D 负责空间感,界面负责把信息读清楚。

性能不是“加载一个 Three.js”

Wayline World 会根据设备条件调整像素比、树木数量和阴影质量。Three.js 和模型只在进入世界时加载。

但 world-first 的主题不可能完全把 3D 当成可选功能,所以性能策略不是“尽量不加载”,而是:

  • 只在需要时加载世界运行时;
  • 限制场景资源规模;
  • 移动端降低像素比与几何数量;
  • 使用低多边形模型和 1K HDR;
  • 避免在每帧创建新的几何体或材质。

这是一个视觉主题,但仍然需要对普通笔记本和手机负责。

为什么它必须和 Wayline 分开

Wayline 和 Wayline World 解决的是两种不同任务。

Wayline 适合:

  • 快速找到一篇文章;
  • 在通勤或移动端阅读;
  • 搜索、归档和打印简历;
  • 长时间维护个人技术博客。

Wayline World 适合:

  • 展示空间化的内容结构;
  • 让时间线具有距离和方向;
  • 把阅读变成一次可操作的探索;
  • 做实验性的个人站点或品牌体验。

把两者做在同一个主题里,维护成本会不断上升,访问者也会在“阅读”和“游戏”之间反复做选择。

现在它们是两个独立主题,通过相同的 Hugo 内容结构共享文章、照片和履历,但拥有不同的第一入口。

下一步

Wayline World 还会继续迭代,但方向已经比较明确:

  • 更多可复用的世界地标;
  • 不同内容类型对应不同的场景物件;
  • 更自然的地形与道路过渡;
  • 更适合移动端的阅读和驾驶平衡;
  • 可配置的世界地图,而不是单一山间公路。

它不一定适合所有人的博客。

但如果你也认为“时间线”不应该只是一列日期,而可以是一条真正需要走过去的路,那么 Wayline World 提供了一个可以继续往前开的位置。

©

本文采用 CC BY-NC 4.0 许可协议。

OPEN CHANNEL

讨论

留下你的问题、补充或不同意见。

GLOBAL SEARCH

搜索文章