微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

如何在Laravel的网页中显示README.md?

如何解决如何在Laravel的网页中显示README.md?

我有一个laravel项目,在根目录中有一个README.md。推送到GitHub后,我可以看到渲染结果,但是我想在本地开发浏览器中渲染markdown文档。

我正在尝试两种方法

  1. 从markdown文件读取文件
  2. 使用Webpack等将markdown文件转换为html

谁可以为此演示?

解决方法

这是Laravel Mix / Webpack解决方案,将markdown文件转换为html,在Vue.js中是必需的,然后用v-html显示。

首先添加markdown-loader

yarn add markdown-loader html-loader

webpack.mix.js中添加配置,Laravel Mix可以添加Webpack的自定义配置。

mix.webpackConfig({
  module: {
    rules: [{
      test: /\.md$/,use: ["html-loader","markdown-loader"],}]
  }
});

考虑到README.md在Project的根目录中,请在webpack.mix.js中添加一个别名

mix.alias({
  '@': '/resources/js','@root': '/',});

现在,我们可以使用vue组件在根目录下显示README.md。

<script>
const readme = require('@root/README.md')
export default {
  data() {
    return {
      readme: ""
    }
  },created() {
    this.readme = readme
  }
}
</script>

<template>
  <div class="container" ref="container" v-html="readme" />
</template>
,

由于邮件刀片模板解析 markdown,您可以使用与 layout.blade.php 类似的方法,它使用 Illuminate\Mail\Markdown::parse。

在您的模板中,例如welcome.blade.php,添加:

{{ Illuminate\Mail\Markdown::parse(file_get_contents(base_path() . '/README.md')) }}

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。