table of contents
| PELICAN(1) | User Commands | PELICAN(1) |
NAME¶
pelican - manages pelican plugins
DESCRIPTION¶
usage: pelican [-h] [-t THEME] [-o OUTPUT] [-s SETTINGS] [-d] [-v] [-q] [-D]
- [--version] [-r] [--print-settings [SETTING_NAME [SETTING_NAME ...]]] [--relative-urls] [--cache-path CACHE_PATH] [--ignore-cache] [-w SELECTED_PATHS] [--fatal errors|warnings] [--logs-dedup-min-level {DEBUG,INFO,WARNING,ERROR}] [-l] [-p PORT] [-b BIND] [path]
A tool to generate a static blog, with restructured text input files.
positional arguments:¶
- path
- Path where to find the content files. (default: None)
optional arguments:¶
- -h, --help
- show this help message and exit
- -t THEME, --theme-path THEME
- Path where to find the theme templates. If not specified, it will use the default one included with pelican. (default: None)
- -o OUTPUT, --output OUTPUT
- Where to output the generated files. If not specified, a directory will be created, named "output" in the current path. (default: None)
- -s SETTINGS, --settings SETTINGS
- The settings of the application, this is automatically set to pelicanconf.py if a file exists with this name. (default: None)
- -d, --delete-output-directory
- Delete the output directory. (default: None)
- -v, --verbose
- Show all messages. (default: None)
- -q, --quiet
- Show only critical errors. (default: None)
- -D, --debug
- Show all messages, including debug messages. (default: None)
- --version
- Print the pelican version and exit.
- -r, --autoreload
- Relaunch pelican each time a modification occurs on the content files. (default: False)
- --print-settings [SETTING_NAME [SETTING_NAME ...]]
- Print current configuration settings and exit. Append one or more setting name arguments to see the values for specific settings only. (default: None)
- --relative-urls
- Use relative urls in output, useful for site development (default: False)
- --cache-path CACHE_PATH
- Directory in which to store cache files. If not specified, defaults to "cache". (default: None)
- --ignore-cache
- Ignore content cache from previous runs by not loading cache files. (default: False)
- -w SELECTED_PATHS, --write-selected SELECTED_PATHS
- Comma separated list of selected paths to write (default: None)
- --fatal errors|warnings
- Exit the program with non-zero status if any errors/warnings encountered. (default: )
- --logs-dedup-min-level {DEBUG,INFO,WARNING,ERROR}
- Only enable log de-duplication for levels equal to or above the specified value (default: WARNING)
- -l, --listen
- Serve content files via HTTP and port 8000. (default: False)
- -p PORT, --port PORT
- Port to serve HTTP files at. (default: 8000) (default: None)
- -b BIND, --bind BIND
- IP to bind to when serving files via HTTP (default: 127.0.0.1) (default: None)
SEE ALSO¶
The full documentation for pelican is maintained as a Texinfo manual. If the info and pelican programs are properly installed at your site, the command
- info pelican
should give you access to the complete manual.
| January 2021 | pelican 4.0.1 |