# Getting Started

## Overview

A docutils backend for pybtex.

- Download: http://pypi.python.org/pypi/pybtex-docutils/#downloads
- Documentation: http://pybtex-docutils.readthedocs.org/
- Development: http://github.com/mcmtroffaes/pybtex-docutils/ |imagetravis| |imagecoveralls|

## Installation

Install the module with `pip install pybtex-docutils`, or from source using `python setup.py install`.

## Minimal Example

    import six
    import pybtex.database.input.bibtex
    import pybtex.plugin

    style = pybtex.plugin.find_plugin('pybtex.style.formatting', 'plain')()
    backend = pybtex.plugin.find_plugin('pybtex.backends', 'docutils')()
    parser = pybtex.database.input.bibtex.Parser()
    data = parser.parse_stream(six.StringIO(u"""
    @Book{1985:lindley,
      author =    {D. Lindley},
      title =     {Making Decisions},
      publisher = {Wiley},
      year =      {1985},
      edition =   {2nd},
    }
    """))
    for entry in style.format_entries(six.itervalues(data.entries)):
        print(backend.paragraph(entry))

would produce:

    <paragraph>
      D. Lindley. <emphasis>Making Decisions</emphasis>.
      Wiley, 2nd edition, 1985.
    </paragraph>