Skip to main content

A generator for Pelican allowing flexible referencing of static content

Project description

A plugin for Pelican that adds automatic resolution of static files.

While the original static generator included in Pelican requires the hardcoding of static paths in the configuration file, pelican-autostatic provides facilities to dinamically add static content independent of its location, just by referencing it.


To install the library, you can use pip

$ pip install pelican-autostatic


  1. Update

    1. Add autostatic to PLUGINS.

      You should add it before any metadata-affecting plugins.

      PLUGINS = ['autostatic', ...]
  2. Reference static content in your Markdown/rST metadata/text by using the {static} substitution:

    {static url/to/content key1=val1 key2="val 2" ...}


    {static "url/to/content/with spaces" key1=val1 key2="val 2" ...}

    Example (in markdown):

    [Markdown example file]({static file/})
  3. An index of these references will be automatically built and those files will be copied to the output folder preserving the path structure:

    • If using a relative path, the file will be copied to the same path relative to the directory where the .html file is output.

    • If using an absolute path, the file is copied to that same path relative to the base output folder (e.g: output).


Autostatic references can have a number of options after the url for the content. This allows modifications to the content being referenced.

Core options

  • output: Allows changing the output path (and the url) of the file in the generated .html.


    {static /images/example.png output=/images/example_2.png}

    Will copy content/images/example.png to output/images/example_2.png and the reference will be replaced by $SITEURL/images/example_2.png.

  • url: Allows changing the url of the file in the generated .html without changing the output path.


    {static /images/example.png url=/images/example_2.png}

    Will copy content/images/example.png to output/images/example.png and the reference will be replaced by $SITEURL/images/example_2.png.

Third-party options

  • pelican-advthumbnailer adds a thumb option that changes the url of the static image reference so that a thumbnail of that image is generated and linked and not the image itself.


Available signals

  • autostatic_path_found: Signalled when a new autostatic reference is found.


    • sender: Always None

    • autostatic_path: Object containing:

      • source: Read-only property containing source path of reference.

      • destination: Read/write property containing destination of referenced file.

      • original_destination: Read-only property containing default destination of referenced file.

      • url: Read/write property containing url to be substituted for the reference.

      • original_url: Read-only property containing default url to be substituted for the reference.

      • extra: Dictionary containing the options specified in addition to the path. Can be possibly empty.

pelican-advthumbnailer contains an example usage of this signal.


For a working example check my site and my site’s source code.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pelican-autostatic-0.2.0.tar.gz (9.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page