2022-10-01 17:26:58 +01:00
|
|
|
# soupault
|
|
|
|
|
|
2023-11-15 04:25:25 +00:00
|
|
|
> A static website generator based on HTML element tree rewriting.
|
2022-10-01 17:26:58 +01:00
|
|
|
> It can also be used as an HTML post-processor or metadata extractor.
|
|
|
|
|
> More information: <https://soupault.app>.
|
|
|
|
|
|
|
|
|
|
- Initialize a minimal website project in the current working directory:
|
|
|
|
|
|
|
|
|
|
`soupault --init`
|
|
|
|
|
|
|
|
|
|
- Build a website:
|
|
|
|
|
|
|
|
|
|
`soupault`
|
|
|
|
|
|
2024-01-25 05:29:16 +00:00
|
|
|
- Override default configuration file and directory locations:
|
2022-10-01 17:26:58 +01:00
|
|
|
|
|
|
|
|
`soupault --config {{config_path}} --site-dir {{input_dir}} --build-dir {{output_dir}}`
|
|
|
|
|
|
|
|
|
|
- Extract metadata into a JSON file without generating pages:
|
|
|
|
|
|
|
|
|
|
`soupault --index-only --dump-index-json {{path/to/file.json}}`
|
|
|
|
|
|
2024-01-25 05:29:16 +00:00
|
|
|
- Show the effective configuration (values from `soupault.toml` plus defaults):
|
2022-10-01 17:26:58 +01:00
|
|
|
|
|
|
|
|
`soupault --show-effective-config`
|
