This is a collection of utilities to help with generating documentation for Beanbag-related products, including:
Review Board - Our widely-used open source code review product.
RBCommons - Our Review Board SaaS.
Djblets - A set of utilities and infrastructure for Django-based projects.
RBTools - Command line tools for Review Board and RBCommons.
Sphinx Extensions
Most of the utilities are used with the Sphinx documentation system. Amongst other enhancements, this package offers:
A parser for the Beanbag docstring format (a variation on the Google docstring format), which we use for Python and JavaScript documentation
Enhancements for Sphinx’s intersphinx system to provide per-page intersphinx resolution options (useful for pages, such as release notes, that need to link to different versions of the same docs, such as Django or Python)
Enhancements to ReStructuredText references to let a reference name span lines (useful for long Python/JavaScript module/class names)
Linking code references to GitHub documentation
High-DPI image embedding
A role for HTTP status codes
Access to document-defined metadata in a structured form when parsing documents
Compatibility
beanbag-docutils 2.x supports Python 3.6-3.12 and Sphinx 1.8-7.x.
beanbag-docutils 1.x supports Python 2.7 and 3.6-3.10.
Getting Started
To install the package, run:
$ pip install beanbag-docutilsSee the documentation for usage information.
Release files for beanbag-docutils 2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| beanbag-docutils-2.4.tar.gz | 36.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| beanbag_docutils-2.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 83.0 kB
Release files / beanbag-docutils-2.4.tar.gz
| Download URL | beanbag-docutils-2.4.tar.gz |
|---|---|
| Size | 36.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a331ef7f31a447ac1062c69f82d78c8c3e3058eaaa835c84b23f6062386c97df
|
|
BLAKE2b-256 checksum How to use checksums |
116411130ea6693fc34e44a3286c23627c3df3ed337ce7f934a207795452e4d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.9.13
|
Release files / beanbag_docutils-2.4-py3-none-any.whl
| Download URL | beanbag_docutils-2.4-py3-none-any.whl |
|---|---|
| Size | 46.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
813c5c98ad6095c9fd466c5e69ed7abfee2dde93824ad762682f064ced8e49a1
|
|
BLAKE2b-256 checksum How to use checksums |
12c502899d2fbb4d3013b6b53638b9ae9afbf991915962bf87aab1e64f5fcf2c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.9.13
|
