JBake

JBake v2.6.4 released

Sun, 27 Jan 2019 00:00:00 +0000

JBake v2.6.4 released

I’m happy to announce that JBake v2.6.4 has been released. This is primarily a bug fix release.

You can find the complete changelog for this release here: https://github.com/jbake-org/jbake/milestone/19?closed=1

This release should also be available via Maven Central, SDKMAN and Homebrew in the next few days.

Download JBake v2.6.4 now and get baking!

Fixes

Enhancements

Updates

asciidoctorj from 2.5.7 to 2.5.8.1
Upgrade Jetty to 9.2.26.v20180806
asciidoctorj-diagram 1.5.10 to 1.5.11
flexmark 0.34.48 to 0.40.8
groovy 2.5.3 to 2.5.5
thymeleaf 3.0.9.RELEASE to 3.0.11.RELEASE

Contributors

In no particular order:

Thank you for your time and patience.

A warm thank you to all people we missed to mention who spread the word and open issues.

JBake v2.6.3 released

Tue, 16 Oct 2018 00:00:00 +0000

JBake v2.6.3 released

I’m happy to announce that JBake v2.6.3 has been released. This is primarily a bug fix release.

switched temporarily to jruby 9.1.17.0

There is a bug in asciidoctorj 1.5.7 rendering many documents on the same asciidoctor instance.
update to groovy 2.5.3 to get everything working with JDK 11

You can find the complete changelog for this release here: https://github.com/jbake-org/jbake/milestone/18?closed=1

This release should also be available via Maven Central, SDKMAN and Homebrew in the next few days.

Download JBake v2.6.3 now and get baking!

JBake v2.6.2 released

Sun, 7 Oct 2018 00:00:00 +0000

JBake v2.6.2 released

I’m happy to announce that JBake v2.6.2 has been released. This is a primarily a bug fix release.

One change that you should be aware of is that the automatic image path update feature introduced in v2.6.0 has been wrapped in a feature flag (img.path.update) and disabled by default.

You can find the complete changelog for this release here: https://github.com/jbake-org/jbake/milestone/17?closed=1

This release should also be available via Maven Central, SDKMAN and Homebrew in the next few days.

Download JBake v2.6.2 now and get baking!

JBake v2.6.1 released

Sun, 15 Apr 2018 00:00:00 +0000

JBake v2.6.1 released

I’m happy to announce that JBake v2.6.1 has been released. This is a bug fix release.

You can find the complete changelog for this release here: https://github.com/jbake-org/jbake/milestone/16?closed=1

This release should also be available via Maven Central, SDKMAN and Homebrew in the next few days.

Download JBake v2.6.1 now and get baking!

JBake v2.6.0 released

Sun, 4 Mar 2018 00:00:00 +0000

JBake v2.6.0 released

I’m happy to announce that JBake v2.6.0 has been released. This is a major release that includes a number of new features as well as bug fixes and changes.

Here are a few of the major changes included in this release:

Java 7 is now required to run JBake
Project has switched to Gradle for build
Improved execution scripts inc. support for additional JAR files
Asset and Content directories can be marked to be ignored from processing
Static files such as images can be included in the Content directory tree
Server mode now watches for changes to Asset and Template directories
Relative image src values are now automatically updated
Added more data variables for use in templates when paging
AsciidoctorJ-Diagram is included in binary distribution (not declared as a dependency though) so you can include diagrams in your AsciiDoc content

Note	If you are using pagination for the index page i.e. `index.paginate=true`, then please verify that you are using `published_posts` or equivalent `published_{contentType}` model instead of `posts` model. See this bug fix for details.

Note	The value to persist the content store to disk has changed from `local` to `plocal`, so the configuration option should be: `db.store=plocal`

You can find the complete changelog for this release here: https://github.com/jbake-org/jbake/milestone/14?closed=1

Thanks to everyone who has contributed something to this new release, and especially to Frank Becker and Manik Magar who put a tremendous amount of work into this release. I’m also pleased to say they have recently joined the JBake team.

This release should also be available via Maven Central, SDKMAN and Homebrew in the next few days.

Download JBake v2.6.0 now and get baking!

New HTML5 based Template - JBake Future Imperfect

Fri, 2 Jun 2017 00:00:00 +0000

New HTML5 based Template - JBake Future Imperfect

I am happy to announce that, I have ported a beautiful HTML5 based template for JBake.

Here is how the baked site looks like:

Demo: See this

Features

This template provides many features out of the box i.e. no need to modify any template files. Just configure the jbake.properties and bake your site.

Disqus comments
Google Analytics
Estimated Time to read for posts
Social Links
Configurable Site menus
Featured Images for posts
404 error handling on Github/Gitlab pages
Social Share menu on posts

To know more about installing, configuring and using this template, check the github repository.

Hope you will like it. Keep Baking!

JBake v2.5.1 released

Wed, 1 Feb 2017 00:00:00 +0000

JBake v2.5.1 released

I’m happy to announce that JBake v2.5.1 has been released. This is a minor release that includes a number of bug fixes, some small enhancements and a couple of changes.

Here are the release notes for this version…

Bugs fixed:

When a directory has a dot (".") in it, but the filename doesn’t, FileNotFoundException results. #300
Index variables don‘t exist despite enabled pagination #310 & #312
JBake JettyServer doesn’t work with custom destination #314 & #316
Regression on issue #181 #315
Tag pages are created for documents of type post only #323
Index template is not rendered regardless of config if no content of type post exists in site/project #325
jbake: "-b" is not the default action any more #331
jbake-master: "jbake -b" shows java.util.NoSuchElementException: 'index.paginate'… #332 & #336
Bake fails on jbake.org due to duplicate SHA1 hashes in index #339

New features:

Add support for symbolically linked launcher #311
Expand allowed characters for template type name #317
Added new data model variable 'tagged_documents' #323
jbake-master: realpath: command not found on Ubuntu-14.04 #329 & #330

Changes:

Ignore javadoc error on package #309
Use StringBuilder more consistently #328

I’d like to say thanks to everyone who has contributed something to this new release, so in no particular order: Frank Becker, uli-heller, P. Ottlinger, Oliver Lietz, Christian Beikov, Mike McGarr, Gilberto Caetano de Andrade, lamvak, Tobias and Michael Nygard.

This release should also be available via Maven Central, SDKMAN and Homebrew in the next few days.

Download JBake v2.5.1 now and get baking!

Interview on Cynical Developer podcast

Sun, 18 Dec 2016 00:00:00 +0000

Interview on Cynical Developer podcast

I got the opportunity recently to be interviewed on the Cynical Developer podcast by James Studdart who I discovered through the local Chester Devs group.

The interview covered what static site generation is, where it came from, why it’s called baking, what the benefits are of static sites and how JBake fits into it all.

You can listen to the interview here and make sure you subscribe to the podcast as well to find out more about a range of development technologies.

JBake v2.5.0 released

Fri, 7 Oct 2016 00:00:00 +0000

JBake v2.5.0 released

I’m extremely happy (and relieved) to announce that JBake v2.5.0 has finally been released. This is a big release that includes a number of new features as well as numerous bug fixes and in terms of issues/pull requests closed it is the largest release ever.

Here are the release notes for this version…

New features:

New options from Pegdown 1.6 #299
Support for Cygwin #225
Added support for Groovy’s MarkupTemplateEngine #282, #244 & #185
Allow gemPath to be specified for the AsciidoctorEngine #267 & #269
Detailed errors with stack trace of the original problem #219
Last modification date as alternative to date header #217
Added support for pagination #186, #101 & #115
Watch mode added to auto bake when content file changes #253 & #183
Changed default behavior of jbake #236
Added support for Jade template engine #154 & #166
Added support for extensionless URI’s #104

Bugs fixed:

Exec script issues on Mac OS X #307
OrientDB is now correctly shutdown after baking #296
Blog posts get duplicated when db.store=local is used #290
Register model extractors for custom types #286
Custom types are broken #283
"alltags" does not contain tags from custom template types #266
Setting asciidoctor.option.template_dirs in jbake.properties causes an error #252
Fixed loading of RenderingTool Providers #248
tag_posts: Contains draft posts as well as published posts #213 & #214
Rendering appears to be broken in master #254
Incremental rendering feature is broken in v2.4.0 #226
Empty output.extension causes NPE #234
Setting output.extension to an empty string causes errors when rendering #233

Changes:

Update AsciidoctorJ to v1.5.4.1
Upgrade Thymeleaf to 3.0 #262 & #263
Pegdown upgraded to v1.6.0 #222
Updated Apache Commons IO to v2.5 #304
Updates to versions of maven dependency and plugins #270
Small code improvements #306
Add tests for DocumentsRenderer #298
Improve error messages when required folders are missing #235
Remove org.jbake.app.SortUtil class as it’s no longer used #258 & #239
(GroovyTemplates) Use English Locale in the date formatter #256
Clean up and Asciidoctorj version change #255
Add tests to (most of) the rendering layer #250
Minor refactoring #249
Fixed broken template engine unit tests #247
Superfast baking with Thymeleaf #220
Extracted various rendering modes to allow their customization #138
Preliminary refactoring #135
Simplify and aggregate rendering testing #175

I’d like to say thanks to everyone who has contributed something to this new release, so in no particular order: Frank Becker, Oliver B. Fischer, Jobin Jacob Kavalam, P. Ottlinger, jhrom, Gilberto Caetano de Andrade, atao60, Mike Kobit, Marco Tolk, Abel Salgado Romero, Steve E., Erik Pragt, Uma Bala, Andres Almiray, Oliver Lietz, Jérémie Bresson, Daniel Grycman, David Simons, Hereward, Bernhard Haumacher, uli-heller, Heimo Laukkanen, Mariusz Fik, Senthilkumar Gopal, cloudtu, Mariusz Smykuła, Nicolas Delsaux, Jason Lee, Mitchell Bösecke, Aleksandar Vidakovic, Moandji Ezana & Alex Miller.

This release should also be available via Maven Central, SDKMAN and Homebrew in the next few days.

Download JBake v2.5.0 now and get baking!

JRE Support for JBake

Wed, 4 Nov 2015 00:00:00 +0000

JRE Support for JBake

To help define the future roadmap for JBake we’re after some feedback from users of JBake in regards to the JRE required to run JBake.

If you could spare 2 minutes please complete the following form: http://goo.gl/forms/YhPww3UyQE

Thanks in advance!

JBake v2.4.0 released

Sat, 30 May 2015 00:00:00 +0000

JBake v2.4.0 released

I’m extremely happy to announce that JBake v2.4.0 has finally been released. This is a feature release that includes a number of new features as well as bug fixes and in terms of issues/pull requests closed it is the largest release ever.

Here are the release notes for this version…

New features:

New and improved documentation for project #196
Metadata header now supports JSON format being used #114
Init option now allows folder to be specified #147, #151 & #156
Allow custom file extension to be specified for custom templates #152 & #155
Locate output directory in source folder by default #157 & #158
Thymeleaf templates can now use the .html extension #163
Improved use of JBake as library by removing System.exit calls #167 & #168
Markdown extension: STRIKETHROUGH added and allowed some extensions to be disabled #171
Added tag.sanitize configuration option #181
Added asset.ignore configuration option #193
Added ConditionalCommentsDialect support for Thymeleaf #195 & #200

Bugs fixed:

Make sure no null tag list could break process #129
The href of stylesheet in generated "tag".html is wrong #148
Asset directory name was hard coded #162
Colon in Asciidoctor based post prevents proper title rendering #164
Broken link to /archive in index.gsp #172
Special character in the title field of the metadata header are not escaped #173 & #192
"Unable to convert object to String[] error shown multiple times with no explanation #174
Redundant slash in the example project structures #187
Leading spaces in tags defined in AsciiDoc format are not removed #191
Discrepancy in numbers output when baking jbake.org #204

Changes:

Update AsciidoctorJ to v1.5.2 #153, #197 & #203
Update Jacoco to 0.7.X #142
custom.properties is now deprecated and a warning shown if used #50 & #134
Extract all config constants in one interface #132
Make sure content.rootpath returns empty string instead of null #150
All DB related code moved to behind a facade - ContentStore #169
Reclassified ERRORS to WARNINGS when invalid metadata header is detected and display relevant file #179
Added delegating constructor to Oven to maintain existing API #194 & #198
Removed debug statements from AsciidoctorJ library #199
Made sure OrientDB logging is piped through so it can be controlled via JBake logging configuration #205 & #207

I’d like to say thanks to everyone who has contributed something to this new release, so in no particular order: Yan Bonnel, Nicolas Delsaux, Vadim, Mariusz Smykuła, flyisland, Gerard Ryan, HuguesH, Christian Bauer, Oliver B. Fischer, Tobias Roeser, Jason Lee, uli-heller, Gilberto Caetano de Andrade, Dmitri Smirnov, Frank Becker and pitpalme.

This release should also be available via Maven Central, GVM and Homebrew in the next few days.

Download JBake v2.4.0 now and get baking!

JBake v2.3.2 released

Sat, 20 Sep 2014 00:00:00 +0000

JBake v2.3.2 released

I’m happy to announce that JBake v2.3.2 is now available for download. This is a bug fix version and includes updated dependencies including Asciidoctor v1.5.0.

Here are the release notes for this version…

Project badges now use http://shields.io
Support for Asciidoctor v1.5.0
Fixes bug when tags has null value
Adds support for controlling Markdown parsing timeout
Fixes issue with files being kept open on Windows
Fixes issue with Orient DB not being shut down correctly after baking
Fixes issue with batch file on Windows when installed in folder with spaces
Fixes issue with leading & trailing spaces when parsing tags
Fixes issue with using relative paths with Asciidoctor v1.5.0
Reduced Groovy based dependencies
Asciidoctor updated to v1.5.0
Groovy updated to v2.3.6
Args4j updated to v2.0.36
JUnit updated to v4.11
SLF4J upgdated to v1.7.6
Logback updated to v1.1.1
AssertJ updated to v1.6.0
OrientDB updated to v1.6.4

I’d like to thank Andres Almiray, Nicolas Delsaux, dernasherbrezon, Aldrin Leal, Paolo Di Tommaso, Vitaly and Mariusz Fik for contributions in this release.

This release should also be available via Maven Central in the next few days.

Download JBake v2.3.2 now and get baking!

JBake v2.3.1 released

Thu, 10 Jul 2014 00:00:00 +0000

JBake v2.3.1 released

I’m pleased to announce that JBake v2.3.1 is now available for download. This version includes updated dependencies for Groovy, Thymeleaf & Freemarker as well as a slight change to the installation structure.

Here are the release notes for this version…

Groovy updated to v2.3.4
Thymeleaf updated to v2.1.3
Freemarker updated to v2.3.20
Execution scripts are now located underneath a /bin folder, so make sure to update your path references

This release is dedicated to the memory of my daughter Jessica.

JBake v2.3.0 released

Sun, 11 May 2014 00:00:00 +0000

JBake v2.3.0 released

I’m pleased to announce that JBake v2.3.0 has finally been made available for download. This is a big release packed full of new features and enhancements.

Here are the release notes for this version…

Incremental rendering support has been added to this release but been disabled by default (note: this feature is considered experimental at the moment)
Support for subdirectory projects has been added
Parsing & Rendering code has been modularised allowing more to added more easily
Default status can now be defined in configuration
Fixed URI bug on Windows
Added explicit bake command line option allowing bake+serve in one command
Configuration options now available from within AsciiDoc formatted files
Logging framework support has been added
Added support for Groovy based templates
Added support for Thymeleaf based templates
Fixed base directory for AsciiDoc includes
Expanded data model made available to templates
Improved error reporting
Example templates upgraded to use Bootstrap v3.1.1 & jQuery v1.11.1

I have to thank Tobias Roeser, Rainer Weinhold, Yaroslav Karandashev and especially Cédric Champeau for a massive amount of work that they contributed to this release. Thank you all!

This release should also be available via Maven Central in the next few days.

Download JBake v2.3.0 now and get baking!

JBake v2.2.1 released

Thu, 23 Jan 2014 00:00:00 +0000

JBake v2.2.1 released

I’m pleased to announce that JBake v2.2.1 is now available for download! This is mainly a maintenance release that addresses a couple of issues, specifically with AsciiDoc support and character encoding.

Here’s the full release notes for this version…

Allow date format used to be customised via configuration
Switched to Pegdown Markdown processor
Added support for rendering sitemap.xml
Added character encoding to configuration which is used for rendering
AsciiDoc related improvements
Addressed multiple issues in default templates
Cleaned up imports and unused variables

A big thank you goes out to Vad1mo, Andrej Kuročenko, Kevin S. Clarke, w32blaster, Yaroslav Karandashev and Tobias Roeser for contributions included in this release.

This release should also be available via Maven Central in the next few days.

Download JBake v2.2.1 now and get baking!

JBake v2.2.0 released

Wed, 23 Oct 2013 00:00:00 +0000

JBake v2.2.0 released

I’m pleased to announce that JBake v2.2.0 is now available for download! The big addition in this release is support for AsciiDoc formatted content, thanks to the Asciidoctor project.

Here’s the full release notes for this version…

Enhancements:

Add support for AsciiDoc format
Add support for serving up baked site locally
Add automatic publishing based on date
Look for jbake.properties as well
Add command line option to create required structure
Add version ouput when JBake is ran
Speed up AsciiDoc rendering be reusing Asciidoctor object
Add support for .adoc extension

Bugs:

Content header is being picked up from middle of content file but it shouldn’t be
Date for AsciiDoc formatted files is last modified date instead of revision date
Baking is considerably slow on large site (~250 pages across many sub-folders)

Updated documentation has also been released for this release along with a refresh of this site. From this release onwards the project will be adopting the Semantic Versioning system.

This new release should also be available via Maven Central in the next few days.

Download JBake v2.2.0 now and get baking!

JBake now has a logo

Tue, 15 Oct 2013 00:00:00 +0000

JBake now has a logo

A lot’s been happening behind the scenes of JBake recently, and thanks to a donation by Aldrin Leal the JBake project now has a logo!

Here it is…

Work is still on-going for the v2.2 release, which should be out soon once documentation is ready. I’m also pleased to announce that the project has now had contributions from Brazil, Italy, India as well as China.

JBake artifact available on Maven Central

Mon, 23 Sep 2013 00:00:00 +0000

JBake artifact available on Maven Central

I’m pleased to announce that JBake v2.1 is now available on Maven Central. Thanks go to Aldrin Leal for helping guide me through the release process.

If you’d like to use JBake in your project then here’s the dependency information you’ll need:

<dependency>
	<groupId>org.jbake</groupId>
	<artifactId>jbake-core</artifactId>
	<version>2.1.1</version>
</dependency>

More news soon about the upcoming v2.2 release and maybe a little more on Maven.

Mailing lists

Sun, 15 Sep 2013 00:00:00 +0000

Mailing lists

JBake now has 2 mailing lists for users and developers.

If you want to ask a question about how to use JBake then the users list is the one for you. If you’re a developer wanting to get involved then join the developers list.

JBake v2.1 released

Tue, 30 Apr 2013 00:00:00 +0000

JBake v2.1 released

Added unit tests
Added post baking stats
Command line arguments are now optional
Standardised the data model available to templates
Changed packaging
Added OS specific launch scripts

See the documentation for updated usage information of this release.

Thanks to mismatch for contributions in this release.

Download JBake v2.1.