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

shalvah a81b4a86b9 Refactor tests 5 년 전
config bb3d511133 Fix synax for 7.2 support 5 년 전
docs 2c730e0a1c Update index.md 5 년 전
resources b252f8bf7c Change auth badge to lowercase, fix lint 5 년 전
routes 277f3d1080 Rename project to Scribe 5 년 전
src dcf8c06828 fixed linter errors 5 년 전
tests a81b4a86b9 Refactor 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 d6100fcf5f Switch to clara for logging 5 년 전
CHANGELOG.md 221018765b Fix tests 5 년 전
CONTRIBUTING.md 4c87b21d29 Update CONTRIBUTING.md 6 년 전
LICENSE.md 0e25996b83 Initial commit 9 년 전
README.md 967e528531 Update README.md 5 년 전
body_params_1.png b7aad444e3 Update docs on urlParams 5 년 전
body_params_2.png b7aad444e3 Update docs on urlParams 5 년 전
composer.dingo.json 286c39bf16 Fix tests 5 년 전
composer.json 3e99d5b74f Update deps 5 년 전
phpstan.neon f7407a5105 Fix lint, little fixes 5 년 전
phpunit.xml a81b4a86b9 Refactor tests 5 년 전
todo.md 3eb73b80bc Update todo.md 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.