{
"info": {
"author": "Alexandre Fonseca",
"author_email": "alexandrejorgefonseca@gmail.com",
"bugtrack_url": null,
"classifiers": [],
"description": "#######################\npelican-metadataparsing\n#######################\n\nA plugin for `Pelican\n`_ that\nallows the easy definition of custom metadata parsers.\n\n\nInstall\n=======\n\nTo install the library, you can use\n`pip\n`_\n\n.. code-block:: bash\n\n $ pip install pelican-metadataparsing\n\n\nUsage\n=====\n\n1. Update ``pelicanconf.py``:\n\n 1. Add ``metadataparsing`` to ``PLUGINS``.\n \n You should add it before any metadata-affecting plugins.\n\n .. code-block:: python\n \n PLUGINS = [..., 'metadataparsing', ...]\n\n 2. Define your custom metadata parsers through the ``METADATA_PARSERS``\n setting:\n\n .. code-block:: python\n\n METADATA_PARSERS = {\n \"\": ,\n \"\": \n }\n\n2. Corresponding fields of the ``page``, ``article`` or ``entity``\n object will have the value returned from the respective parser\n function.\n\n\nExample\n=======\n\nGallery Metadata\n----------------\n\n``pelicanconf.py``:\n\n.. code-block:: python\n\n import collections\n import six\n\n GalleryItem = collections.namedtuple(\"GalleryItem\", [\"url\", \"description\"])\n def parse_gallery(string):\n if string is None or not isinstance(string, collections.Iterable):\n return None\n\n if not isinstance(string, six.string_types):\n string = '\\n'.join(string)\n\n items = []\n\n for line in string.split('\\n'):\n if not line:\n continue\n\n parts = line.split(\"||\")\n\n url = parts[0].strip()\n\n if len(parts) == 1:\n description = None\n else:\n description = parts[1].strip()\n\n items.append(GalleryItem(url, description))\n\n return items\n\n METADATA_PARSERS = {\n \"Gallery\": parse_gallery\n }\n\nTheme:\n\n.. code-block:: html\n\n {% if article.gallery %}\n \n
Gallery:
\n
\n {% for image in article.gallery %}\n - {{ colorbox(image.url, image.description) }}
\n {% endfor %}\n
\n