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

Stylianos Panagakos 29c5aec3b8 add views publication doc support for Lumen il y a 4 ans
.github ad79a518c8 Update pull request template il y a 4 ans
config fc7161a08e Update docs for continue_without_database_transactions il y a 4 ans
docs 29c5aec3b8 add views publication doc support for Lumen il y a 4 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 fc7161a08e Update docs for continue_without_database_transactions il y a 4 ans
tests db1e559e22 Merge pull request #43 from chriserikhaugli/#40-Include-raw-in-requests.url il y a 4 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 7e588d52cf Update CHANGELOG.md il y a 4 ans
CONTRIBUTING.md 6457ea46f4 Add contribution guide il y a 5 ans
LICENSE.md 0e25996b83 Initial commit il y a 9 ans
README.md c668f3e9f9 Update README il y a 4 ans
composer.dingo.json 6721694c27 Update deps il y a 5 ans
composer.json 6721694c27 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

Documentation

Scribe is a fork of mpociot/laravel-apidoc-generator, so see the migration guide if you're coming from there.

Check out the documentation at ReadTheDocs.

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 (no --dev.
  • 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');

Contributing

Contributing is easy! See our contribution guide.