# -*- 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:: .. _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.')