'doctron' (jsDoc template) - Responsive jsDoc template. (based in default template)
Author: Juan José Guerra Haba - dinertron@gmail.com - 2016 April
License: Open GPL v.3. Keep credit, please.
Versión: 1.0.0
Folder: doctron

DOCTRON TEMPLATE

Responsive jsDoc template. (based in default template)

DESCRIPTION

The doctron is a 'jsDoc' template. It is based in Default template.

This template has been given a more updated and modern touch, respecting standards and minified some files to load (were deleted the added fonts). It will has incorporated some new features to enhance functionality. It is more versatile than its predecessor by incorporating more configuration options, thus increasing the customization possibility. Now different style themes can be selected, it allows enable 'debug zones' (very useful for developers), responsive design for different screen types and devices, ... and more.

FEATURES

The doctron template is based in 'Default template', but I adding it a few features for enhanced it.

This template not requery any additional fonts.
Responsive design.
HTML5 valid.
'debug zone': It allow to developers check the variables and configuration options.
'toTop' button.
'change Theme' button.
Design new look.
Less size.

OPTIONS

This options for configuration they may be included in jsDoc.conf.json configuration file within the 'templates' section, thus the path will be more or less:

jsDoc.conf.json {..., templates: { ... }, ...}

debug : [boolean] Allow enabled the debug-zone
logoFile : [string] Let the relative path to logo image (png, jpg, gif)
logoLink : [string] Logo as link to any site
theme : [string] The name of style theme (light or dark)
totop : [boolean] To Top button.
changeTheme : [boolean] A select box to change the theme.
responsive : [boolean] Allow show a responsive design to different screen types and devices
author : [string] By example a link to author email, on 'footer'. The footer section must be enabled
copyright : [string] A string representing the copyright
meta : [object] A javascript object indicating some HTML meta-tags:
- title : [string] It is the page title
- description : [string] The page description, very useful for SEO and search engines
- keywords : [string] Like the above, it is used with SEO
- charset : [string] The page charset: utf-8, ascii, utf-16, ...
- language : [string] The page natural language: es, en, ...

These options could be as follows in a configuration file sample JSDoc :

{
  ...,
  "templates" : {
    ...,
    "debug"       : true,
    "logoFile"    : "img/wrapperTracer-logo.png",
    "logoLink"    : "http://guerratron.github.io/WrapperTracer",
    "responsive"  : true,
    "author"      : "<a href='mailto:dinertron@gmail.com' title='author'>GuerraTron</a>",
    "footer"      : true,
    "copyright"   :  "2016 (c) Juan Jose Guerra Haba",
    "theme"       : "lighter",
    "changeTheme" : true,
    "totop"       : false,
    "meta"        : {
      "title"       : "WrapperTracer :: Rastreo de Objetos JS - by GUERRATRON",
      "description" : "WrapperTracer :: Rastreo de Objetos JS and its methods traits - by GUERRATRON",
      "keywords"    : "wrappertracer,js,code,debug,trait,traits,trace,tracer,wrapper,guerratron",
      "charset"     : "utf-8",
      "language"    : "es"
    },
    ...
  },
  ...
}

INSTALATION

Copy the 'doctron folder' to 'jsDoc/templates path'. By example, in Windows:

C:\Program Files\nodejs\node_modules\jsdoc\templates

INHERITED

The default template for JSDoc 3 uses: the Taffy Database library and the Underscore Template library.