Skip to content

spl1nes/Documentor

 
 

Repository files navigation

What is the documentor

This documentation generator creates a html documentation for php classes based on the comments provided for classes, interfaces, traits, methods, variables etc. The generated output is html, css and js and can be styled with custom themes as desired.

Requirements

  • PHP Version >= 7.4

Demo

https://orange-management.org/Inspection/Test/Php/DocBlock/ (Guide not implemented)

Usage

A list of arguments can be found with:

php Documentor/src/index.php -h

The default usage would be:

php Documentor/src/index.php -s <SOURCE_PATH> -d <DESTINATION_PATH> -c <COVERAGE_PATH> -b <BASE_URL>

The documentation starts to shine when you use a unit test log as well as the coverage report and a html guide. The default template does not hide these pages if they are missing and the overall experience will be not as good.

Arguments

Supported Key Words

The following key words hold special meaning in the code documentation.

@var @param @version @since @latex @example @output @annotation @license @link @package @return @throws @todo @uses @see @deprecated

Preview

Coverage

coverage

Tests

test

Class documentation

class

Method documentation

method

About

PHP documentation generator

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 87.5%
  • CSS 7.7%
  • JavaScript 4.8%