pelican-liquid-tags


Namepelican-liquid-tags JSON
Version 1.0.4 PyPI version JSON
download
home_pagehttps://github.com/pelican-plugins/liquid-tags
SummaryPelican plugin that supports Liquid-style tags in Markdown documents
upload_time2022-12-04 12:25:47
maintainer
docs_urlNone
authorPelican Dev Team
requires_python>=3.6.2,<4.0
licenseAGPL-3.0
keywords pelican plugin markdown
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Liquid Tags

[![Build Status](https://img.shields.io/github/workflow/status/pelican-plugins/liquid-tags/build)](https://github.com/pelican-plugins/liquid-tags/actions)
[![PyPI Version](https://img.shields.io/pypi/v/pelican-liquid-tags)](https://pypi.org/project/pelican-liquid-tags/)
![License](https://img.shields.io/pypi/l/pelican-liquid-tags?color=blue)

This Pelican plugin allows Liquid-style tags to be inserted into Markdown within
Pelican documents via tags bounded by `{% ... %}`, a convention also used
to extend Markdown in other publishing platforms such as Octopress.

This set of extensions does not actually interface with Liquid, but allows
users to define their own Liquid-style tags which will be inserted into
the Markdown pre-processor stream. There are several built-in tags, which
can be added as follows below.

## Installation

This plugin can be installed via:

    python -m pip install pelican-liquid-tags

For more detailed plugin installation instructions, please refer to the
[Pelican Plugin Documentation](https://docs.getpelican.com/en/latest/plugins.html).

## Configuration

While this plugin does provide an extensive set of built-in tags (see below),
none of them is imported and made available by default. In order to use specific
tags in your post, you need to explicitly enable them in your settings file:

    LIQUID_TAGS = ["img", "literal", "video", "youtube",
                   "vimeo", "include_code"]

### Configuration Settings in Custom Tags

Tags do not have access to the full set of Pelican settings, and instead arrange
for the variables to be passed to the tag. Tag authors who plan to add their
tag as an in-tree tag can just add the variables they need to an array in
`mdx_liquid_tags.py`. Out-of-tree tag authors can specify which variables they
need by including a tuple of (variable, default value, helptext) via the
appropriate Pelican setting:

    LIQUID_CONFIGS = (('PATH', '.', "The default path"), ('SITENAME', 'Default Sitename', 'The name of the site'))

## Tags in this Plugin

### Image Tag

To insert a sized and labeled image in your document, enable the
`img` tag and use the following:

    {% img [class name(s)] path/to/image [lazy | eager] [width [height]] [title text | "title text" ["alt text"]] %}

The configuration variable `IMG_DEFAULT_LOADING` can change the default beahavior
of the plugin. `lazy` setting takes precendence over the default `eager`.
If `lazy` is set, all the images will receive the attribute. This is not the case
with `eager` because it's the default behavior of browsers when faced with an image.
Explicit parameters specified in liquid-tags `img` will always take precedence
and will always be translated into attributes.

### Base64 Image (Inline Image) Tag

`b64img` is based on the`img` tag, but instead of inserting a link to the image, it encodes it as Base64 text and inserts it into an `<img src=` attribute.

To use it:

1. Enable `b64img`
2. Insert a tag as follows: `{% b64img [class name(s)] path/to/image [width [height]] [title text | "title text" ["alt text"]] %}`

Images are encoded at generation time, so you can use any local path (just be sure that the image will remain in the same location for subsequent site generations).

### Instagram Tag

To insert a sized and labeled Instagram image in your document by its short-code (such as `pFI0CAIZna`), enable the `gram` tag and use the following:

    {% gram shortcode [size] [width] [class name(s)] [title text | "title text" ["alt text"]] %}

You can specify a size with `t`, `m`, or `l`.

### Flickr Tag

To insert a Flickr image to a post, follow these steps:

1. Enable `flickr`
2. [Get an API key from Flickr](https://www.flickr.com/services/apps/create/apply)
3. Add `FLICKR_API_KEY` to your settings file
4. Add this to your source document:

       {% flickr image_id [small|medium|large] ["alt text"|'alt text'] %}

### Giphy Tag

To insert a GIF from Giphy in a post, follow these steps:
1. Enable `giphy`
2. [Get an API key from Giphy](https://developers.giphy.com/docs/api#quick-start-guide)
3. Add `GIPHY_API_KEY` to your settings file
4. Add this to your source document:

       {% giphy gif_id ["alt text"|'alt text'] %}

### Soundcloud Tag

To insert a Soundcloud widget in your content, follow these steps:

1. Enable `soundcloud`
2. Add this to your source document:

       {% soundcloud track_url %}

### YouTube Tag

To insert a YouTube video into your content, enable the
`youtube` plugin and add the following to your source document:

    {% youtube youtube_id [width] [height] %}

The width and height are in pixels and are optional. If they
are not specified, then the dimensions will be 640 (wide) by 390 (tall).

If you experience issues with code generation (e.g., missing closing tags),
you might need to add `SUMMARY_MAX_LENGTH = None` to your settings file.

#### Embedding Thumbnail Only

If you do not want to add 1+ megabyte of JS code to your page, you can embed a
linked thumbnail instead. To do so, set a `YOUTUBE_THUMB_ONLY` variable in your
settings file. The `YOUTUBE_THUMB_SIZE` variable controls thumbnail dimensions,
with four sizes available:

name  | xres | yres
------|------|-----
maxres| 1280 | 720
sd    |  640 | 480
hq    |  480 | 360
mq    |  320 | 180

Embedded thumbnails have CSS class `youtube_video`, which can be used to add
a *Play* button.

### Vimeo Tag

To insert a Vimeo video into your content, enable the `vimeo`
plugin and add the following to your source document:

    {% vimeo vimeo_id [width] [height] %}

The width and height are in pixels and are optional. If they
are not specified, then the dimensions will be 640 (wide) by 390 (tall).

If you experience issues with code generation (e.g., missing closing tags),
you might need to add `SUMMARY_MAX_LENGTH = None` to your settings file.

### Speakerdeck Tag

To insert a Speakerdeck viewer into your content, follow these steps:

1. Enable the `soundcloud` plugin
2. Add the following to your source document:

```html
{% speakerdeck speakerdeck_id [ratio] %}
```

Notes:

- The ratio is a decimal number and is optional.
- Ratio must be a decimal number and any digit after decimal is optional.
- If ratio is not specified, then it will be `1.33333333333333` (4/3).
- Common value for the ratio is `1.77777777777777` (16/9).

### Video Tag

To insert HTML5-friendly video into your content, enable the `video`
plugin and add the following to your source document:

    {% video /url/to/video.mp4 [width] [height] [/path/to/poster.png] %}

The width and height are in pixels and are optional. If they are not specified,
then the native video size will be used. The poster image is a preview image
that is shown prior to initiating video playback.
To link to a video file, make sure it is in a static directory, transmitted
to your server, and available at the specified URL.

### Audio Tag

To insert HTML5 audio into a post, enable the `audio` plugin
and add the following to your source document:

    {% audio url/to/audio [url/to/audio] [url/to/audio] %}

This tag supports up to three audio URL arguments so you can add different
audio file versions, as different browsers support different file formats.

To link to an audio file, make sure it is in a static directory, transmitted
to your server, and available at the specified URL.

### Include Code

To include code from a file in your document, with optional link to the original
file, enable the `include_code` plugin, and add the following to your source
document:

    {% include_code path/to/code.py [lang:python] [lines:X-Y] [:hidefilename:] [:hidelink:] [:hideall:] [title] %}

`path/to/code.py` is path to file with source code, relative to `CODE_DIR` subdirectory
in your content folder. `CODE_DIR` is `code` by default and can be changed in
your settings file:

    CODE_DIR = 'code'

Additionally, in order for the resulting hyperlink to work, this directory must
be listed in the `STATIC_PATHS` setting. For example:

    STATIC_PATHS = ['images', 'code']

All other arguments are optional but must be specified in the order shown above.
Following example will show the first ten lines of the file.

    {% include_code path/to/code.py lines:1-10 Test Example %}

To hide the filename, use `:hidefilename:`. When that flag is specified, a title
must be provided.

You can hide download links only, while leaving the filename, by adding
`:hidelink:`.

If you would like to hide all three (title, filename, and download link),
use `:hideall:`.

The following example hides the filename:

    {% include_code path/to/code.py lines:1-10 :hidefilename: Test Example %}

### IPython notebooks

To insert an [IPython][] notebook into your post, enable the
`notebook` plugin and add the following to your source document:

    {% notebook filename.ipynb %}

The file should be specified relative to the `notebooks` subdirectory of the
content directory. Optionally, this subdirectory can be specified in your
settings file:

    NOTEBOOK_DIR = 'notebooks'

Because the conversion and rendering of notebooks is rather involved, there
are a few extra steps required for this plugin. First, you must install IPython:

      pip install ipython==2.4.1

After running Pelican on content containing an IPython notebook tag, a file
called `_nb_header.html` will be generated in the main directory. The content
of this file should be included in the header of your theme. An easy way to
accomplish this is to add the following to your theme’s header template…

      {% if EXTRA_HEADER %}
      {{ EXTRA_HEADER }}
      {% endif %}

… and in your settings file, include the line:

      from io import open
      EXTRA_HEADER = open('_nb_header.html', encoding='utf-8').read()

This will insert the proper CSS formatting into your generated document.

#### Optional Arguments for Notebook Tags

The notebook tag also has two optional arguments: `cells` and `language`.

- You can specify a slice of cells to include:

  `{% notebook filename.ipynb cells[2:8] %}`

- You can also specify the name of the language that Pygments should use for
  highlighting code cells. For a list of the language short names that Pygments
  can highlight, refer to the [Pygments lexer list](https://pygments.org/docs/lexers/).

  `{% notebook filename.ipynb language[julia] %}`

  This may be helpful for those using [IJulia](https://github.com/JuliaLang/IJulia.jl)
  or notebooks in other languages, especially as the IPython project [broadens its
  scope](https://github.com/ipython/ipython/wiki/Roadmap:-IPython) to [support
  other languages](https://jupyter.org). The default language for highlighting
  is `ipython`.

- These options can be used separately, together, or not at all. However,
  if both tags are used then `cells` must come before `language`:

  `{% notebook filename.ipynb cells[2:8] language[julia] %}`

#### Collapsible Code in IPython Notebooks

The IPython plugin also enables collapsible code input boxes. For this to work
you must first copy the file `pelicanhtml_3.tpl` (for IPython 3.x) or
`pelicanhtml_2.tpl` (for IPython 2.x) to the top level of your content
directory. Notebook input cells containing the comment line `#
<!-- collapse=True -->` will be collapsed when the HTML page is
loaded and can be expanded by tapping on them. Cells containing the
comment line `# <!-- collapse=False -->` will be expanded on load but
can be collapsed by tapping on their header. Cells without collapsed
comments are rendered as standard code input cells.

## Compatibility with [Jinja2Content plugin](https://github.com/pelican-plugins/jinja2content)

Jinja2Content plugin allows you to use Jinja2 directives inside your Pelican
articles and pages. You may encounter issues when using both Liquid Tags and
Jinja2Content, because Liquid Tag's `{% tag %}` syntax is also valid Jinja2
template syntax.

Jinja2Content will process file first, and only rendered content is then
processed by Liquid Tags. To ensure seamless operation of Liquid Tags, make
sure that `{% tag %}` syntax appears **after** file is rendered by Jinja2.
This can be achieved with [Jinja2 escaping](https://jinja.palletsprojects.com/en/latest/templates/#escaping):

     {% raw %}{% my_liquid_tag arguments %}{% endraw %}

<!-- -->

     {{ '{%' }} my_liquid_tag arguments {{ '%}' }}

## Testing

To run the plugin test suite, [set up your development environment][] and run:

    cd path/to/liquid_tags
    invoke tests

To test the plugin in multiple environments, install and use [Tox](https://tox.readthedocs.io/en/latest/):

    tox

## Contributing

Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].

To start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.

## Gratitude

Thanks to [Jake Vanderplas](https://github.com/jakevdp) for creating this plugin, which has subsequently been enhanced by [dozens of contributors](https://github.com/pelican-plugins/liquid-tags/graphs/contributors).


[IPython]: http://ipython.org/
[set up your development environment]: https://docs.getpelican.com/en/latest/contribute.html#setting-up-the-development-environment
[existing issues]: https://github.com/pelican-plugins/liquid-tags/issues
[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/pelican-plugins/liquid-tags",
    "name": "pelican-liquid-tags",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.6.2,<4.0",
    "maintainer_email": "",
    "keywords": "pelican,plugin,markdown",
    "author": "Pelican Dev Team",
    "author_email": "authors@getpelican.com",
    "download_url": "https://files.pythonhosted.org/packages/a5/81/16d5b3738848f916bc4cf5d32930e34a685290ec69c524f535338f0f6f1b/pelican_liquid_tags-1.0.4.tar.gz",
    "platform": null,
    "description": "# Liquid Tags\n\n[![Build Status](https://img.shields.io/github/workflow/status/pelican-plugins/liquid-tags/build)](https://github.com/pelican-plugins/liquid-tags/actions)\n[![PyPI Version](https://img.shields.io/pypi/v/pelican-liquid-tags)](https://pypi.org/project/pelican-liquid-tags/)\n![License](https://img.shields.io/pypi/l/pelican-liquid-tags?color=blue)\n\nThis Pelican plugin allows Liquid-style tags to be inserted into Markdown within\nPelican documents via tags bounded by `{% ... %}`, a convention also used\nto extend Markdown in other publishing platforms such as Octopress.\n\nThis set of extensions does not actually interface with Liquid, but allows\nusers to define their own Liquid-style tags which will be inserted into\nthe Markdown pre-processor stream. There are several built-in tags, which\ncan be added as follows below.\n\n## Installation\n\nThis plugin can be installed via:\n\n    python -m pip install pelican-liquid-tags\n\nFor more detailed plugin installation instructions, please refer to the\n[Pelican Plugin Documentation](https://docs.getpelican.com/en/latest/plugins.html).\n\n## Configuration\n\nWhile this plugin does provide an extensive set of built-in tags (see below),\nnone of them is imported and made available by default. In order to use specific\ntags in your post, you need to explicitly enable them in your settings file:\n\n    LIQUID_TAGS = [\"img\", \"literal\", \"video\", \"youtube\",\n                   \"vimeo\", \"include_code\"]\n\n### Configuration Settings in Custom Tags\n\nTags do not have access to the full set of Pelican settings, and instead arrange\nfor the variables to be passed to the tag. Tag authors who plan to add their\ntag as an in-tree tag can just add the variables they need to an array in\n`mdx_liquid_tags.py`. Out-of-tree tag authors can specify which variables they\nneed by including a tuple of (variable, default value, helptext) via the\nappropriate Pelican setting:\n\n    LIQUID_CONFIGS = (('PATH', '.', \"The default path\"), ('SITENAME', 'Default Sitename', 'The name of the site'))\n\n## Tags in this Plugin\n\n### Image Tag\n\nTo insert a sized and labeled image in your document, enable the\n`img` tag and use the following:\n\n    {% img [class name(s)] path/to/image [lazy | eager] [width [height]] [title text | \"title text\" [\"alt text\"]] %}\n\nThe configuration variable `IMG_DEFAULT_LOADING` can change the default beahavior\nof the plugin. `lazy` setting takes precendence over the default `eager`.\nIf `lazy` is set, all the images will receive the attribute. This is not the case\nwith `eager` because it's the default behavior of browsers when faced with an image.\nExplicit parameters specified in liquid-tags `img` will always take precedence\nand will always be translated into attributes.\n\n### Base64 Image (Inline Image) Tag\n\n`b64img` is based on the`img` tag, but instead of inserting a link to the image, it encodes it as Base64 text and inserts it into an `<img src=` attribute.\n\nTo use it:\n\n1. Enable `b64img`\n2. Insert a tag as follows: `{% b64img [class name(s)] path/to/image [width [height]] [title text | \"title text\" [\"alt text\"]] %}`\n\nImages are encoded at generation time, so you can use any local path (just be sure that the image will remain in the same location for subsequent site generations).\n\n### Instagram Tag\n\nTo insert a sized and labeled Instagram image in your document by its short-code (such as `pFI0CAIZna`), enable the `gram` tag and use the following:\n\n    {% gram shortcode [size] [width] [class name(s)] [title text | \"title text\" [\"alt text\"]] %}\n\nYou can specify a size with `t`, `m`, or `l`.\n\n### Flickr Tag\n\nTo insert a Flickr image to a post, follow these steps:\n\n1. Enable `flickr`\n2. [Get an API key from Flickr](https://www.flickr.com/services/apps/create/apply)\n3. Add `FLICKR_API_KEY` to your settings file\n4. Add this to your source document:\n\n       {% flickr image_id [small|medium|large] [\"alt text\"|'alt text'] %}\n\n### Giphy Tag\n\nTo insert a GIF from Giphy in a post, follow these steps:\n1. Enable `giphy`\n2. [Get an API key from Giphy](https://developers.giphy.com/docs/api#quick-start-guide)\n3. Add `GIPHY_API_KEY` to your settings file\n4. Add this to your source document:\n\n       {% giphy gif_id [\"alt text\"|'alt text'] %}\n\n### Soundcloud Tag\n\nTo insert a Soundcloud widget in your content, follow these steps:\n\n1. Enable `soundcloud`\n2. Add this to your source document:\n\n       {% soundcloud track_url %}\n\n### YouTube Tag\n\nTo insert a YouTube video into your content, enable the\n`youtube` plugin and add the following to your source document:\n\n    {% youtube youtube_id [width] [height] %}\n\nThe width and height are in pixels and are optional. If they\nare not specified, then the dimensions will be 640 (wide) by 390 (tall).\n\nIf you experience issues with code generation (e.g., missing closing tags),\nyou might need to add `SUMMARY_MAX_LENGTH = None` to your settings file.\n\n#### Embedding Thumbnail Only\n\nIf you do not want to add 1+ megabyte of JS code to your page, you can embed a\nlinked thumbnail instead. To do so, set a `YOUTUBE_THUMB_ONLY` variable in your\nsettings file. The `YOUTUBE_THUMB_SIZE` variable controls thumbnail dimensions,\nwith four sizes available:\n\nname  | xres | yres\n------|------|-----\nmaxres| 1280 | 720\nsd    |  640 | 480\nhq    |  480 | 360\nmq    |  320 | 180\n\nEmbedded thumbnails have CSS class `youtube_video`, which can be used to add\na *Play* button.\n\n### Vimeo Tag\n\nTo insert a Vimeo video into your content, enable the `vimeo`\nplugin and add the following to your source document:\n\n    {% vimeo vimeo_id [width] [height] %}\n\nThe width and height are in pixels and are optional. If they\nare not specified, then the dimensions will be 640 (wide) by 390 (tall).\n\nIf you experience issues with code generation (e.g., missing closing tags),\nyou might need to add `SUMMARY_MAX_LENGTH = None` to your settings file.\n\n### Speakerdeck Tag\n\nTo insert a Speakerdeck viewer into your content, follow these steps:\n\n1. Enable the `soundcloud` plugin\n2. Add the following to your source document:\n\n```html\n{% speakerdeck speakerdeck_id [ratio] %}\n```\n\nNotes:\n\n- The ratio is a decimal number and is optional.\n- Ratio must be a decimal number and any digit after decimal is optional.\n- If ratio is not specified, then it will be `1.33333333333333` (4/3).\n- Common value for the ratio is `1.77777777777777` (16/9).\n\n### Video Tag\n\nTo insert HTML5-friendly video into your content, enable the `video`\nplugin and add the following to your source document:\n\n    {% video /url/to/video.mp4 [width] [height] [/path/to/poster.png] %}\n\nThe width and height are in pixels and are optional. If they are not specified,\nthen the native video size will be used. The poster image is a preview image\nthat is shown prior to initiating video playback.\nTo link to a video file, make sure it is in a static directory, transmitted\nto your server, and available at the specified URL.\n\n### Audio Tag\n\nTo insert HTML5 audio into a post, enable the `audio` plugin\nand add the following to your source document:\n\n    {% audio url/to/audio [url/to/audio] [url/to/audio] %}\n\nThis tag supports up to three audio URL arguments so you can add different\naudio file versions, as different browsers support different file formats.\n\nTo link to an audio file, make sure it is in a static directory, transmitted\nto your server, and available at the specified URL.\n\n### Include Code\n\nTo include code from a file in your document, with optional link to the original\nfile, enable the `include_code` plugin, and add the following to your source\ndocument:\n\n    {% include_code path/to/code.py [lang:python] [lines:X-Y] [:hidefilename:] [:hidelink:] [:hideall:] [title] %}\n\n`path/to/code.py` is path to file with source code, relative to `CODE_DIR` subdirectory\nin your content folder. `CODE_DIR` is `code` by default and can be changed in\nyour settings file:\n\n    CODE_DIR = 'code'\n\nAdditionally, in order for the resulting hyperlink to work, this directory must\nbe listed in the `STATIC_PATHS` setting. For example:\n\n    STATIC_PATHS = ['images', 'code']\n\nAll other arguments are optional but must be specified in the order shown above.\nFollowing example will show the first ten lines of the file.\n\n    {% include_code path/to/code.py lines:1-10 Test Example %}\n\nTo hide the filename, use `:hidefilename:`. When that flag is specified, a title\nmust be provided.\n\nYou can hide download links only, while leaving the filename, by adding\n`:hidelink:`.\n\nIf you would like to hide all three (title, filename, and download link),\nuse `:hideall:`.\n\nThe following example hides the filename:\n\n    {% include_code path/to/code.py lines:1-10 :hidefilename: Test Example %}\n\n### IPython notebooks\n\nTo insert an [IPython][] notebook into your post, enable the\n`notebook` plugin and add the following to your source document:\n\n    {% notebook filename.ipynb %}\n\nThe file should be specified relative to the `notebooks` subdirectory of the\ncontent directory. Optionally, this subdirectory can be specified in your\nsettings file:\n\n    NOTEBOOK_DIR = 'notebooks'\n\nBecause the conversion and rendering of notebooks is rather involved, there\nare a few extra steps required for this plugin. First, you must install IPython:\n\n      pip install ipython==2.4.1\n\nAfter running Pelican on content containing an IPython notebook tag, a file\ncalled `_nb_header.html` will be generated in the main directory. The content\nof this file should be included in the header of your theme. An easy way to\naccomplish this is to add the following to your theme\u2019s header template\u2026\n\n      {% if EXTRA_HEADER %}\n      {{ EXTRA_HEADER }}\n      {% endif %}\n\n\u2026 and in your settings file, include the line:\n\n      from io import open\n      EXTRA_HEADER = open('_nb_header.html', encoding='utf-8').read()\n\nThis will insert the proper CSS formatting into your generated document.\n\n#### Optional Arguments for Notebook Tags\n\nThe notebook tag also has two optional arguments: `cells` and `language`.\n\n- You can specify a slice of cells to include:\n\n  `{% notebook filename.ipynb cells[2:8] %}`\n\n- You can also specify the name of the language that Pygments should use for\n  highlighting code cells. For a list of the language short names that Pygments\n  can highlight, refer to the [Pygments lexer list](https://pygments.org/docs/lexers/).\n\n  `{% notebook filename.ipynb language[julia] %}`\n\n  This may be helpful for those using [IJulia](https://github.com/JuliaLang/IJulia.jl)\n  or notebooks in other languages, especially as the IPython project [broadens its\n  scope](https://github.com/ipython/ipython/wiki/Roadmap:-IPython) to [support\n  other languages](https://jupyter.org). The default language for highlighting\n  is `ipython`.\n\n- These options can be used separately, together, or not at all. However,\n  if both tags are used then `cells` must come before `language`:\n\n  `{% notebook filename.ipynb cells[2:8] language[julia] %}`\n\n#### Collapsible Code in IPython Notebooks\n\nThe IPython plugin also enables collapsible code input boxes. For this to work\nyou must first copy the file `pelicanhtml_3.tpl` (for IPython 3.x) or\n`pelicanhtml_2.tpl` (for IPython 2.x) to the top level of your content\ndirectory. Notebook input cells containing the comment line `#\n<!-- collapse=True -->` will be collapsed when the HTML page is\nloaded and can be expanded by tapping on them. Cells containing the\ncomment line `# <!-- collapse=False -->` will be expanded on load but\ncan be collapsed by tapping on their header. Cells without collapsed\ncomments are rendered as standard code input cells.\n\n## Compatibility with [Jinja2Content plugin](https://github.com/pelican-plugins/jinja2content)\n\nJinja2Content plugin allows you to use Jinja2 directives inside your Pelican\narticles and pages. You may encounter issues when using both Liquid Tags and\nJinja2Content, because Liquid Tag's `{% tag %}` syntax is also valid Jinja2\ntemplate syntax.\n\nJinja2Content will process file first, and only rendered content is then\nprocessed by Liquid Tags. To ensure seamless operation of Liquid Tags, make\nsure that `{% tag %}` syntax appears **after** file is rendered by Jinja2.\nThis can be achieved with [Jinja2 escaping](https://jinja.palletsprojects.com/en/latest/templates/#escaping):\n\n     {% raw %}{% my_liquid_tag arguments %}{% endraw %}\n\n<!-- -->\n\n     {{ '{%' }} my_liquid_tag arguments {{ '%}' }}\n\n## Testing\n\nTo run the plugin test suite, [set up your development environment][] and run:\n\n    cd path/to/liquid_tags\n    invoke tests\n\nTo test the plugin in multiple environments, install and use [Tox](https://tox.readthedocs.io/en/latest/):\n\n    tox\n\n## Contributing\n\nContributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].\n\nTo start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.\n\n## Gratitude\n\nThanks to [Jake Vanderplas](https://github.com/jakevdp) for creating this plugin, which has subsequently been enhanced by [dozens of contributors](https://github.com/pelican-plugins/liquid-tags/graphs/contributors).\n\n\n[IPython]: http://ipython.org/\n[set up your development environment]: https://docs.getpelican.com/en/latest/contribute.html#setting-up-the-development-environment\n[existing issues]: https://github.com/pelican-plugins/liquid-tags/issues\n[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html\n",
    "bugtrack_url": null,
    "license": "AGPL-3.0",
    "summary": "Pelican plugin that supports Liquid-style tags in Markdown documents",
    "version": "1.0.4",
    "split_keywords": [
        "pelican",
        "plugin",
        "markdown"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "233fee1d6b40783eed9e5347fe764101",
                "sha256": "7e9034d5d95726d9d48c7e7abf2876621adc71b35c8a295f15882fe4eec4d32a"
            },
            "downloads": -1,
            "filename": "pelican_liquid_tags-1.0.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "233fee1d6b40783eed9e5347fe764101",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.6.2,<4.0",
            "size": 80366,
            "upload_time": "2022-12-04T12:25:45",
            "upload_time_iso_8601": "2022-12-04T12:25:45.406634Z",
            "url": "https://files.pythonhosted.org/packages/49/0e/d3f4ad95b39e4de55fee98ec969eb0a05605018d9441c3c77400e2c647c8/pelican_liquid_tags-1.0.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "fbbc15ba12eaa84f9f4d2c851f93d22c",
                "sha256": "40ba8a7832c1f9c1b5d139dcf95a413fc71a08ea752374f7ce38bdf0d8366c7e"
            },
            "downloads": -1,
            "filename": "pelican_liquid_tags-1.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "fbbc15ba12eaa84f9f4d2c851f93d22c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.6.2,<4.0",
            "size": 62045,
            "upload_time": "2022-12-04T12:25:47",
            "upload_time_iso_8601": "2022-12-04T12:25:47.286896Z",
            "url": "https://files.pythonhosted.org/packages/a5/81/16d5b3738848f916bc4cf5d32930e34a685290ec69c524f535338f0f6f1b/pelican_liquid_tags-1.0.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-12-04 12:25:47",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "pelican-plugins",
    "github_project": "liquid-tags",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "pelican-liquid-tags"
}
        
Elapsed time: 0.01659s