Command Line Arguments

The server.py supports the following command line arguments:

Argument Description
--port Sets the HTTP server port. Defaults to 8000.
--hot-reloading, or,
-r
Enables hot reloading.
--hot-reloading-port Sets a specific port for the hot reloading web socket port. The default is the --port, plus one.
--help Shows the command line help.

Hot Reloading

The development server also supports hot reloading, on the following resources:

  • Top level page CSS stylesheets, typically found in kondo/styles/*.css,
  • Per-page styles added by @style,
  • The rendered .ucc or .md file, and,
  • Plugins and data loaded via context.get_data(path) by a plugin.

To enable it, run server.py with the option --hot-reloading, or, the short option, -r. Then, when any of the above files are changed, the browser will update the styles or page content without a reload.

Hot reloading is not yet implemented for:

  • Adding, removing or changing @style or @component directives, and,
  • Component files.
  • The main template.html template.
  • Images.

However, a simple manual page refresh on page will cause a reload on the above.

This feature is relatively new, please report any issues (or to requests support for hot reloading some other type of files) in #ucc-website-dev in Discord.