Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Microdata semantic markups support for Pelican Blog Generator
Python Shell
Branch: master

README.rst

Microdata plugin for Pelican

https://secure.travis-ci.org/noirbizarre/pelican-microdata.png https://coveralls.io/repos/noirbizarre/pelican-microdata/badge.png?branch=master https://pypip.in/v/pelican-microdata/badge.png https://pypip.in/d/pelican-microdata/badge.png

Microdata semantic markups support for Pelican static blog generator.

Installation

Install the plugin via pip:

~$ pip install pelican-microdata

Or via easy_install:

~$ easy_install pelican-microdata

Usage

To load the plugin, you have to add it in your settings file.

PLUGINS = (
    'microdata',
)

Once loaded you have access to microdata rst directives.

Directives

Microdata plugin provides two directives:

  • itemscope, a block directive allowing to declare an itemscope block:

    .. itemscope:: <Schema type>
        :tag: element type (default: div)
        :itemprop: optionnal itemprop attribute
        :compact: optionnal
    
        Nested content
  • itemprop, an inline directive/role allowing to annotate some text with an itemprop attribute.

    :itemprop:`Displayed text <itemprop name>`
    :itemprop:`Displayed text <itemprop name:http://some.url/>`

Example

This reStructuredText document:

.. itemscope: Person
    :tag: p

    My name is :itemprop:`Bob Smith <name>`
    but people call me :itemprop:`Smithy <nickanme>`.
    Here is my home page:
    :itemprop:`www.exemple.com <url:http://www.example.com>`
    I live in Albuquerque, NM and work as an :itemprop:`engineer <title>`
    at :itemprop:`ACME Corp <affiliation>`.

will result in:

<p itemscope itemtype="http://data-vocabulary.org/Person">
    My name is <span itemprop="name">Bob Smith</span>
    but people call me <span itemprop="nickname">Smithy</span>.
    Here is my home page:
    <a href="http://www.example.com" itemprop="url">www.example.com</a>
    I live in Albuquerque, NM and work as an <span itemprop="title">engineer</span>
    at <span itemprop="affiliation">ACME Corp</span>.
</p>
Something went wrong with that request. Please try again.