sfWikifyPlugin - 1.0.0
doku-wiki-like documentation formatter plugin
You are currently browsing
the website for symfony 1
A plugin that reads from the schema.yml file and generates a doku-wiki-like syntax to describe it
Plugin that helps documentation of data model in a symfony project using Propel ORM. Basically, what this plugin does is to parse config/schema.yml file and go through its classes and fields, generating a description using dokuwiki's syntax. The output might be seen on screen or be dumped to a specific file.
|CUESTA LUENGO, Jose Nahuel||lead||ra.ude.plnu.ipsec.ollorrased <<ta>> atseucn|
|DELUCCHI, Luciano||developer||ra.ude.plnu.ipsec <<ta>> ihcculed|
Copyright (c) 2008 Luciano Delucchi & Jose Nahuel Cuesta Luengo
sfWikify helps developers' job when dealing with documentation of a project's data model, by creating a description of the schema in a dokuwiki syntax.
Automatically parses your
It is compatible with symfony's empty columns.
It might be internationalized by editing a simple
Install the plug-in
symfony plugin:install sfWikifyPlugin
schema.yml file and add
description keys to the model, the classes and/or the fields:
## Description for the whole data model: description: Data model for fake project. classes: ClassA: tablename: class_a ## Description for a class: description: > ClassA represents objects of A class. columns: id: ## You might omit empty columns' description name: type: varchar(255) required: true ## Description for a single field: description: The name of the object. size: type: integer description: The size of the object. It might be 0. created_at: updated_at:
Run the task:
symfony doku:wikify en doc/doku.txt
symfony doku:wikify en
If your culture isn't currently bundled with the plugin (at the moment, only
en are supported), you might create a i18n file for the plugin.
You just have to place it anywhere in the project and the plugin will try to find it.
The requirements for this are:
The file must be named like
The file must have the following structure (you can use the ones bundled with the plugin as an example):
## en culture internationalization file messages: title: Data model fields: Fields type: Type default: Default value primary_key: Primary key created_at: Object's creation date updated_at: Object's last update date foreign_reference: References
That's it! Unless you feel like collaborating with us, you can email us at
ncuesta at desarrollo dot cespi dot unlp dot edu dot ar and send the i18n file ;)