1.2.0 • Published 3 months ago

http-server-md-template-blank v1.2.0

Weekly downloads
-
License
MIT
Repository
github
Last release
3 months ago

# http-server-md-template-blank

NPM Version Build Status Downloads Stats

Blank template skeleton for http-server-md, used to populate new template modules by sermit init-template.

README & DOCS TODO

Installation

npm badge

pnpm add http-server-md-template-blank

Developing

pnpm gen-readme // update README.md
pnpm docs // update DOCUMENTATION.md
pnpm test // lint & mocha
pnpm update-deps // bump all deps

Release History

See CHANGELOG.md for more information.

License

Distributed under the MIT license. See LICENSE.md for more information.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

API Reference

The standalone JSDoc reference can be found in DOCUMENTATION.md

Modules

Constants

Functions

http-server-md-template-blank

Blank template skeleton for http-server-md, serving as a reference for the required structure.

Used by the sermit CLI app to create an empty template repo via the init-template command.

License: MIT

ASSETS_BUILD_PATH

Artifacts are stored in & resolved from the public/ folder within the project root by default.

Kind: global constant

ASSETS

Static asset (files & folders) definition. Sources prefixed with ~ are resolved with requireDynamicModule.

{ 'dest/path': 'src/path' }

Kind: global constant

STYLES_BUILD_PATH

Artifacts are stored in & resolved from the public/ folder within the project root by default.

Kind: global constant

STYLES

SCSS style definition, { dest: src }

Kind: global constant

NAME

Unique name to identify template; should form the package name when prefixed with http-server-md-template-.

Kind: global constant

PUBLIC_PATH

Absolute path to rendered resources folder, ready for serving.

Kind: global constant

INCLUDE_PATH

Nunjucks templates are in res/templates within the template root by default.

Kind: global constant

TEMPLATE

Recommended filename

Kind: global constant

TEMPLATE

Recommended filename

Kind: global constant

getConfig(userConfig) ⇒ Sermit~Config

Combine the provided & default configurations as-needed.

Kind: global function
Returns: Sermit~Config - config

ParamTypeDefaultDescription
userConfigSermit~Config{}provided configuration

genImageMarkdown(params) ⇒ string

Generate a markdown string to display an image at relPath.

Kind: global function
Returns: string - md

ParamTypeDescription
paramsobjectparams
params.relPathstringpath relative to content root path.
params.namestringimage alt text.

genRawSrcMarkdown(params) ⇒ string

Generate a markdown string to render raw file contents.

Kind: global function
Returns: string - md

ParamTypeDescription
paramsobjectparams
params.srcPathstringpath to file, resolvable locally via fs

renderPageDirectory(templateConfig) ⇒ Sermit~Renderer

Directory listing renderer.

Kind: global function
Returns: Sermit~Renderer - renderer

ParamTypeDescription
templateConfigConfigtemplate config data.

renderPageFile(templateConfig) ⇒ Sermit~FileRenderer

Single file renderer.

Kind: global function
Returns: Sermit~FileRenderer - renderer

ParamTypeDescription
templateConfigConfigtemplate config data.