/css-documenation-generator

css-documenation-generator is a tool that automatically generates documentation for CSS files based on the code in the css file.

Primary LanguageTypeScriptOtherNOASSERTION

css-documenation-generator

Licence Version build status code style: prettier

css-documenation-generator is a tool that automatically generates documentation for CSS files based on the code in the css file. It is written in TypeScript. Please take a look to the licence before using it.

Prerequisites

This project requires NodeJS (version >= 14.0.0) and NPM. NodeJS and NPM are very easy to install. To make sure you have them available, you can try running the following command:

npm -v && node -v

Installation

npm install css-documenation-generator

Quick start

After installation you can import the package with in your JavaScript or TypeScript file:

import { generateCssDocs } from 'css-documenation-generator/build/lib/cssDocumentationGenerator';

To generate the documentation you can use the following function:

generateCssDocs(inputPaths: string[], outputPath: string)

The inputPaths parameter is an array of paths to the CSS files you want to generate the documentation for. The outputPath parameter is the path to the directory where the documentation will be saved. Both need to be absolute paths.

The function returns a StatusObject which contains the following properties:

status: Status
message?: string

You can find information about the Status type here

Commands

  • npm run dev: Starts the TypeScript compiler in watch mode.
  • npm run build: Starts the TypeScript compiler in build mode.

Bug reports

Have you found a bug? Please open an issue.