12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061 |
- # -*- coding: utf-8 -*-
- """
- Asset management plugin for Pelican
- ===================================
- This plugin allows you to use the `webassets`_ module to manage assets such as
- CSS and JS files.
- The ASSET_URL is set to a relative url to honor Pelican's RELATIVE_URLS
- setting. This requires the use of SITEURL in the templates::
- <link rel="stylesheet" href="{{ SITEURL }}/{{ ASSET_URL }}">
- .. _webassets: https://webassets.readthedocs.org/
- """
- from __future__ import unicode_literals
- import os
- import logging
- from pelican import signals
- logger = logging.getLogger(__name__)
- try:
- import webassets
- from webassets import Environment
- from webassets.ext.jinja2 import AssetsExtension
- except ImportError:
- webassets = None
- def add_jinja2_ext(pelican):
- """Add Webassets to Jinja2 extensions in Pelican settings."""
- pelican.settings['JINJA_EXTENSIONS'].append(AssetsExtension)
- def create_assets_env(generator):
- """Define the assets environment and pass it to the generator."""
- assets_url = 'theme/'
- assets_src = os.path.join(generator.output_path, 'theme')
- generator.env.assets_environment = Environment(assets_src, assets_url)
- if 'ASSET_CONFIG' in generator.settings:
- for item in generator.settings['ASSET_CONFIG']:
- generator.env.assets_environment.config[item[0]] = item[1]
- if logging.getLevelName(logger.getEffectiveLevel()) == "DEBUG":
- generator.env.assets_environment.debug = True
- def register():
- """Plugin registration."""
- if webassets:
- signals.initialized.connect(add_jinja2_ext)
- signals.generator_init.connect(create_assets_env)
- else:
- logger.warning('`assets` failed to load dependency `webassets`.'
- '`assets` plugin not loaded.')
|