SSITE(1) User Commands SSITE(1)

ssite - ssite

usage: ssite [-h] [--version]

{check,dump,dump_meta,build,serve,show,new,edit,site,meta,shell} ...

Static site generator.

positional arguments:

{check,dump,dump_meta,build,serve,show,new,edit,site,meta,shell}
sub-command help
check dump dump_meta build serve show new edit site meta Edit metadata for a file shell

show this help message and exit
show program's version number and exit

usage: ssite check [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft]

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future

usage: ssite dump [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft] (--fstree | --nodes | --changes | --reference-documentation [destdir])

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future
dump information about the scanned directory trees
dump information about the built site layout
dump information about pages that changed
regenerate reference documentation

usage: ssite dump_meta [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft]
[-f FORMAT] [-p PAGES [PAGES ...]]

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future
format to use for output
globs or regexps matching pages to show

usage: ssite build [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft] [--type TYPE] [--path PATH] [--fail-fast] [-f]

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future
render only pages of this type
render only pages under this path
fail the first time a page gives an error in rendering
always do a full rebuild

usage: ssite serve [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft] [--port PORT] [--host HOST]

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future
port to use (default: 8000)
host to bind to (default: localhost)

usage: ssite show [-h] [-v] [--debug] [--theme THEME] [--draft] [--no-start]

[--port PORT] [--host HOST]

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future
page archetype
page title
do not run an editor, only output the file name of the new post
if a post already exists, overwrite it instead of reusing it

usage: ssite edit [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft] [-n] [project] [match ...]

positional arguments:

project directory or .py configuration file (default: the current directory)
keywords used to look for the page to edit

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future
do not run an editor, only output the file name of the new post

usage: ssite site [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft] [--cmd ...]

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future
site-specific command (try 'help')

usage: ssite meta [-h] [-v] [--debug] file

positional arguments:

edit the metadata of this file

show this help message and exit
verbose output
debugging output

usage: ssite shell [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft]

positional arguments:

project directory or .py configuration file (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
content directory location. Overrides settings.CONTENT
archetypes directory location. Override settings.ARCHETYPES
output directory location. Override settings.OUTPUT
do not ignore pages with date in the future

positional arguments:

directory to show (default: the current directory)

show this help message and exit
verbose output
debugging output
theme directory location. Overrides settings.THEME
do not ignore pages with date in the future
do not start a browser automatically, print the URL instead
port to use (default: randomly allocated)
host to bind to (default: localhost)

usage: ssite new [-h] [-v] [--debug] [--theme THEME] [--content CONTENT]

[--archetypes ARCHETYPES] [-o OUTPUT] [--draft] [-a ARCHETYPE] [-t TITLE] [-n] [--overwrite]
September 2023 ssite 2.4