Skip to content

glorious-codes/glorious-pitsby

Folders and files

NameName
Last commit message
Last commit date

Latest commit

dbe41c5 · May 31, 2024
Aug 5, 2022
Jul 7, 2023
May 31, 2024
Jul 27, 2022
Nov 17, 2018
Aug 17, 2023
Aug 4, 2022
Oct 21, 2018
Nov 25, 2022
Nov 10, 2023
Nov 18, 2023
May 31, 2024
May 31, 2024
Aug 5, 2022
Aug 5, 2022
Aug 5, 2022
Jul 29, 2022
Aug 4, 2022
Aug 4, 2022
Aug 4, 2022
Jul 27, 2022

Repository files navigation

Pitsby

Docs generator for AngularJS, React, Vue and Vanilla components.

CircleCI Coverage Status

Installation

$ npm install @glorious/pitsby -g

Usage

Setup

Pitsby is based on two types of file:

  • Configuration File (pitsby.config.js)
    • Responsible for telling Pitsby where the documentation files are and for informing all the assets that should be included in the documentation.
  • Documentation File (eg. button.doc.js)
    • Used by Pitsby to build the page that contains all the component details.

Build

Since you have set up the pitsby.config.js for your project and, at least, one documentation file, you can easily generate the documentation running:

$ pitsby build

Once built, you can see the result serving the files just created using http-server or any other lib that you prefer:

$ http-server ./pitsby -p 7000

To keep Pitsby watching the changes that you make on any file listed on pitsby.config.js, run:

$ pitsby build --watch

Go to http://localhost:7000 and see the documentation that has been just created.

Contributions

If you are interested in contributing to this project, refer to the Contributing Steps.