dte

documentation-theme-ecl

ECL documentation theme

Showing:

Popularity

Downloads/wk

3

GitHub Stars

0

Maintenance

Last Commit

3yrs ago

Contributors

0

Package

Dependencies

10

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

ECL theme for documentation.js

This is a custom theme for documentation.js: it consists of underscore templates and a few assets: a highlight.js theme and the base of ECL

Example documentation theme based on ECL

Options

The theme is ready to accept the following options from your configuration:

  • project-name
  • project-description
  • project-url

Usage

CLI

Use the documentation.js CLI

Example:

$ npx documentation build **/_types/*.js --theme . -f html -o example/app

Where the --theme flag should point to the module (index.js) of the theme.

Node API

See the html generation script for an example of the formats.html method as pointed out in the documentation pages.

Theme development

Requirements:

  • Node.js current (8.x recommended)
  • yarn or npm

There are a few npm script tasks which you can use:

  • develop:assets
  • develop:theme
  • develop:server

Order is important, so it's recommended you start a separate terminal session for each task.

Develop assets

Takes care of CSS and JavaScript assets.

  • Makes use of webpack CLI.
  • Automatically discovers configuration from webpack.config.js
  • Bundles assets to assets/bundle
  • Watches for changes.

Develop theme

Takes care of templates.

  • Makes use of documentationjs CLI.
  • Takes input of glob patterns where documentation should be extracted from.
  • Builds HTML from underscore templates and moves images, favicon and bundle folders into a target dist folder. Thus, ensure that assets are bundled before they are moved.
  • Watches for changes

Develop server

Delivers results to the browser and reloads on changes.

  • Makes use of reload CLI.
  • Takes input of dist folder where develop:theme stores its results.
  • Can optionally listen to different ports if necessary.
  • Serves dist folder as a static site
  • Reloads when there are changes in dist folder.

Maintenance notes

Please commit the results of develop:assets in assets/bundle. This simplifies the workflow of publishing them to npm. Raw/Source styles and scripts in assets/js and assets/styles are ignored and not published to npm.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial