Skip to content

a web template, for simple frontend. it contains a simple webserver, watch daemon, and a makefile for offline building

License

Notifications You must be signed in to change notification settings

zbryikt/template

Repository files navigation

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

About

a web template, for simple frontend. it contains a simple webserver, watch daemon, and a makefile for offline building

Resources

License

Stars

Watchers

Forks

Packages

No packages published