laravel - 在 Laravel 项目中使用 Vuepress

Question

我实际上正在运行一个 Laravel 网站，我想在其中运行 Vuepress 文档部分。

根据说明，安装 Vuepress 非常简单，开发服务器也是如此。

但是，当谈到将其集成为静态站点时，我对与 Laravel 的交互感到有点迷失。

我的所有文档都位于我的 Laravel 应用程序根目录下的 docs 文件夹中。

我设法设置 Vuepress 的 config.js 将静态站点构建到另一个文件夹中。

base: '/docs/',
dest:'./public/docs',

执行上述操作后，文档将完全暴露在网络上(在公共(public)文件夹中)。

但是，我想要的是将其更精确地集成到 Laravel 中(使用我创建的中间件和路由)。

Answer 1

方法1

1。在 Laravel 目录的 /docs 中安装 vuepress

2。使用正确的 base 和 dest

配置 vuepress

/docs/.vuepress/config.js

module.exports = {
  dest: 'public/docs',
  base: 'docs/',
};

3。启用 laravel View 以包含 /public 目录

中的文件

/app/config/view.php

...
'paths' => [
    resource_path('views'),
    base_path('public'), // now blade's @include will also look in /public
],
...

4。为 vuepress 创建一个允许 .html 扩展名

的 laravel 路由

/routes/web.php

use View;
Route::get('/docs', function() {
  View::addExtension('html', 'php'); // allows .html
  return view('docs.index'); // loads /public/docs/index.html
});

方法2

或者为了通过 Laravel 对资源进行更多控制，您可以在这里尝试本教程:https://serversideup.net/vuepress-within-a-laravel-application/