Scribe可以帮助您自动生成文档，但是如果您真的想制作友好，可维护和可测试的API文档，则还需要了解更多信息。所以我为你做了一门课程。🤗
Shalvah
9cbfc43fc7
Add `--dev` flag to require command
|
%!s(int64=5) %!d(string=hai) anos | |
|---|---|---|
| config | %!s(int64=5) %!d(string=hai) anos | |
| docs | %!s(int64=5) %!d(string=hai) anos | |
| resources | %!s(int64=5) %!d(string=hai) anos | |
| routes | %!s(int64=5) %!d(string=hai) anos | |
| src | %!s(int64=5) %!d(string=hai) anos | |
| tests | %!s(int64=5) %!d(string=hai) anos | |
| .editorconfig | %!s(int64=9) %!d(string=hai) anos | |
| .gitattributes | %!s(int64=6) %!d(string=hai) anos | |
| .gitignore | %!s(int64=5) %!d(string=hai) anos | |
| .styleci.yml | %!s(int64=5) %!d(string=hai) anos | |
| .travis.yml | %!s(int64=5) %!d(string=hai) anos | |
| CHANGELOG.md | %!s(int64=5) %!d(string=hai) anos | |
| CONTRIBUTING.md | %!s(int64=5) %!d(string=hai) anos | |
| LICENSE.md | %!s(int64=9) %!d(string=hai) anos | |
| README.md | %!s(int64=5) %!d(string=hai) anos | |
| composer.dingo.json | %!s(int64=5) %!d(string=hai) anos | |
| composer.json | %!s(int64=5) %!d(string=hai) anos | |
| logo-scribe.png | %!s(int64=5) %!d(string=hai) anos | |
| phpstan.neon | %!s(int64=5) %!d(string=hai) anos | |
| phpunit.xml | %!s(int64=5) %!d(string=hai) anos | |
| todo.md | %!s(int64=5) %!d(string=hai) anos |
README.md
Scribe
Generate API documentation for humans from your Laravel codebase. Here's what the output looks like.
Installation
PHP 7.2.5 and Laravel/Lumen 5.8 or higher are required.
composer require --dev knuckleswtf/scribe
Laravel
Publish the config file by running:
php artisan vendor:publish --provider="Knuckles\Scribe\ScribeServiceProvider" --tag=scribe-config
This will create a scribe.php file in your config folder.
Lumen
- When using Lumen, you will need to run
composer require knuckleswtf/scribeinstead. - Register the service provider in your
bootstrap/app.php:
$app->register(\Knuckles\Scribe\ScribeServiceProvider::class);
- Copy the config file from
vendor/knuckleswtf/scribe/config/scribe.phpto your project asconfig/scribe.php. Then add to yourbootstrap/app.php:
$app->configure('scribe');
Documentation
Check out the documentation at ReadTheDocs. Don't forget to check out the migration guide if you're coming from mpociot/laravel-apidoc-generator.
To learn how to contribute, see our contribution guide.