[PHPTAL] automated documentation for templates?
x.meglio at gmail.com
Thu May 29 21:54:06 CEST 2008
I think your idea is useful and we it need be realized.
What other people think?
On Thu, May 29, 2008 at 10:25 PM, Jason - USL <jason at underdogseattle.com>
> Hi, everybody.
> I'm wondering if anybody's created or thought about a system for
> documenting the PHPTAL templates themselves. It seems to me that, for a
> project of any size, it would be ideal if each template could be
> processed by a documentation engine that tells the developers which
> variables/objects/arrays need to be passed into the template and how
> they're used.
> For example, if my template designer creates something like
> tal:repeat="option options", my php developer would see a corresponding
> line in the documentation saying that the variable 'options' needs to be
> set, and it needs to implement the iterable interface...
> I though maybe it could be achieved by hacking together some custom
> objects to use in place of the standard PHPTAL_Php_CodeGenerator and
> PHPTAL_Php_CodeWriter to generate documentation instead of compiled
> template files.
> After getting into the code, though, it looks like a bigger project than
> I'd thought. So, I was wondering if anybody on the list has done
> something like this, or has better ideas for communicating and
> documenting the templates' functions.
> Thanks for any advice you can give,
> PHPTAL mailing list
> PHPTAL at lists.motion-twin.com
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the PHPTAL