anandpilania/laravel-docs

Docs reader for laravel.

laravel-docs

Docs reader for laravel, currently supported extensions is: .md Helpful to use it as knowledge base or faq of your project or features., _(*1)

Features

• Render .md docs
• Security: Configure access
• You can request/suggest more features

How to use

• Install:, _(*2)

  • git : git clone https://github.com/AnandPilania/laravel-docs.git

  • composer : composer install anandpilania/laravel-docs, _(*3)

  • Register Provider to config/app.php :, _(*4)

  • AP\Docs\ServiceProvider::class

  Instead of Facade, I used Contract, so Docs can be directly accessible to any class., _(*5)

• Publish the config and resources:, _(*6)

  • php artisan vendor:publish

• Configure package according to your need (app/docs.php):, _(*7)

  • disk.root => Root path of all documents (by default: storage/app/docs)

  http : Responsible for default routes, _(*8)

  • prefix => Route prefix (default: /docs)
  • middleware => By default, web is used as a middleware group

  default' : This section responsible for rendering the defaultdoc`, _(*9)

  • vendor => Default: storage/app/docs/laravel
  • version => Default: 5.4
  • page => Load default (installation) file while accessing //HOSTNAME/docs/laravel/5.4.
  • index => Default index file
  • extension => Currently this package supports only .md, so don't change it.

  security : Limit the access of docs, _(*10)

  • enabled => Its up to you, to enable this feature or not. true||false
  • file => Configure the file name of security according to your wish. default security.json Add this security.file to the vendor directory.

  extensions :, _(*11)

  • supported => Add extensions those are supported for render (currently .md), remaning extensions will excluded
  • excluded => Files containing these extensions will not displayed in the list

• Sample security.json (ex: /storage/docs/app/laravel/security.json):, _(*12)

  { "roles": ["users"], "permissions": ["docs.show.versions"] }, _(*13)

NOTE: Default route are hard-coded to the ServiceProvider file of the package.