DC娱乐网

Roq一个用Java和Quarkus打造的静态网站生成器突然火了

现在做一个个人博客或者企业官网,已经有很多成熟方案了。

喜欢简单一点,可以用 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背后的思路可能比它本身更值得关注。