Git Product home page Git Product logo

docset-generator's Introduction

DocSet Generator

Generates a docSet from html documentation.

Installation

npm install docset-generator --save

Usage

var DocSetGenerator = require('docset-generator').DocSetGenerator;
var docSetGenerator = new DocSetGenerator(
  {
    destination: "/path/to/dir",
    name: "MyDocSet",
    documentation: "/path/to/html"
  });
docSetGenerator.create();

Options

The DocSetGenerator constructor takes one parameter: new DocSetGenerator(configuration)

The configuration parameter is an object with the following keys.

  • name: name of the docSet
  • documentation: path to the html documentation
  • destination: path to the directory in which you want to generate the docSet [optional, falls back to the documentation folder]
  • enableJavascript: boolean, enable Javascript in the generated docSet
  • entries: Entries that will populate the docSet database [optional]
  • icon: path to the docSet icon [optional]
  • index: path to the index page of your html documentation [optional, default to index.html]
  • platformFamily: will be used to fill the DocSetPlatformFamily attribute in the Info.plist file [optional, falls back to the name]
  • identifier: will be used to fill the DocSetIdentifier attribute in the Info.plist file [optional, falls back to the name]

Entries

The entries parameter is an array of entries that will populate the sqlite3 database that comes with the docset.

Structure

Array<{ name:string, type:string, path:string }>

The type has to be one of the supported entry types.

This parameter is optional but without any entries, you won't get a neat overview of your documentation (list of classes, namespaces, methods and whatever else may be useful to you). You can use jsdoc-docset to generate those entries from inside your jsdoc template.

docset-generator's People

Contributors

theasta avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

docset-generator's Issues

Dependency updates

Hi,
currently there are several security vulnerabilities due to outdated dependencies.

Updated sequelize to 5.8.2
and sqlite3 to 4.0.6
see jhotadhari@22d55f9

For me that works well, but maybe didn't test all features.

I removed lib from .gitignore later, that’s why I am not requesting to pull my fork.

Thanks, really appreciate

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.