A minimally viable wiki written with Vert.x

Tip
The corresponding source code is in the step-1 folder of the guide repository.

We are going to start with a first iteration and the simplest code possible to have a wiki written with Vert.x. While the next iterations will introduce more elegance into the code base as well as proper testing, we will see that quick prototyping with Vert.x is both a simple and a realistic target.

At this stage the wiki will use server-side rendering of HTML pages and data persistence through a JDBC connection. To do so, we will use the following libraries.

  1. Vert.x web as while the Vert.x core library does support the creation of HTTP servers, it does not provide elegant APIs to deal with routing, handling of request payloads, etc.

  2. Vert.x JDBC client to provide an asynchronous API over JDBC.

  3. Apache FreeMarker to render server-side pages as it is an uncomplicated template engine.

  4. Txtmark to render Markdown text to HTML, allowing the edition of wiki pages in Markdown.