Recommend this page to a friend! |
Download |
Info | Example | Files | Install with Composer | Download | Reputation | Support forum | Blog | Links |
Ratings | Unique User Downloads | Download Rankings | ||||
Not yet rated by the users | Total: 84 | All time: 10,045 This week: 560 |
Version | License | PHP version | Categories | |||
php-readme-helper 1.0.0 | MIT/X Consortium ... | 7 | Tools, Project Management, Language, P..., P... |
Description | Author | |
This package can be used as an API documentation generator for README files. Innovation Award
|
<?php |
[//]: # (AUTO-GENERATED BY "PHP README Helper": base file -> docs/base.md)
Helper to auto-generate the API documentation in your README file.
(build/generate_docs.php)
$readmeGenerator = new \voku\PhpReadmeHelper\GenerateApi();
$readmeText = ($readmeGenerator)->generate(
__DIR__ . '/../src/voku/PhpReadmeHelper/GenerateApi.php',
__DIR__ . '/docs/base.md'
);
file_put_contents(__DIR__ . '/../README.md', $readmeText);
<p id="voku-php-readme-class-methods"></p>
<a href="#voku-php-readme-class-methods">?</a> This method can generate API documentation with types from php code into your README file.
Parameters:
- string $codePath <p>Path to a file or a directory.</p>
- string $baseDocFilePath <p>Path to your base file for the README.</p>
- array<array-key, string>|null $useClasses <p>If used, you can specify to classes, you will use.</p>
Return:
- string <p>Return a string with the generated README.</p>
For support and donations please visit Github | Issues | PayPal | Patreon.
For status updates and release announcements please visit Releases | Twitter | Patreon.
For professional support please contact me.
Files (25) |
File | Role | Description | ||
---|---|---|---|---|
.github (3 files) | ||||
build (1 file, 1 directory) | ||||
src (1 directory) | ||||
tests (3 files, 1 directory) | ||||
.editorconfig | Data | Auxiliary data | ||
.scrutinizer.yml | Data | Auxiliary data | ||
.styleci.yml | Data | Auxiliary data | ||
.travis.yml | Data | Auxiliary data | ||
CHANGELOG.md | Data | Auxiliary data | ||
circle.yml | Data | Auxiliary data | ||
composer.json | Data | Auxiliary data | ||
LICENSE.txt | Doc. | Documentation | ||
phpcs.php_cs | Example | Example script | ||
phpstan.neon | Data | Auxiliary data | ||
phpunit.xml | Data | Auxiliary data | ||
psalm.xml | Data | Auxiliary data | ||
README.md | Doc. | Documentation |
Files (25) | / | .github |
File | Role | Description |
---|---|---|
CONTRIBUTING.md | Data | Auxiliary data |
ISSUE_TEMPLATE.md | Data | Auxiliary data |
PULL_REQUEST_TEMPLATE.md | Data | Auxiliary data |
Files (25) | / | src | / | voku | / | PhpReadmeHelper |
File | Role | Description | ||
---|---|---|---|---|
Template (1 file) | ||||
GenerateApi.php | Class | Class source | ||
GenerateStringHelper.php | Class | Class source |
Files (25) | / | src | / | voku | / | PhpReadmeHelper | / | Template |
File | Role | Description |
---|---|---|
TemplateFormatter.php | Class | Class source |
Files (25) | / | tests |
File | Role | Description | ||
---|---|---|---|---|
fixtures (1 file) | ||||
bootstrap.php | Aux. | Auxiliary script | ||
Dummy.php | Class | Class source | ||
PhpDocHelperTest.php | Class | Class source |
The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page. |
Install with Composer |
php-readme-helper-2020-05-15.zip 18KB | |
php-readme-helper-2020-05-15.tar.gz 14KB | |
Install with Composer |
Needed packages | ||
Class | Download | Why it is needed | Dependency |
---|---|---|---|
Simple PHP Code Parser | .zip .tar.gz | the code parser is needed to get the informations from the php files | Required |
Version Control | Unique User Downloads | Download Rankings | |||||||||||||||
100% |
|
|
Applications that use this package |
If you know an application of this package, send a message to the author to add a link here.