Introduction

The JBake Project NetBeans plugin is designed to support the JBake WebSite builder.

It currently provides basic Netbeans Project support for a site being built by JBake. This includes:

  • Identification of JBake websites - by the presence of a jbake.properties file at the root level of the project.

  • Capability to run the JBake executable from within Netbeans. This is provided as a project node action.

  • Additional executables or scripts may be added to a project node as actions, allowing more commands to be added at the individual project level.

No features of JBake are thought to be masked by this plug-in.

Caution
 The predefined project node actions are limited to unix family systems (ie Linix and MacOS). No Windows implementation have yet been completed. This does not stop a user attempting to use the additional CLI actions capability to execute the JBake -b command, but the provided Bake action does not yet work for Windows.

Examples of the JBake NB-Plugin

The basic project structure

The basic project structure that is recognised by this plug-in is that generated by jbake -i.

basic project structure

The basic project nodeactions

The project includes an action to use jbake -b command to build the site.

basic project actions

The output of the command is routed to the NetBeans Output Window, while the generated website is created in the output folder.

basic project structure

The project structure with projectactions.properties

The projectactions.properties file is used to add further CLI commands to the project action list.

project structure with projectactions

The projectactions file structue is defined in the ActionsSupport documentation, but a basic example is show here. The file defines an additional action to be added which starts jwebserver (to enable viewing of the generated website).

1.label = Start project test webserver
1.command = jwebserver -d "${NODEPATH}/output/"
1.tabname = Test Webserver for TRP-website
1.needscancel = yes
COMMANDCOUNT = 1

The project actions with projectactions.properties

The resulting project actions can be seen below:

project actions with projectactions

Utilising the JBake NBM

Installing the NBM into NetBeans

To be able to use the Plugin it must be downloaded and then installed in Netbeans.

Releases of this product are stored in a Maven repository on GitHub. The NBM can be downloaded from the Package available.

Once you have a downloaded copy on your machine, you follow the standard Netbeans process to install the downloaded file (Tools>Plugins). The ActionsSupport NBM must also be installed with or prior to installing this NBM.

Links

  • Releases are stored in a Packages Maven repository on GitHub

  • Source Code is stored in a Git repository on GitHub as part of a monorepro containing NBMs.

  • Documentation can be found on the TRP website.

  • Documentation source is stored in a Git repository on GitHub as part of a monorepro containing documentation.

  • Development Process Guide for The-Retired-Programmer products can be found on the TRP website.