/geocml-docs

(fork of) User documentation for geoCML (used for testing docs build)

GNU General Public License v2.0GPL-2.0

geoCML documentation

This repository hosts the documentation for the geoCML project. geoCML documentation is rendered to HTML and PDF from Asciidoc files (.adoc) using docToolchain. docToolchain requires that you have Docker installed on your system, as builds are rendered inside of a container.

Writing new documentation topics

You may choose to extend the default geoCML documentation (distributed with all geoCML Base Deployments) as you customize your deployment. All Asciidoc topics are found in the project's topics/ directory. Simply add your new topics as a .adoc file to this directory and build using docToolchain's command line tool.

How to build your documentation

Requirements:

  • asciidoctor
  • asciidoctor-pdf
  • asciidoctor-diagram

*nix / Bash:

Run ./grawdlew generateHTML generatePDF

Windows:

Run "./gradlew.bat" generateHTML generatePDF