{"library":"pybtex-docutils","title":"pybtex-docutils","description":"pybtex-docutils is a Docutils backend for the Pybtex bibliography processor. It enables the insertion of BibTeX citations into documentation generated by Docutils, particularly for reStructuredText. The current version is 1.0.3, and while releases are not on a strict schedule, the library is actively maintained.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install pybtex-docutils"],"cli":null},"imports":["from pybtex_docutils import SimpleBibliography","from pybtex_docutils import Backend"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import io\nfrom docutils.parsers.rst import directives, Directive\nfrom docutils.core import publish_cmdline, default_description\nfrom pybtex_docutils import SimpleBibliography\n\n# Create a dummy .bib file\nwith open('refs.bib', 'w') as f:\n    f.write('''\n@Book{Nelson1987,\n    author    = {Edward Nelson},\n    title     = {Radically Elementary Probability Theory},\n    publisher = {Princeton University Press},\n    year      = {1987}\n}\n''')\n\n# Create a dummy .rst file\nwith open('example.rst', 'w') as f:\n    f.write('''\n.. highlight:: python\n\nExample Document\n================\n\nSee {Nelson1987}_ for an introduction to non-standard analysis.\n\n.. simplebibliography:: refs.bib\n''')\n\n# Register the directive and publish the document\ndescription = ('Like rst2html5.py, but with .. simplebibliography support' + default_description)\ndirectives.register_directive(\"simplebibliography\", SimpleBibliography)\npublish_cmdline(writer_name='html5', description=description, argv=['example.rst', 'example.html'])\n\nprint(\"Generated example.html with bibliography.\")","lang":"python","description":"This quickstart demonstrates how to use the `simplebibliography` directive with a pure Docutils workflow. It generates a sample BibTeX file (`refs.bib`) and an reStructuredText file (`example.rst`), then uses a Python script to process `example.rst` into `example.html`, including the bibliography. This setup requires manually registering the `SimpleBibliography` directive with Docutils.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"1.0.3","pypi_latest":"1.0.3","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":2.2,"avg_import_s":0.21,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.19,"mem_mb":6.5,"disk_size":"25.5M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.1,"import_time_s":0.12,"mem_mb":6.5,"disk_size":"27M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.27,"mem_mb":7.5,"disk_size":"28.4M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.2,"import_time_s":0.23,"mem_mb":7.5,"disk_size":"30M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.23,"mem_mb":7.8,"disk_size":"20.1M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.1,"import_time_s":0.26,"mem_mb":7.8,"disk_size":"21M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.24,"mem_mb":7.9,"disk_size":"19.9M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.1,"import_time_s":0.23,"mem_mb":7.9,"disk_size":"21M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.16,"mem_mb":6.6,"disk_size":"25.3M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pybtex-docutils","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2.6,"import_time_s":0.15,"mem_mb":6.6,"disk_size":"26M"}]}}