skip to navigation
skip to content

pelican-autostatic 0.1.0

A generator for Pelican allowing flexible referencing of static content

Latest Version: 0.2.2

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.

File Type Py Version Uploaded on Size
pelican-autostatic-0.1.0.tar.gz (md5) Source 2014-08-26 8KB