schmunk42/yii2-markdocs-module

Renders markdown files from local folder as views

yii2-markdocs-module

Renders markdown files from URLs or local files in views., _(*1)

You can either display the documentation of your online GitHub repo nicely rendered in a custom theme. Or provide application documention in the backend from local files., _(*2)

Requirements

• configured pheme/yii2-settings module and component
• configured RBAC access control, permission: docs_default

Installation

The preferred way to install this extension is through composer., _(*3)

Run, _(*4)

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

Configuration

Usage

Configuration

Via Settings module, _(*5)

Section: <module-id>, _(*6)

Keys, _(*7)

• markdownUrl
• forkUrl
• defaultIndexFile
• cachingTime

Keys can also be prefixed with a schema key, eg guide.markdownUrl and selected via URL parameter docs/?schema=guide, so you can include multiple documentations within a single module., _(*8)

Render Markdown markdocs/default

Can render local files or raw data from an URL., _(*9)

Render API documentation markdocs/html

Example command for dmstr/phd5-app, _(*10)

$ 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

Built by dmstr