schmunk42/yii2-markdocs-module

将本地文件夹中的markdown文件渲染为视图

安装次数: 56,244

依赖者: 1

建议者: 0

安全: 0

星标: 8

关注者: 4

分支: 4

公开问题: 0

类型:yii2-extension

1.1.0 2023-02-27 15:08 UTC

README

在视图中渲染从URL或本地文件中的markdown文件。

您可以选择以自定义主题优雅地显示在线GitHub仓库的文档。或者从本地文件提供后端应用程序文档。

需求

  • 已配置 pheme/yii2-settings 模块和组件
  • 已配置 RBAC 访问控制,权限: docs_default

安装

安装此扩展的首选方法是通过 composer

运行

composer require schmunk42/yii2-markdocs-module "*"

配置

用法

配置

通过 设置 模块

部分: <module-id>

  • markdownUrl
  • forkUrl
  • defaultIndexFile
  • cachingTime

键也可以用模式键前缀,例如 guide.markdownUrl,并通过URL参数 docs/?schema=guide 选择,这样您可以在单个模块中包含多个文档。

渲染Markdown markdocs/default

可以渲染本地文件或URL中的原始数据。

渲染API文档 markdocs/html

dmstr/phd5-app 的示例命令

$ php -dmemory_limit=512M vendor/bin/apidoc api \
    --template=online \
    --exclude=yiisoft,Test,Tests,test,tests,ezyang,phpdocumentor,nikic,php_codesniffer,phptidy,php-cs-fixer,faker \
    src/,vendor/ \
    runtime/html

dmstr logodmstr 构建