Wiki source code of EOModelDoc
Version 22.1 by Chuck Hill on 2008/07/31 15:24
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | == Overview == | ||
| 2 | |||
| 3 | EOModelDoc is a command line tool to generate HTML documentation of a set of EOModels. It is a replacement for [[EOReporter>>http://www.rubicode.com/Software/EOReporter/]] (which will not work on Leopard and newer releases of OS X). EOModelDoc was funded by the Apple iTunes Store and released to the community. | ||
| 4 | |||
| 5 | On the WOLips side, from version 3.3.x, [[Entity Modeler>>Using Entity Modeler]] has a Documentation tab on all of the elements of a model that lets you record HTML documentation for your model, entities, attributes, etc. There is even an HTML preview. You can then run eomodeldoc to produce documentation much like javadoc for your model. | ||
| 6 | |||
| 7 | == Future Plans == | ||
| 8 | |||
| 9 | From Mike Schrag: //There's not a nice build process for this one either, yet, because it includes all of the eclipse dependencies in the single jar. Eventually I'll make this nicer and include it actually inside of Eclipse. There are also modifications to the ERNeutralLook coming soon that will display popup help for you models based on the model documentation.// | ||
| 10 | |||
| 11 | == Download and Example Output == | ||
| 12 | |||
| 13 | [[Download EOModelDoc jar>>http://webobjects.mdimension.com/wolips/eomodeldoc.jar]] | ||
| 14 | |||
| 15 | This is an example of the current state of eomodeldoc (the default templates are not done, but it will give you an idea of what it can do). The templates are all Velocity-based, and you can override them with custom versions. This was run in the BugTracker project folder. This model does not have documentation added to it with the new Entity Modeler yet, so it looks a little more bare than it would if it was documented properly. I'll probably document it just to have a full example to show. | ||
| 16 | [[View Example Output>>http://webobjects.mdimension.com/wolips/eomodeldoc_example/]] | ||
| 17 | |||
| 18 | == Usage == | ||
| 19 | |||
| 20 | Still working on all the model loaders, but you should be able to do | ||
| 21 | |||
| 22 | java --jar eomodeldoc.jar --model /path/to/model.eomodeld --output /tmp/ | ||
| 23 | eomodeldoc | ||
| 24 | (will load all the models in the modelgroup based on your eclipse or | ||
| 25 | IDEA project files ..... allegedly ... still working the kinks out on | ||
| 26 | this) | ||
| 27 | or | ||
| 28 | |||
| 29 | java --jar eomodeldoc.jar --modelgroup /path/to/project --output /tmp/ | ||
| 30 | eomodeldoc | ||
| 31 | (i haven't tried that one yet) | ||
| 32 | |||
| 33 | or | ||
| 34 | |||
| 35 | java --jar eomodeldoc.jar --output /tmp/eomodeldoc | ||
| 36 | from inside your project | ||
| 37 | |||
| 38 | Tthe usage syntax of the eomodeldoc.jar: | ||
| 39 | |||
| 40 | [[mbp:~~]] th% java --jar eomodeldoc.jar | ||
| 41 | eomodeldoc --output /path/to/output/folder [[-model pathtomodel.eomodeld]]** [[-modelgroup pathtoworkingdir]] [[-templates pathtotemplates]] [-entityURLTemplate "http:~/~/whatever?${{entity.classNamePath}}{{/entity.classNamePath}}.html ** |