Documentation Generation Generate structured documentation from specs book-open API Reference
Categories

Documentation Generation

Methods for generating documentation definitions with code examples from specs.

getDefinition()

Generates documentation definition with code examples. Returns structured object with types, states, variations, and working code examples for each.

Syntax

reader.getDefinition(options)

Parameters

NameTypeDefaultDescription
pluralbooleanthis.pluralGenerate plural definition
minUsageLevelnumberundefinedFilter by minimum usage level
dialectstringthis.dialectHTML dialect for examples

Returns

PropertyTypeDescription
contentArrayContent/slot examples
typesArrayType examples
statesArrayState examples
variationsArrayVariation examples
settingsArraySetting examples

Each array contains objects with:

PropertyTypeDescription
titlestringSection title
descriptionstringSection description
examplesArrayCode examples with component metadata

Usage

import { SpecReader } from '@semantic-ui/specs';
import buttonSpec from './button.spec.js';
const reader = new SpecReader(buttonSpec);
const definition = reader.getDefinition();
// Use for documentation generation
definition.variations.forEach(variation => {
console.log(variation.title);
variation.examples.forEach(example => {
console.log(example.code);
});
});
Previous
Spec Helpers
Next
Parsing HTML