template

Features

• simple web server
• easy to extend with API
• auto watch / build, recursive tree parsing
• as a module, but extensible.

Usage

install required modules

npm install --save @zbryikt/template

start server ( -r, -p and -c are optional ):

npx server -r <your-web-root> -c <your-server-config> -o <auto-open:true/false> -p <port>

you can also add following in your own package.json:

"scripts": {
    "start": "npx server"
},

optional server config json file specified via -c option for altering default port and other config:

{ "port": 3012 }

Port will be randomized unused port if not specified. For more about options, see the Options section below.

Start Kit

sample folder serves as a starting point to bootstrap a project. It contains following files:

• package.json: a simple package.json with necessary dependencies. You need to update repo info in this.
• LICENSE: default MIT.
• config.json: config file used by template.
• deploy: if you use gh-pages of github, this automatically push your static/ directory to gh-pages branch. you need to have a gh-pages branch at first.
• README.md: a dummy readme. edit it as necessary.
• src/: template style source code folder. check @plotdb/srcbuild for more information.
  • src/ls/: LiveScript code, built to static/js/
  • src/pug/: Pug code, built to static/
  • src/styl/: Stylus code, built to static/css/
• static/: generated files or other assets.
• locales/: i18n translation files based on i18next.

Custom API

run template with customized web api by manually initing server:

require("template")
template.server.init({
    api: function(server) {
        server.app.get("/custom-api", function(req, res) {
            return res.send("custom api response");
        });
    }
});

in this case you will have to watch source files manually:

template.watch.init({ ... });

Options

server.init accepts config with following options:

• port - port to listen. when omitted, random unused port is used.
• startTime - optional time for providing initialization elapsed time information.
• api - functions for customizing server. executed before server started
• open - true to open browser page when server starts. default false
• feroot - frontend root for serving static file and building view files. default ..
• i18n - i18n options including:
  • enabled - true if i18n is enabled. default true.
  • lng - list of locales. default ['zh-tw']. mapped to folders under locales/ directory.
  • fallbackLng - fallback locales. default zh-tw.
  • preload - list of locales to preload. defalt ['zh-tw'].
  • ns - list of namespaces. default ['default']. mapped to files under specific locale directory.
  • defaultNS - default namespace. default default
  • fallbackNS - fallback namespace when failed to match with desired namespace. default default.

for using @zbryikt/template as a command line tool, config file specified by -c option also support following options:

• lsp: an object passed to srcbuild.lsp as options. check @plotdb/srcbuild for more information.

watch.init accepts config with following options:

• watcher
  • ignores: files to ignored ( not watched ). array of regular expression against file names.
• assets: (deprecated) array of node module names to be copied to static/assets folder.
  • replaced by fedep. will be removed in future release

Additional information

template now use @plotdb/srcbuild for source building, and thus there are some additional features available and documented in @plotdb/ssrcbuild. Please refer to @plotdb/srcbuild for more information.

TODO

• support both indir building or src / static building.
• api style invocation

Note

• To optimize Pug building, keep an eye on the Pug inclusion tree, and prevent unnecessary include if possible.

License

MIT