seekerliu / laravel-readme-viewer by seekerliu

Laravel 5 Packages's Readme File(Docs) Viewer

This package generates a html page that you can see all of your packages's readme file, So you no longer need to go to each package's homepage to find documents。

Preview

Install

Require this package with composer using the following command:

composer require seekerliu/laravel-readme-viewer

After updating composer, add the service provider to the providers array in config/app.php

Seekerliu\Readme\Providers\ReadmeServiceProvider::class,

To install this package on only development systems, add the --dev flag to your composer command:

composer require --dev seekerliu/laravel-readme-viewer

In Laravel, instead of adding the service provider in the config/app.php file, you can add the following code to your app/Providers/AppServiceProvider.php file, within the register() method:

public function register()
{
    if ($this->app->environment() == 'local') {
        $this->app->register('Seekerliu\Readme\Providers\ReadmeServiceProvider');
    }
    // ...
}

This will allow your application to load the Laravel 5 Packages's Readme File(Docs) Viewer on non-production enviroments.

Usage

You can now view all the docs of your packages in your browser by follow url.

http://yoursite.app/readme

Custom Route

If you need to custom route, you need to publish config file first

php artisan vendor:publish --tag=readme

Then you can change route in '/config/readme.php'

'route' => [
        'prefix' => '/readme/{packageName?}',
        'action' => 'Seekerliu\Readme\Controllers\ReadmeController@index',
        'name' => 'readme.index',
],

License

The Laravel 5 Packages's Readme File(Docs) Viewer is open-sourced software licensed under the MIT license