[扩展推荐] LaRecipe: 在你的 Laravel 项目中添加 Markdown 文档功能

文章转发自专业的Laravel开发者社区，原始连接：learnku.com/laravel/t/1…

LaRecipe 是由 Saleem Hadad 建立的一个扩展包，它提供了一种在 Laravel 应用程序内使用 Markdown 语法为你的产品或应用程序建立精美文档的简便方法。

要开始使用它，须要经过 composer 安装并运行安装命令以发布必要的文件和配置：

php artisan larecipe:install

复制代码

开箱即用，LaRecipe 会将你的文档置于 /docs URL 下，你能够在应用旁边对文档进行版本控制。典型的安装目录结构以下：

├─ config
│  └─ larecipe.php
└─ resources
   └─ docs
      │─ 1.0
      │  │─ index.md
      │  └─ overview.md
      └─ 2.0
         │─ index.md
         └─ overview.md

复制代码

上例中具备 /docs/1.0 到 /docs/2.0的路由。你能够自定义基础路由，文档文件位置，以及登陆页。例如，将 landing 配置项设置为  overview 会把登陆页指向 overview.md。

你能够按照以下配置去设置和控制文档的默认以及发布版本:

return [
    'versions'      => [
        'default'   => '1.0',
        'published' => [
            '1.0'
        ]
    ]
];

复制代码

你也能从 配置文档 和 PHP 配置文件 中了解到更多的 LaRecipe 配置项.

LaRecipe 将你的 markdown 文档转换成 HTML, 同时也支持可选的 Vue 组件. 你能够从 Vue 支持组件 文档中了解更多. 同时它还包含一些开箱即用的 Vue 组件，例如卡片、按钮、徽章以及进度条等.

你能够经过阅读 LaRecipe 文档 来开始 LaRecipe . 它的 GitHub 源代码仓库在这里 .