These are the sources of my GitHub Pages website. It is powered by these awesome technologies from the Groovy ECO-system:
-
AsciiDoc and AsciidoctorJ
-
Groovy Server Pages (GSP)
I write the actual blog posts and other content in AsciiDoc format. These documents are then transformed by JBake using GSP page templates and Bootstrap stylesheets into HTML format. These HTML files are then published on my GitHub Pages website. All this is fully automated by a nice Gradle build.
The Gradle build file is the center piece controlling the whole process. It delegates to some helper build-files to keep things nice and uncomplected, to use a word revived by Rich Hickey the other day. There are some neat Gradle plugins helping me out here:
-
JBake plugin - Does the actual conversion from AsciiDoc to HTML and works with Gradle’s continuous build mode.
-
LiveReload plugin - Reloads the site-under-development continuously while authoring the AsciiDoc content.
-
Gadle-git plugin - Publishes the generated HTML pages to my GitHub Pages website.
Feel free to re-use my setup to get your your site going if you’d like. After cloning the project simply type ./gradlew tasks
and read the information below the Build Website tasks section. Then read some JBake documentation to create your own site out of it.
Ofcourse, you cannot use or re-publish my content files without my explicit permission: That’s all copyrighted material and belongs to me. This applies to everything living below the src
-folder. The rest is all copylefted and free to use for you. While authoring your own content you may find these AsciiDoc gists helpfull