DownloadBuilder and Template to create a github wiki with phpDocumentor 3
Overview
This package contains a PHP CLI script and the needed template to create the class reference for
your PHP repository in the format for a github wiki using phpDocumentor 3.
GitHub wiki provides an easy-to-use tool for creating a documentation.
With this package, the work of adding a complete class reference to this documentation is automated with the help of phpDocumentor.
Usage
-
The easiest way is to make the githubwiki.phar available on the system and configure your project. (read the section 'Create the githubwiki.phar' at the end of this document for more information)
-
For more control over the creation steps, the template can be used directly with phpDocumentor and the publication on github can be done with git and/or github-dektop. A corresponding bash script is included in the package for this purpose.
The use and configuration of both methods is explained in detail in the blog that was published for this package.
Donation
If you like githubwiki please consider donating at Paypal
Acknowledgments
-
The builder makes use of the package CLICommander from phpClasses.org contributed by Don Bauer (lordgnu@me.com).
-
Thanks to Théo FIDRY for contributing the box project to easy-create PHAR's
Create the githubwiki.phar
The githubwiki.phar can be easily created using the box builder:
-
Download latest version from the github repository.
-
Make it available on your system:
sudo mv box.phar /usr/local/bin/box
sudo chmod +x /usr/local/bin/box
-
change to the base directory of this package
-
call the box builder
box build -v
-
The created `githubwiki.phar` can be found in the `bin` directory.
|