2. Mike van Riel
@mvriel
Lead Developer of DocBlox
Senior Developer for Unet B.V.
Active with PHP since 2002
3. What is DocBlox?
● Documentation Generation Application (DGA) for PHP
● Inspired by phpDocumentor and JavaDoc
● Generates documentation from your source code
● Uses the comments in your source code
6. Project Goals
● Generate great documentation!
● Low memory footprint
● High-speed processing
● Support for PHP 5.3 features
● Compatibility with phpDocumentor tags and syntax
● Extensibility
● Forward compatibility
7. Status
● Memory: Processing ZF only uses approx. 50MB
● Speed: Processing ZF takes 7 to 9 minutes
(instead of 80 - 100)
● PHP 5.3: Full support for all new features
● Extensibility: 3 Level API
Easy theming
Plans for behavioural / tag plugins
8. Docblocks
/**
* This is a short description.
*
* This is a long description, which
* may span multiple lines and contain
* {@inline} tags.
*
* @param string $a This is the first variable.
* @param int $b This is the second variable.
* @param array $c This is the third variable.
*
* @return void
*/
function MyFunction($a, $b, array $c)
{
}
9. Supported elements
● Files
● Namespaces
● Includes
● Classes
● Functions, methods and closures
● Properties
● Constants, both global and class
● Docblocks for all of the above
15. BRANDING tips
● Re-use the default theme XSL templates as much as
possible. They add functionality onto your branding.
● When invoking branding from outside the DocBlox
application folder; it will be moved to
data/themes/cache first.
● Mind the relative paths between server side and client
side; they probably differ.
16. CODE!
Let's browse the code.
$ git clone http://github.com/mvriel/docblox