现在做一个个人博客或者企业官网,已经有很多成熟方案了。
喜欢简单一点,可以用 Hugo;前端开发者可能会选择 Astro;传统技术路线还有 Jekyll、Hexo 等。
在这样的环境下,Roq 为什么还要再做一个静态网站生成器?
更有意思的是,它没有选择 Go、Node.js 或 Ruby,而是站在了 Java 和 Quarkus 这套技术体系上。
如果只把 Roq 理解成“另一个 Markdown 博客工具”,其实低估了它。
它真正有意思的地方,在于它试图把静态网站、Java Web 技术、现代开发体验以及 AI 时代的网站内容能力放到了一起。
一、Roq到底是什么?
Roq 是一个开源的 Static Site Generator,也就是静态网站生成器。
它的基本工作方式并不复杂:
Markdown / HTML / 数据
↓
Roq
↓
模板处理
↓
静态 HTML
↓
Nginx / CDN / GitHub Pages
网站真正上线以后,服务器并不需要运行 Roq。
用户访问一个页面时,服务器直接把已经生成好的 HTML 返回出去。
这和 WordPress 这样的动态网站有明显区别。
WordPress 通常是:
浏览器
↓
PHP
↓
WordPress
↓
MySQL
↓
生成页面
↓
返回浏览器
而 Roq 是:
Markdown
↓
Roq 构建
↓
HTML
↓
Nginx / CDN
↓
浏览器
因此,Roq 生成的网站非常适合部署到 CDN、静态服务器、GitHub Pages 等环境。
对于博客、文档站、项目官网、企业介绍网站以及大量以内容为主的 SEO 网站来说,这种架构非常简单。
二、Roq最特别的地方,不是“静态网站”
静态网站生成器并不是什么新东西。
Hugo 已经非常成熟,Astro 也拥有庞大的前端生态。
所以 Roq 真正值得关注的问题不是:
“它能不能把 Markdown 转成 HTML?”
当然能。
真正的问题是:
为什么它选择 Java 和 Quarkus?
Roq 的底层技术路线大致可以理解成:
Java
↓
Quarkus
↓
Roq
↓
Qute
↓
HTML
这就和传统的 Hugo、Astro产生了明显区别。
如果你是 PHP 程序员,可以这样理解:
PHP → Java
Laravel → Quarkus
Blade → Qute
当然,这并不是说 Quarkus 和 Laravel 完全一样,而是从开发者的理解角度来看,这样的对应关系比较容易建立。
三、Quarkus到底是什么?
Quarkus 是一个现代 Java 框架。
如果以前接触过 Java,大概率会想到 Spring Boot。
实际上可以简单理解成:
Java生态
Spring Boot
Quarkus
Micronaut
都是现代 Java 应用开发的重要框架。
Quarkus特别强调云原生、容器、快速启动以及低资源占用,同时拥有非常完善的 Java 生态支持。
它可以用来开发:
- REST API
- Web 应用
- 微服务
- 数据库应用
- 消息系统
- 云原生应用
- Kubernetes 应用
而 Roq 则把 Quarkus 的这些能力用于静态网站生成。
这就形成了一个比较有意思的组合:
Quarkus
负责应用运行和扩展能力
Roq
负责静态网站生成
Qute
负责模板渲染
所以 Roq 并不是一个孤立的小工具,它背后实际上站着整个 Quarkus Java 生态。
四、Qute又是什么?
Qute 可以理解成 Quarkus 生态中的模板引擎。
如果你做过 PHP,就很好理解了。
Laravel 有 Blade:
<h1>{{ $title }}</h1>
Qute则可以写成:
<h1>{title}</h1>
如果需要循环文章:
{#for post in posts}
<h2>{post.title}</h2>
{/for}
条件判断也很简单:
{#if post.published}
<span>已发布</span>
{/if}
最终这些模板会和网站的数据结合,生成真正的 HTML。
因此,一个 Roq 网站可以理解成:
Markdown文章
↓
文章数据
↓
Qute模板
↓
HTML
如果你以前使用 Laravel Blade,那么理解 Qute 的难度并不高。
五、Roq并不只是“Markdown转HTML”
如果只是 Markdown 转 HTML,Roq其实没有太大的竞争力。
它真正有价值的地方,是提供了一套比较完整的内容模型。
例如一个网站可以拥有:
文章
产品
作者
案例
文档
分类
标签
这些内容可以通过 Collection 进行组织。
比如:
content/
├── posts/
│ ├── ai-agent.md
│ ├── npu.md
│ └── docker.md
│
├── products/
│ ├── macbook.md
│ └── airpods.md
│
└── cases/
├── case-a.md
└── case-b.md
这样一来,Roq就不再只是一个“博客生成器”。
它可以进一步变成一个内容驱动的网站生成框架。
例如:
/products/
/products/macbook/
/products/airpods/
/cases/
/cases/case-a/
/cases/case-b/
这些页面都可以由模板和数据自动生成。
对于程序员来说,这一点其实非常重要。
因为真正复杂的网站,往往不是只有“文章”。
六、这让Roq很适合做程序化SEO
如果你关注 SEO,就会发现这种架构非常适合 Programmatic SEO,也就是程序化生成大量结构化页面。
比如做一个餐饮家具网站。
可以建立:
products/
restaurants/
cities/
cases/
然后通过数据生成:
/restaurant-furniture/
/restaurant-furniture/chairs/
/restaurant-furniture/tables/
/restaurants/new-york/
/restaurants/london/
/restaurants/paris/
每个页面都有统一模板,但是内容来自不同的数据。
传统动态网站当然也能做到。
但静态生成有一个优势:
页面在构建阶段就已经生成好了。
访问的时候直接返回 HTML。
因此不需要每次访问都查询数据库。
对于大量内容型页面,这种模式非常适合。
七、Roq对SEO也考虑得比较完整
一个内容网站真正上线以后,并不是“能显示文章”就结束了。
还需要:
Title
Description
Canonical
Open Graph
RSS
Sitemap
Pagination
Tags
这些内容。
Roq本身提供了相应的能力,并且可以通过模板进一步控制。
这样生成出来的页面,可以直接部署到:
Nginx
CDN
Cloudflare
GitHub Pages
Netlify
等环境。
而服务器端甚至不需要运行 PHP、MySQL。
如果是一个纯内容网站,架构可以非常简单:
Git
↓
Roq
↓
HTML
↓
CDN
这也是静态网站最大的魅力之一。
八、Roq有一个很值得关注的方向:AI
如果说前面的内容还比较传统,那么 Roq 对 AI 的支持就比较有意思了。
它已经开始支持:
/llms.txt
/llms-full.txt
如果你之前关注过 GEO 或 AI 搜索,这两个文件应该不会陌生。
传统网站主要考虑的是:
Google
Bing
百度
搜索引擎如何抓取网页。
但现在越来越多的网站还需要考虑:
ChatGPT
Claude
Gemini
AI Agent
AI Search
如何理解自己的网站。
这时候:
网站
↓
HTML
↓
搜索引擎
正在逐渐变成:
网站
├── HTML
├── Sitemap
├── RSS
└── LLMs.txt
↓
AI系统
Roq直接把 LLMs.txt 纳入网站生成体系,这说明它的设计者已经开始考虑一个新的问题:
未来的网站不仅是给人看的,也可能是给 AI 读取和理解的。
这也是我认为 Roq 比普通静态博客生成器更值得观察的地方。
九、Roq还在尝试解决一个问题:开发体验
传统静态网站生成器通常需要:
build
然后重新生成网站。
现代开发工具则更强调:
修改
↓
保存
↓
立即看到结果
Roq同样提供了开发模式和 Live Reload。
例如:
roq start
启动开发环境。
然后修改:
content/posts/article.md
保存以后,页面可以自动刷新。
对于写博客的人来说,这种体验和使用现代前端开发工具已经非常接近。
十、它甚至提供了浏览器编辑能力
Roq比较有意思的另一个方向,是它正在加入内容编辑能力。
也就是说,你不一定非要打开 VS Code 或 Vim 修改 Markdown。
可以通过浏览器进行:
文章编辑
Markdown编辑
Front Matter编辑
图片上传
实时预览
这让 Roq开始出现一种比较特别的形态:
开发者工具
+
内容管理工具
+
静态网站生成器
它依然不是 WordPress 那种传统 CMS。
但又开始拥有一些 CMS 的能力。
十一、Roq和Hugo、Astro有什么区别?
这可能是很多人最关心的问题。
如果只是想做一个博客,我不会说 Roq 一定比 Hugo 或 Astro 好。
它们的定位并不完全相同。
Hugo最大的优势是:
成熟、速度快、生态稳定。
Astro最大的优势是:
现代前端生态以及非常强的组件化能力。
而 Roq 最大的特色是:
Java + Quarkus + Qute + 静态网站 + AI友好。
可以简单理解:
工具 | 最大特点 |
Hugo | Go、成熟、速度快 |
Astro | 前端生态、组件化 |
Jekyll | Ruby、经典博客 |
Hexo | Node.js、简单易用 |
Roq | Java、Quarkus、AI友好 |
所以如果你已经是前端开发者,Astro可能更加自然。
如果你只是想快速搭博客,Hugo依然非常值得选择。
但如果你本身是 Java/Quarkus 开发者,Roq就会变得很有吸引力。
十二、Roq最大的优势,也是它最大的风险
优势非常明显。
它站在 Quarkus 这个成熟的 Java 生态上,可以获得大量现成能力。
同时静态网站本身又非常简单。
但问题也同样明显:
Roq还比较年轻。
Hugo、Jekyll、Astro经过多年发展,已经拥有大量用户、主题、教程和第三方工具。
Roq的生态目前显然不能和它们相比。
所以如果你准备做一个特别重要的商业项目,不一定要因为它“新”就马上迁移。
但如果是:
个人博客
技术博客
项目官网
文档网站
SEO实验站
AI内容网站
那么Roq非常值得尝试。
十三、我认为Roq真正值得关注的,不是Java
如果只看到:
“一个Java写的静态网站生成器。”
其实很容易觉得它没什么特别。
真正值得注意的是它背后的方向:
Quarkus
+
Static Site
+
Structured Content
+
SEO
+
LLMs.txt
+
AI
它正在尝试解决一个新的问题:
当网站面对的不只是人类用户,还有越来越多的 AI Agent 和 AI 搜索系统时,网站应该如何组织自己的内容?
过去我们设计网站,首先考虑:
用户怎么点击?
搜索引擎怎么抓取?
未来可能还要考虑:
AI怎么理解?
AI怎么引用?
AI怎么发现?
AI怎么判断网站中的信息?
从这个角度来看,Roq的路线其实很有时代感。
十四、程序员有没有必要学Roq?
我的答案是:
没必要专门为了Roq去学Java。
如果你只是想做博客:
Hugo
Astro
已经有非常成熟的选择。
但如果你本身对:
Java
Quarkus
AI
SEO
GEO
静态网站
内容自动化
感兴趣,那么Roq非常值得研究。
尤其是程序员做内容网站时,它提供了一种非常舒服的模式:
Markdown
↓
Git
↓
Roq
↓
HTML
↓
CDN
再加上:
RSS
Sitemap
SEO
LLMs.txt
整个网站可以变得非常轻量。
写在最后
Roq现在还远远没有到可以取代 Hugo、Astro 的程度。
但我觉得它值得关注的原因,也恰恰不是“它要取代谁”。
它代表了一种新的尝试:
把传统静态网站生成器与现代 Java、云原生开发方式,以及 AI 时代的网站内容需求结合起来。
以前的网站是:
网站 → 用户
后来变成:
网站 → 用户 + 搜索引擎
而现在正在逐渐变成:
网站
↓
用户
搜索引擎
AI
AI Agent
如果未来 AI 真正成为互联网内容的重要入口,那么“让网站更容易被 AI 理解”可能会成为网站建设中的一个新问题。
而 Roq,至少已经开始朝这个方向走了。
对于普通用户来说,它可能只是一个新的静态网站生成器。
但对于程序员和做 SEO、GEO、AI 内容的人来说,Roq背后的思路可能比它本身更值得关注。