FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

CommandBox DocBox Commands

v2.0.0+8 CommandBox Modules

DocBox Commands

DocBox Commands is a custom command you can install into CommandBox to generate API docs from the commandline. Documentation for DocBox can be found on the GitHub Wiki and in this Readme. The main Git repository and downloads can be found on GitHub. There is also a help forum located at https://groups.google.com/a/ortussolutions.com/forum/#!forum/docbox

LICENSE

Apache License, Version 2.0.

SYSTEM REQUIREMENTS

  • CommandBox 2.5+

Installation

Install the commands via CommandBox like so:

box install commandbox-docbox

Usage

Creates documentation for CFCs JavaDoc style via DocBox

You can pass the strategy options by prefixing them with strategy-. So if a strategy takes in a property of outputDir you will pass it as strategy-outputdir=

Examples:

docbox generate source=/path/to/coldbox mapping=coldbox excludes=tests strategy-outputDir=/output/path strategy-projectTitle="My Docs"

Multiple mappings may be specified, where the key is the mapping and the value is the source directory. For example, the following generates documentation for two different versions of a model:

docbox generate mappings:v1.models=/path/to/modules_app/v1/models mappings:v2.models=/path/to/modules_app/v2/models strategy-outputDir=/output/path strategy-projectTitle="My Docs"

Arguments:

  • strategy - The strategy class to use to generate the docs.
  • source - The directory containing the CFML source.
  • mapping - The base mapping for the source folder.
  • excludes - A regex that will be applied to the input source to exclude from the docs.
  • mappings:* - One or more dynamic parameters defining source and mapping. This argument will override source and mapping if provided.

CREDITS & CONTRIBUTIONS

I THANK GOD FOR HIS WISDOM FOR THIS PROJECT

THE DAILY BREAD

"I am the way, and the truth, and the life; no one comes to the Father, but by me (JESUS)" Jn 14:1-12

<<<<<<< HEAD

CHANGELOG

v1.1.0

  • Enable support for multiple source mappings provided, thanks to @jlamoree

v1.0.0

  • Initial creation of separate CommandBox project =======

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.


[v2.0.0] => 2021-FEB-22

Added

  • Upgraded to DocBox v3
  • Code Quality updates
  • Automated testing, code quality and s3 binaries

[v1.0.0] => 2018-AUG-3

  • Initial creation of separate CommandBox project

development

$ box install commandbox-docbox

No collaborators yet.
     
  • {{ getFullDate("2016-01-18T23:17:24Z") }}
  • {{ getFullDate("2021-02-22T22:25:34Z") }}
  • 5,330
  • 103,389