11 Aug
2007
11 Aug
'07
10:05 p.m.
On Aug 9, 2007, at 9:43 PM, Frank Misa wrote:
Hi All,
[snip]
2) I would be very grateful to a link to some decent
tutorial/
documentation -- even if I have to pay for it...
It would be great to see something along the lines of the
"FAQTutorial" but with more indepth look at available Velocity
objects/macros and discussion of how Documents/Classes/Objects/
Properties are actually related....
I can't believe this stuff isn't better documented :(
Yep we need to rewrite that tutorial on Class/Object/Templates/
Classsheets. Would be great if you can help.
Here's a short version:
* Classes contain definition of a concept. A definition is made of
properties. A property can be a string, a text area, a combo box, a
radio button choice, etc. A class is created inside a document.
There's a class tab in the edit view of a document.
* An Object is the instantiation of a Class in a document. This means
that several documents can all instantiate the same class but have
different values of the class properties. When you edit a document
there's an Object tab that allows you to view all existing objects
associated with a document and modify their properties values or add
new objects.
* A classsheet is some generic code to display the content of an
object. Classsheets are meant to be used by being included in a
document containing an instance of the object they're meant to
display. The include is done using #includeInContext("classsheet name").
* A classtemplate is simply an "empty" page that already has the
include to the classsheet and an object added. It's meant to be used
in forms and be copied when user ask to create a new document easily.
The 2 important core concepts are classes and objects. The rest (i.e.
classsheet and classtemplates) are just easy ways to display object
content and create new documents.
Hope it helps,
-Vincent