# Getting Started

## Overview

# pybtex-docutils

A docutils backend for pybtex.

- Download: https://pypi.org/project/pybtex-docutils/#files

- Documentation: https://pybtex-docutils.readthedocs.io/

- Development: http://github.com/mcmtroffaes/pybtex-docutils/

## Installation

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

## Minimal Example

    import io
    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(io.StringIO(u"""
    @Book{1985:lindley,
      author =    {D. Lindley},
      title =     {Making Decisions},
      publisher = {Wiley},
      year =      {1985},
      edition =   {2nd},
    }
    """))
    for entry in style.format_entries(data.entries.values()):
        print(backend.paragraph(entry))

would produce:

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