---
name: "pelican-plugins"
section: "1"
platform: "linux"
package: "pelican"
version: "4.11.0+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pelican-plugins"
---

# pelican-plugins(1)

manages pelican plugins

## 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.