Scribe可以帮助您自动生成文档,但是如果您真的想制作友好,可维护和可测试的API文档,则还需要了解更多信息。所以我为你做了一门课程。🤗

shalvah 1f1b22ce72 Update docs hace 5 años
config 908fd36b04 Update doc hace 5 años
docs 1f1b22ce72 Update docs hace 5 años
resources 908fd36b04 Update doc hace 5 años
routes 0d3df3ac45 Refactor Laravel type to use /docs for routing by default, rather than /doc. hace 5 años
src 41460a2c2d Document FormRequests hace 5 años
tests 3f3c509317 Fix tests hace 5 años
.editorconfig 24d3f6aa22 Add some dotfiles hace 9 años
.gitattributes 6e60d14ea2 Make bodyParam parsing more rbust hace 6 años
.gitignore a81b4a86b9 Refactor tests hace 5 años
.styleci.yml 385fbc7ba0 Fix style hace 5 años
.travis.yml 9da8c80421 Fix lint hace 5 años
CHANGELOG.md 221018765b Fix tests hace 5 años
CONTRIBUTING.md 6457ea46f4 Add contribution guide hace 5 años
LICENSE.md 0e25996b83 Initial commit hace 9 años
README.md 908fd36b04 Update doc hace 5 años
composer.dingo.json 286c39bf16 Fix tests hace 5 años
composer.json 3e99d5b74f Update deps hace 5 años
logo-scribe.png 908fd36b04 Update doc hace 5 años
phpstan.neon f7407a5105 Fix lint, little fixes hace 5 años
phpunit.xml a81b4a86b9 Refactor tests hace 5 años
todo.md 1f1b22ce72 Update docs hace 5 años

README.md

Scribe


Generate API documentation for humans from your Laravel codebase. Here's what the output looks like.

Latest Stable Version Total Downloads Build Status

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/scribe instead.
  • 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.php to your project as config/scribe.php. Then add to your bootstrap/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.