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

shalvah 627ba652e9 Update changelog il y a 5 ans
.github 9b4ff52c73 Update issue templates il y a 5 ans
config 90d00e0081 Resolves #22 - Set the correct config key for documentation URL il y a 5 ans
docs d8a1e1713b Update doc il y a 5 ans
resources d442641b4b Fix bug with fetching pagination type for API Resources il y a 5 ans
routes 0d3df3ac45 Refactor Laravel type to use /docs for routing by default, rather than /doc. il y a 5 ans
src 72902cbba9 Add GetFromHeaderTag strategy in the default config il y a 5 ans
tests 72902cbba9 Add GetFromHeaderTag strategy in the default config il y a 5 ans
.editorconfig 24d3f6aa22 Add some dotfiles il y a 9 ans
.gitattributes 6e60d14ea2 Make bodyParam parsing more rbust il y a 6 ans
.gitignore a81b4a86b9 Refactor tests il y a 5 ans
.styleci.yml 385fbc7ba0 Fix style il y a 5 ans
.travis.yml 9da8c80421 Fix lint il y a 5 ans
CHANGELOG.0-1.md 627ba652e9 Update changelog il y a 5 ans
CHANGELOG.md 627ba652e9 Update changelog il y a 5 ans
CONTRIBUTING.md 6457ea46f4 Add contribution guide il y a 5 ans
LICENSE.md 0e25996b83 Initial commit il y a 9 ans
README.md 908fd36b04 Update doc il y a 5 ans
composer.dingo.json 286c39bf16 Fix tests il y a 5 ans
composer.json e22c9f6528 Update deps il y a 5 ans
logo-scribe.png 908fd36b04 Update doc il y a 5 ans
phpstan.neon d854a593c1 Extend no overwrite feature to all standard markdown files, not just routes. il y a 5 ans
phpunit.xml a81b4a86b9 Refactor tests il y a 5 ans
todo.md 6b32e2880f Add file upload support to Python example requests il y a 5 ans

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.