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

shalvah 81b565549a Migrate to travis-ci.com 5 yıl önce
.github 78aca42f1a Update pull_request_template.md 5 yıl önce
config 90d00e0081 Resolves #22 - Set the correct config key for documentation URL 5 yıl önce
docs d4b250f58d Update docs 5 yıl önce
resources d442641b4b Fix bug with fetching pagination type for API Resources 5 yıl önce
routes 0d3df3ac45 Refactor Laravel type to use /docs for routing by default, rather than /doc. 5 yıl önce
src ccce82cf75 Set badge colour for OPTIONS method too 5 yıl önce
tests 72902cbba9 Add GetFromHeaderTag strategy in the default config 5 yıl önce
.editorconfig 24d3f6aa22 Add some dotfiles 9 yıl önce
.gitattributes 6e60d14ea2 Make bodyParam parsing more rbust 6 yıl önce
.gitignore a81b4a86b9 Refactor tests 5 yıl önce
.styleci.yml 385fbc7ba0 Fix style 5 yıl önce
.travis.yml 9da8c80421 Fix lint 5 yıl önce
CHANGELOG.0-1.md 627ba652e9 Update changelog 5 yıl önce
CHANGELOG.md 8308ac14c5 Update CHANGELOG.md 5 yıl önce
CONTRIBUTING.md 6457ea46f4 Add contribution guide 5 yıl önce
LICENSE.md 0e25996b83 Initial commit 9 yıl önce
README.md 81b565549a Migrate to travis-ci.com 5 yıl önce
composer.dingo.json 6721694c27 Update deps 5 yıl önce
composer.json 6721694c27 Update deps 5 yıl önce
logo-scribe.png 908fd36b04 Update doc 5 yıl önce
phpstan.neon d854a593c1 Extend no overwrite feature to all standard markdown files, not just routes. 5 yıl önce
phpunit.xml a81b4a86b9 Refactor tests 5 yıl önce
todo.md 6b32e2880f Add file upload support to Python example requests 5 yıl önce

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.