Skip to content
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
demo fix: "@hideconstructor" Jul 31, 2017
static fix: Collapsibles, Tab-names Jan 21, 2017
tmpl fix: "@hideconstructor" Jul 31, 2017
.editorconfig Add .editorconfig and .gitattributes Nov 11, 2016
.gitattributes
.gitignore feat: initial commit - v1.0.0 Nov 7, 2016
LICENSE feat: initial commit - v1.0.0 Nov 7, 2016
README.md fix typo Nov 23, 2018
gulpfile.js feat: "useCollapsibles" option (#23) Jan 15, 2017
package-lock.json
package.json 1.2.2 Jul 31, 2017
publish.js Revert "Fix issue #29 - Problem on fs.copyFileSync when publishing fi… Sep 22, 2017

README.md

TUI JSDoc Template

Toast UI JSDoc template

Demo: https://nhnent.github.io/tui.jsdoc-template/latest/

Install

npm i -D tui-jsdoc-template

Feature

TUI JSDoc template has the following features:

  • Navigation:
    • AutoComplete Searchbox
    • Collapsible
    • Members / Methods / Events
    • API / Examples (Tutorials) switcher
    • Resizable
  • Examples: HTML/JS source tab in example pages

Example

Configuration

(jsdoc page - configuration)

Template

"opts": {
    "template": "node_modules/tui-jsdoc-template"
}

Logo

"templates": {
    "logo": {
        "url": "http://nhnent.github.io/tui.component.tree/latest/styles/logo.png",
        "width": "150px",
        "height": "13px",
        "link": "https://github.com/nhnent/tui.jsdoc-template"
    }
}

Page title

"templates": {
    "name": "Tui JSDoc Template"
}

Footer text

"templates": {
    "footerText": "My awesome footer text"
}

Use collapsible api list

Default: true

"templates": {
    "useCollapsibles": true
}

Tab Names

"templates": {
    "tabNames": {
        "api": "API",
        "tutorials": "Examples"
    }
}

api defaults to the value API and tutorials defaults to the value Examples.

Custom Styles

With a folder structure like this:

static
└── styles
    └── custom.css
    └── another.css

And a config like this:

"templates": {
    "default": {
        "staticFiles": {
            "include": ["static/"]
        }
    },
    "css": [
        "styles/custom.css",
        "styles/another.css",
        "http://example.com/remote.css"
    ]
}

styles/custom.css, styles/another.css, and remote.css get included in the layout. default.staticFiles is the build-in jsdoc way of copying extra files.

Expose the html/js code to example page

If script or div elements have code-js or code-html class, expose their innerHTML.

  1. innerHTML of script.code-js tag
  2. innerHTML of div.code-html tag
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>example</title>
</head>
<body>
    <div class="code-html">
        <h3> Base Example </h3>
        <p> Hello world </p>
    </div>

    <script class="code-js">
        console.log('hello world');
    </script>
</body>
</html>

Development

  1. Use npm run serve or gulp serve command to ascertain realtime.
  2. Api-Example tab, Auto-Complete and Resize functions are written in the static/scripts/tui-doc.js file.
You can’t perform that action at this time.