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

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

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.