使用 Java 和 Maven (JBake) 生成静态网站

使用 JBake（“mvn generate-resources”）构建您的静态网站或博客。使用布局、宏和数据文件。

我们迁移了整个www.optaplanner.org网站（1399 个文件）以使用 Java 和 Maven，而不是 Ruby 和 Rake 进行构建。从表面上看，什么都没有改变。但在源代码中，对于我们的 Java 开发人员团队来说，它是一个游戏规则改变者。

我们的 Java 团队现在可以轻松地为网站做出贡献。在完成迁移后的几个小时内，我们的一位开发人员已经提交了一份不愿意用十英尺长的杆子接触以前的源代码的提交。

我们建立了这个网站。
我们在 Java 和 Maven 上构建了这个站点。
我们建立了这个网站。
我们在 JBake 和 Freemarker 上建立了这个网站。

为什么使用静态网站生成器？

静态网站生成器将模板和内容文件转换为静态 HTML/JS/CSS 网站。对于我们这样的项目，这比内容管理系统 (CMS) 有很多优势：

托管很便宜。GitHub 页面甚至免费托管静态网站。

源文件进入 Git 进行备份和历史记录。

源文件为纯文本格式：

更改以拉取请求的形式出现，以进行适当的审查和 CI 验证。

源代码在我们的 IDE 中是开放的，这鼓励将它们与代码一起重构。这会减少陈旧的内容。

多年来，Awestruct 一直为我们服务。但由于缺乏活动，是时候升级了。

为什么是 JBake？

因为我们是 Java 程序员。

有几个很好的静态网站生成器，比如 Jekyll (Ruby) 和 Hugo (Go)。我们选择JBake (Java)，因为：

我们的网站现在使用 Maven ( mvn generate-resources)构建。

无需安装任何东西。甚至不是 JBake。每个人都使用相同版本的 JBake 构建，如pom.xml.

而且速度很快：即使mvn clean在我的机器上构建 150 个输出页面也只需要 20 秒。

.下面全是Java。

编写条件表达式很简单。API ( String.substring(), ...) 很熟悉。日期格式 ( d MMMM yyyy) 和正则表达式的行为符合预期。

最重要的是，错误消息很清楚。

8 年来，我用 Awestruct (Ruby) 编写了这个网站。但我从来没有花时间好好学习 Ruby，所以每次改变都需要数小时的反复试验。我不能只是阅读错误消息并修复它。这不是鲁比的错。那是因为我从来没有花几天时间来真正学习 Ruby。使用 JBake，我可以在很短的时间内修复错误：不再需要反复试验。

什么是 JBake？

JBake 是一个静态网站生成器，有很多选项：

使用 Maven 或 Gradle 构建。

我们选择Maven，因为我们所有的 repos 都是用 Maven 构建的（尽管两个OptaPlanner Quickstarts也用 Gradle 构建，因为 OptaPlanner 也支持 Gradle）。

用 Asciidoc、Markdown 或 HTML 编写内容。

我们选择Asciidoc是因为它比 Markdown更丰富、更可靠。此外，我们所有的文档都是用 Asciidoc 编写的。

使用 Freemarker、Thymeleaf 或 Groovy 创建模板。

我们选择Freemarker是因为它是一个强大的、经过实战考验的模板引擎。

技巧和窍门

这些是构建高级静态网站的常见任务以及如何在 JBake-Freemarker 中实现每个任务。您甚至可以将这些JBake 设计模式称为：

使用宏渲染共享内容

我们几乎所有的模板都显示相同的最新版本面板：

使用数据文件添加视频、事件或其他易失性数据

某些数据更改过于频繁，无法在内容或模板文件中进行维护：

一个数据文件，例如一个简单的*.yml文件，可以很好地保存这样的易失性数据：

创建data/videos.yml：

- youtubeId: blK7gxqu2B0

title: "Unit testing constraints"

...

- youtubeId: gIaHtATz6n8

title: "Maintenance scheduling"

...

- youtubeId: LTkoaBk-P6U

title: "Vaccination appointment scheduling"

...

然后在ftl模板中使用它：

<#assign videos = data.get('videos.yml').data>

<div class="panel panel-default">

    <div class="panel-heading">Latest videos</div>

    <div class="panel-body">

        <ul>

            <#list videos[0..6] as video>

                <li>

                    <a href="https://youtu.be/${video.youtubeId}">${video.title}</a>

                </li>

            </#list>

        </ul>

    </div>

</div>

布局继承

所有 HTML 页面通常共享相同的 HTML 头（元数据）、页眉（导航）和页脚。这些非常适合base.ftl布局，由所有其他模板扩展：
使用 Java 和 Maven (JBake) 生成静态网站

尽管大多数内容使用normalBase.ftl，但useCaseBase.ftl所有用例页面都有单独的模板，例如车辆路线问题 (VRP)、维护计划和轮班排班。

使用带有的宏<\#nested>来构建布局继承：

创建templates/base.ftl：

<#macro layout>

    <html>

        <head>

          ...

        </head>

        <body>

            <div>

                ... <#-- header -->

            </div>

            <#nested>

            <div>

              ... <#-- footer -->

            </div>

        </body>

    </html>

</#macro>

扩展它templates/useCaseBase.ftl并引入自定义属性related_tag：

<#import "base.ftl" as parent>

<@layout>${content.body}</@layout>

<#macro layout>

    <@parent.layout>

        <h1>${content.title}</h1>

        <#nested>

        <h2>Related videos</h2>

        <#assign videos = data.get('videos.yml').data>

        <#assign relatedVideos = videos?filter(video -> video.tags.contains(content.related_tag))>

        <ul>

            <#list relatedVideos as video>

                <li><a href="https://youtu.be/${video.youtubeId}">${video.title}</a></li>

            </#list>

        </ul>

    </@parent.layout>

</#macro>

创建content/vehicleRoutingProblem.adoc使用该模板并设置该related_tag属性的用例页面：

= Vehicle Routing Problem

:jbake-type: useCaseBase

:jbake-related_tag: vehicle routing

The Vehicle Routing Problem (VRP) optimizes the routes of delivery trucks,

cargo lorries, public transportation (buses, taxi's and airplanes)

or technicians on the road, by improving the order of the visits.

This routing optimization heavily reduces driving time and fuel consumption compared to manual planning:

...

开始
自己试试吧。要构建www.optaplanner.org网站，请运行以下命令：

$ git clone https://github.com/kiegroup/o...

...

$ cd optaplanner-website

$ mvn clean generate-resources

...

$ firefox target/website/index.html

或者看看源代码。

使用 Java 和 Maven (JBake) 生成静态网站的更多相关文章

工具&colon;使用jekyll生成静态网站
在使用前端框架构建网页而不使用后端平台与数据库,即没有服务器的条件下读取文件夹其他文件,浏览器可能会阻止访问.对于这种静态构建可以使用简单的生成工具jekyll.它主要适用于将静态文件生成静态网站,在 ...
MWeb 生成静态网站&amp&semi;博客
MWeb 生成静态网站 & 博客 MWeb 的静态网站分类在 MWeb 的文档库中,有两种分类,一种是普通分类,另一种就是静态网站分类了.你可以直接新增一个静态网站分类,也可以在普通分类的顶 ...
[技术翻译]使用Nuxt生成静态网站
本周再来翻译一些技术文章,本次预计翻译三篇文章如下: 04.[译]使用Nuxt生成静态网站(Generate Static Websites with Nuxt) 05.[译]Web网页内容是如何影响 ...
学JAVA的第二天，静态网站制作，脑阔一点疼
先从下载apache-tomcat-9.0.17开始在下边这个网站下载,下边一步步来下面删除的这些是暂时用不上的,先吧它删除了,因为会拖慢启动速度下边把ROOT里边除WEB-INF外的全不删除了 ...
使用Sphinx生成静态网页
转载来自 http://www.ibm.com/developerworks/cn/opensource/os-sphinx-documentation/ 简介 Sphinx 是一种工具,它允许开发人 ...
Java项目生成静态页面
第一次做项目需要生成静态页面,网上很多大牛对将网页生成静态页面有很多异议.说一下我的看法. 不外乎有以下因素: 1.从页面加载时间来看:静态页面不需要与数据库建立连接,尤其是访问数据量较大的页面,这种 ...
Java生成sitemap网站地图
访问我的博客 sitemap 是什么?对应没有接触过网站 SEO 的同学可能不知道,这里引用一下百度站长的一段解释. Sitemap(即站点地图)就是您网站上各网页的列表.创建并提交Sitemap有助 ...
Jsonschema2pojo从JSON生成Java类(Maven)
1.说明 jsonschema2pojo工具可以从JSON Schema(或示例JSON文件)生成Java类型, 并且可以配置生成Jackson 1.x,Jackson 2.x, Moshi 1.x或 ...
rpc框架&colon; thrift/avro/protobuf 之maven插件生成java类
thrift.avro.probobuf 这几个rpc框架的基本思想都差不多,先定义IDL文件,然后由各自的编译器(或maven插件)生成目标语言的源代码,但是,根据idl生成源代码这件事,如果每次都 ...

随机推荐

GridView里做页面的链接
采用Gridview的OnRowDataBound属性后台 protected void gvTranslateInfo_RowDataBound(object sender, GridViewRo ...
zk jquery的使用
jQuery_effects.zul: <?page title="Jquery" contentType="text/html;charset=UTF-8&quo ...
Quartz2&period;2&period;1操作手册
一.初识quartz JobDetail job = newJob(HelloJob.class).withIdentity("job1", "group1") ...
解决MySQL5&period;6中的Slave延迟问题的基本教程
一.原因分析一般而言,slave相对master延迟较大,其根本原因就是slave上的复制线程没办法真正做到并发.简单说,在master上是并发模式(以InnoDB引擎为主)完成事务提交的,而在sla ...
qt用mingw编译时报错 multiple definition of
网上相关回答不少,但过于简单,这里做一下记录. qt用mingw编译程序时报“multiple definition of …”这个错误,错误信息大概是如下图所示: 1 2 3 首先,检查自己的程序是 ...
chrome 调试跨域iframe
相关链接:https://*.com/questions/3102819/disable-same-origin-policy-in-chrome https://stacko ...
springboot(九)-log配置
spring项目放到tomcat中运行,我们可以在tomcat的logs文件夹下面生成log文件.那么我们的springboot项目没有放到系统安装的tomcat容器中,怎么设置生成log文件呢? 有 ...
Python 默认参数值
Python 默认参数值,对于一些函数来说,你可能为希望使一些参数可选并使用默认的值,以避免用户不想为他们提供值的情况.默认参数值可以有效帮助解决这一情况.你可以通过在函数定义时附加一个赋值运算符(= ...
CALayer层的属性(转)
一.position和anchorPoint 1.简单介绍 CALayer有2个非常重要的属性:position和anchorPoint position: (1)用来设置CALayer在父层中的 ...
hihoCoder &num;1867 GCD
在集合 $[n]$ 上使用容斥原理. 固定 $i$,考虑有多少个 $j \in [n]$ 满足 $\gcd(i, j) = \gcd(a_i, a_j) = 1$,将此数目记作 $f_i$.暂时不考虑 ...