Skip to content

Latest commit

 

History

History
executable file
·
52 lines (44 loc) · 2.17 KB

config.json.md

File metadata and controls

executable file
·
52 lines (44 loc) · 2.17 KB

config.json Configuration Options

When this project is installed a default config.json is generated in the project's folder. This document outlines the different configuration options.

Outline

{
  "<projectName>" : {
    "debug" : false,
    "folders" : {
      "output" : {
        "path" : "/Users/giffy/Documents/GitHub/oraopensource/oos-utils/docs"
      },
      "source" : {
        "path" : "/Users/giffy/Documents/GitHub/oraopensource/oos-utils/source/packages",
        "fileFilterRegexp" : "\\.pk(b|s)$"
      },
      "template" : "/Users/giffy/Documents/GitHub/oraopensource/plsql-md-doc/templates/package.md"
    },
    "projectDispName" : "",
    "toc" : {
      "fileName" : "index.md",
      "template" : "<fill path to template file>"
    }
  }
}

Description

Parameter Required Description
<projectName> required Unique name of the project.
<projectName>.debug optional Default: false. Run app in debug mode.
<projectName>.folders required single JSON object array of objects. Use the an array if the project has multiple folders to process.
<projectName>.folders.output required JSON object for output information
<projectName>.folders.output.delete optional Boolean to delete contents in folder. Default false.
<projectName>.folders.output.path required Path to folder where .md files will reside.
<projectName>.folders.source required
<projectName>.folders.source.path required Path to folder that contains the source files
<projectName>.folders.source.fileFilterRegexp optional Regular expression to filter files from paths/src
<projectName>.folders.template required Full path to .md template file to use for the documentation.
<projectName>.projectDispName optional Used for the TOC. If none provided, then the root projectName in the config file will be used.
<projectName>.toc optional Table Of Contents (TOC) file. The template attribute is required to trigger generation.
<projectName>.toc.fileName optional Name of TOC file. Default index.md
<projectName>.toc.template required Full path to .md template file to use for the index

Example

TODO;