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 许可协议。
讨论
留下你的问题、补充或不同意见。