Skip to main content

The Lektor Shortcodes plugin allows you to use shortcodes (shortcodes are something like custom tags) in your fields (not templates), so your content doesn't have to have repetitive snippets over and over.

Project description

Lektor Shortcodes

PyPI

The Lektor Shortcodes plugin allows you to use shortcodes (shortcodes are something like custom tags) in your fields (not templates), so your content doesn't have to have repetitive snippets over and over.

For example, my blog has some specific HTML that I add when I want an image with a border and caption to be displayed. The HTML looks like this:

    <div class="alignright">
        <a href="image-large.jpg">
            <img src="image.jpg" />
            <span class="caption">The caption</span>
        </a>
    </div>

Copy-pasting this every time gets tedious, and I have to search and replace it in all the content files every time I want to make a change. With the shortcodes plugin, this can be written as:

[% image align=right link="image-large.jpg" image=image.jpg caption="The caption" %]

Much easier, cleaner and less repetitive.

Installation

To install the plugin, just add lektor-shortcodes to your plugins from the command line:

lektor plugins add lektor-shortcodes

Usage

Using the plugin is simple. Just create a config file called shortcodes.ini in your configs directory and specify some shortcode templates. The templates are full Jinja templates, although (due to some limitations of ini files) they need to be on one line.

For instance, for the example above, the config file could be:

[global]
image = '<div class="align{{ align }}">{% if link %}<a href="{{ link }}"{% if not link.startswith("http") %} data-lightbox="gallery"{% endif %}>{% endif %}<img src="{{ image }}">{% if link %}</a>{% endif %}{% if caption %}<span class="caption">{{ caption }}</span>{% endif %}</div>'

This will allow you to use shortcodes with optional arguments, like so:

# An image with no caption or link:
[% image align=right image=hello.jpg %]


# An image with a link:
[% image align=right link=http://www.example.com image=hello.jpg %]

# Link and caption:
[% image align=right link=http://www.example.com image=hello.jpg caption="Hello!" %]

Shortcodes defined within the section named global will be processed automatically inside any of your site’s Markdown content. It is also possible to define shortcodes which are only expanded when the Jinja2 template for a page explicitly requests it. Shortcodes defined in any section not named global will only be applied when the template passed the content through a Jinja2 filter named shortcode. For example, if your HTML template references a field called body, you may request expanding shortcodes defined within the body-only section of your config file, like so:

{{ body|shortcodes(section="body-only") }}

This will enable all shortcodes from the specified section, in addition to all globally defined shortcodes. If no section is specified, the filter defaults to the section named main.

Miscellanea

If you find a bug or have a feature request, please open an issue or file a PR. Thanks!

Project details


Release history Release notifications

This version
History Node

0.2.4

History Node

0.2.3

History Node

0.2.0

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
lektor_shortcodes-0.2.4-py3-none-any.whl (6.3 kB) Copy SHA256 hash SHA256 Wheel py3 May 11, 2018
lektor-shortcodes-0.2.4.tar.gz (5.7 kB) Copy SHA256 hash SHA256 Source None May 11, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page