# http-server-md-template-blank

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

README & DOCS TODO

Installation

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

| Param | Type | Default | Description | | --- | --- | --- | --- | | [userConfig] | Sermit~Config | {} | provided configuration |

genImageMarkdown(params) ⇒ string

Generate a markdown string to display an image at relPath.

Kind: global function
Returns: string - md

| Param | Type | Description | | --- | --- | --- | | params | object | params | | params.relPath | string | path relative to content root path. | | params.name | string | image alt text. |

genRawSrcMarkdown(params) ⇒ string

Generate a markdown string to render raw file contents.

Kind: global function
Returns: string - md

| Param | Type | Description | | --- | --- | --- | | params | object | params | | params.srcPath | string | path to file, resolvable locally via fs |

renderPageDirectory(templateConfig) ⇒ Sermit~Renderer

Directory listing renderer.

Kind: global function
Returns: Sermit~Renderer - renderer

| Param | Type | Description | | --- | --- | --- | | templateConfig | Config | template config data. |

renderPageFile(templateConfig) ⇒ Sermit~FileRenderer

Single file renderer.

Kind: global function
Returns: Sermit~FileRenderer - renderer

| Param | Type | Description | | --- | --- | --- | | templateConfig | Config | template config data. |