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

file

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 源代码仓库在这里 .


Practice makes perfect.

原文地址:https://laravel-news.com/larecipe-docume...

译文地址:https://laravel-china.org/topics/17310

本帖已被设为精华帖!
《L04 微信小程序从零到发布》
从小程序个人账户申请开始,带你一步步进行开发一个微信小程序,直到提交微信控制台上线发布。
《L05 电商实战》
从零开发一个电商项目,功能包括电商后台、商品 & SKU 管理、购物车、订单管理、支付宝支付、微信支付、订单退款流程、优惠券等
讨论数量: 2

欸?怎么文章不全了?

2个月前
Summer

@wilson_yang fixed

2个月前

  • 请注意单词拼写,以及中英文排版,参考此页
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`, 更多语法请见这里 Markdown 语法
  • 支持表情,使用方法请见 Emoji 自动补全来咯,可用的 Emoji 请见 :metal: :point_right: Emoji 列表 :star: :sparkles:
  • 上传图片, 支持拖拽和剪切板黏贴上传, 格式限制 - jpg, png, gif
  • 发布框支持本地存储功能,会在内容变更时保存,「提交」按钮点击时清空
  请勿发布不友善或者负能量的内容。与人为善,比聪明更重要!