Skip to content

Generate Max object documentation in a saner fashion

Notifications You must be signed in to change notification settings

jamesb93/documax

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Creates some manual documentation for FluCoMa objects that don't fit nicely into the current build system.

Instructions

Installation

  1. pnpm i -g documax

Local Development

  1. pnpm link -g .

Explanation

Documentation is described in TOML files. The name of the file should correspond to the name of the object, though it doesn't have to necessarily.

Using moustache templates data from the TOML representation is rendered via a template (see the example/templates folder).

Usage

I have provided an example set of .toml files as inputs and a basic Max template that can be used to generate a pretty full featured .maxref.xml.

Assuming you have this repo somewhere on your machine and you have cd to it...

documax -i example/inputs/ -o example/outputs/ -t example/templates/max.mustache

This will iterate over all the .toml files and render their data via the max.mustache template and output the .maxref.xml files to example/outputs. If you need something more bespoke, edit the template.

About

Generate Max object documentation in a saner fashion

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Mustache 58.5%
  • JavaScript 41.5%