Skip to content

A mkdocs plugin that scans specified directories and files for JSON Schema files, converts them to markdown and builds them into your documentation.

Notifications You must be signed in to change notification settings

magicaljellybeans/mkdocs_schema_reader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mkdocs schema reader plugin

This is a plugin that scans the specified directories and files for JSON Schema files, converts them to markdown and builds them into your documentation.

Setup

Install the plugin using pip:

pip install mkdocs-schema-reader

Activate the plugin in mkdocs.yml:

plugins:
  - search
  - schema_reader

Then, specify folders and files that you want to include in mkdocs.yml relative to it's location, like so:

plugins:
  - search
  - schema_reader:
      include: 
        - "../JSONSchema/"
        - "../example/directory/schema.json"

Specified directories will be scanned for schema json files, so consider specifying individual files for expansive directories.

Note: If you have no plugins entry in your config file yet, you'll likely also want to add the search plugin. MkDocs enables it by default if there is no plugins entry set, but now you have to enable it explicitly.

More information about plugins in the [MkDocs documentation][mkdocs-plugins].

Usage

Just activate the plugin, specify directories and files in the manner shown above, and it will operate when normal mkdocs commands are used like `mkdocs serve'

About

A mkdocs plugin that scans specified directories and files for JSON Schema files, converts them to markdown and builds them into your documentation.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages