# Plugin – lektor-creative-commons 0.6.0

Lektor plugin to add Creative Commons license to your pages

#### Project links

#### GitHub Statistics

#### Meta

Version: 0.6.0

Author: Humberto Rocha

#### Tags

Creative Commons, i18n, Jinja globals, Licensing, and setup-env

View all tags.

## Project Description

# Lektor Creative Commons

Lektor plugin to add Creative Commons license to your pages

## Usage

On your templates use:

    <div class="license">{{ render_cc_license(type, size, template, caller) }}</div>

- `type` is a `string` with the license type (e.g.: `'by'`, `'by-sa'`, `'by-nc-sa'`).
- `size` is an optional parameter with the size `'normal'` or `'compact'`. It defaults to `'normal'`.
- `template` is an optional parameter with the template `'full'`, `'image-only'` or `'text-only'`. It defaults to `'full'`.
- `locale` is an optional parameter that overrides the locale at function calling time.
- `caller` is an optional parameter that you can pass an callable to mount your own template. This argument is usually omitted. See the example of how to use it with the Jinja call feature.

## Examples

Simply rendering the license of your choice:

    <div class="license">{{ render_cc_license('by-sa') }}</div>

Using Jinja2 call block to inject your own template:

    {% call(license, license_url, icon_path) render_cc_license('by-sa', size='normal') %}
      <a class="nav-item" rel="license" target="_blank" href="{{ license_url }}">
        <img alt="{{ license }}" style="border-width:0" src="{{ icon_path }}" />
      </a>
    {% endcall %}

There are more variables, you can check which with

    {% call() render_cc_license('by-sa', size='normal') %}
      {{ kwargs }}
    {% endcall %}

Notice that using the call block it injects its content as `caller` parameter to the `render_cc_license` function that skips the need of choosing a template and renders your own.

## Internationalization support

This plugin has support to internationalization, and changes it language based on `.lektorproject` file. The Current supported locales are:

- en
- pt_BR
- de

Any other locale will default to `en` (English).

## Comments