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.