快速查看 Laravel 已安装 Packages 的 Readme 文档小工具

Coding的时候,经常需要查阅各个Package的文档。在以前,去每个Package的官网查找各自的文档,比较麻烦。所以我做了一个小工具,可以把所有Packages的文档放在一个页面里面查阅,欢迎各位品尝。

预览

Packages Readmes Viewer

原理

  • 每个Package在其安装目录下都会有一个README.MD文件;
  • 首先读取composer.json,获取require和require-dev的Package列表;
  • 读取README.MD文件,并由Markdown转化为Html;
  • 使用了GithubMarkdown以及GithubMarkdownCSS。

安装方法

使用composer安装至dev环境:

composer require --dev seekerliu/packagesreadmes

注册ServiceProvider至本地环境:

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

使用方法

现在你就可以通过下面的Url来查看所有Packages的Readme文档了:

http://yoursite.app/readme

自定义路由

如果你需要自定义路由,需要先publish配置文件:

php artisan vendor:publish --tag=readme

然后编辑 '/config/readme.php'中的route部分:

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

即可修改路由。

项目源码

https://github.com/seekerliu/packagesreadm...

原创。 所有 Laravel 文章均已收录至 Github laravel-tips 项目。
Ίκαρος
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
讨论数量: 2
leo

建议route可配

8年前 评论
Ίκαρος

@leo 已更新,可以自定义路由 :smile:

8年前 评论

讨论应以学习和精进为目的。请勿发布不友善或者负能量的内容,与人为善,比聪明更重要!