README

一个易于使用的Laravel产品文档包。

Docweaver适用于产品文档和/或知识库。将.md文件文件夹转换为完整的文档。Docweaver受到Laravel自身文档的启发。

关键特性

Docweaver提供以下功能和更多功能。

• 多产品支持
  • Docweaver默认支持多个产品。只需创建您的产品文件夹并将文档版本目录放入其中。
• 即插即用
  • 只需安装和配置，一切就绪！（约2分钟）

安装 & 使用

安装

通过composer安装；在控制台

composer require reliqarts/laravel-docweaver

或在composer.json中要求

{
    "require": {
        "reliqarts/laravel-docweaver": "^2.0"
    }
}

然后，在终端中运行composer update将其拉入。

完成后，您需要在app.php配置文件中的提供者数组中添加服务提供者，如下所示：（注意：此包支持Laravel的包自动发现；如果您使用的是Laravel 5.5或更高版本，则可以跳过此步骤。）

ReliqArts\Docweaver\ServiceProvider::class,

确保您的应用程序公共存储目录已链接并通过浏览器可访问。

php artisan storage:link

查看：https://laravel.net.cn/docs/master/filesystem

最后，发布包资源和配置

php artisan vendor:publish --provider="ReliqArts\Docweaver\ServiceProvider"

您可以选择只发布配置，使用docweaver-config标签

php artisan vendor:publish --provider="ReliqArts\Docweaver\ServiceProvider" --tag="docweaver-config"

设置

设置所需的环境变量，以便包知道您的图像模型、控制器等。

示例环境配置

DOCWEAVER_ROUTE_PREFIX=docs
DOCWEAVER_DIR=resources/docs

这些变量以及更多在config文件中有解释。

文档目录

文档目录是放置您的项目文档目录的地方。它可以使用配置密钥docweaver.storage.dir或环境变量DOCWEAVER_DIR进行更改。默认文档目录是resources/docs。

结构

每个项目目录应包含为每个文档版本单独的文件夹。每个版本至少必须有两个（2）Markdown文件，即documentation.md和installation.md，分别用作侧边栏和初始文档页面。

[doc dir]
    │
    └─── Project One
    │       └── 1.0 
    │       └── 2.1
    │            └── .docweaver.yml       # meta file (optional)
    │            └── documentation.md     # sidebar nav
    │            └── installation.md      # initial page
    │
    └─── Project Two

元文件

每个文档版本的配置可以放在.docweaver.yml中。支持的设置有

• name

  产品名称。

• description

  产品描述。

• image_url

  产品图片URL。这可以是一个绝对URL（例如，http://mywebsite.com/myimage.jpg）或在images资源目录中找到的图片。

  要使用在images目录中的foo.jpg，您需要将image_url设置为{{docs}}/images/foo.jpg。

  更多信息请参见：资产

致谢

此包受到Laravel的文档的启发，并使用其底层机制作为基础。