Skip to content

Rollup plugin to generate markdown documentation from Vue.js component source with @vuedoc/md.

License

Notifications You must be signed in to change notification settings

h-ikeda/rollup-plugin-vuedoc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

rollup-plugin-vuedoc

Rollup plugin to generate markdown documentation from Vue.js component source with @vuedoc/md.

NPM
Node CI

Usage

  1. Install the plugin.
    npm i -D rollup-plugin-vuedoc
  2. Edit the config file to use the plugin.
    // rollup.config.js
    
    import vuedoc from 'rollup-plugin-vuedoc';
    
    export default {
      input: 'path/to/entry-point.js',
      ...generalConfigurations,
      plugins: [
        vuedoc({ test: /\.vue$/, prefix: 'docs' }),
        ...otherPlugins,
      ],
    };
  3. Run rollup.
  4. Markdown files will be created in the asset path.

Options

test

Generate markdown files only if the module ID matches the test. Can be a string, RegExp, or an array of them.

prefix

Path prefix for generated markdown files. Files will be put at <asset path>/<prefix>/<module's relative path>

intro/outro

String to be prepended before or appended after generated markdown strings. Can be a string or a function. Function will be called with an argument object including id of the module.

export default {
  ...generalConfigs,
  plugins: [
    vuedoc({ intro: ({ id }) => `id` }),
    ...otherPlugins,
  ],
};

// Generates markdown files starting with module's ID string.

index

If true, generate indix markdowns containing a directory name string as the title at each directory under the prefix path. If function is given, returning string will be the content of the index. Functions are called with a directory path.

replace

Replaces substrings of generated markdown strings. test property and replacement property of the replace object will be passed to String.prototype.replace() function.

export default {
  ...generalConfigs,
  plugins: [
    vuedoc({ replace: { test: /to be replaced/g, replacement: 'replaced' }),
    ...otherPlugins,
  ],
};

// String.prototype.replace(/to be replaced/g, 'replaced') will be applied.

About

Rollup plugin to generate markdown documentation from Vue.js component source with @vuedoc/md.

Resources

License

Stars

Watchers

Forks

Packages

No packages published