Improve Markdown to HTML processing with version variable

[jlouvel]

While starting to work on the upgrade of the user guide for version 2.2, I have listed the following items that would improve maintainability of the docs:

• provide a variable for the current version so that we don't need to manually change them when branching for a new version
• this variable should be usable inside URL as well as in regular text
• preprocessing the Markdown pages before the HTML conversion seems better

[jlouvel]

Set to milestone 2.2 RC2.

[thboileau]

Does the following suits you? ${restlet.version}

[thboileau]

Reassigned to JLO for advice.

[jlouvel]

Thierry, could we reuse the same version variables as in the build for the maximum flexibility?

• restlet-version-major: 2
• restlet-version-minor: 2.2

Like in templ/config/ files:

• restlet-version-full: 2.2 Release Candidate 1
• restlet-version-compact: 2.2 RC1
• restlet-version-maven
• restlet-version-manifest-prefix

Assigned to TBO

[thboileau]

list of supported variables, used as ${restlet.version-maven}:

• restlet.version-major
• restlet.version-minor
• restlet.version-full
• restlet.version-compact
• restlet.version-maven
• restlet.version-manifest-prefix

[jlouvel]

Thierry, is this possible to have a consistent separator, either dot or hyphen instead of a mix?

For example:

• restlet.version.major
• restlet.version.minor
• restlet.version.full
• restlet.version.compact
• restlet.version.maven
• restlet.version.manifestPrefix

[thboileau]

list of supported variables, used as ${restlet-version-maven}:

restlet-version-major
restlet-version-minor
restlet-version-full
restlet-version-compact
restlet-version-maven
restlet-version-manifest-prefix