bb4dw is heavily inspired by the family of publistX plugins (e.g. publist, publistx, publistf, etc.), and tries to closely match their features while using a modern engine to process Bibtex entries.

For Bibtex processing, the BibBrowser library is used, which provides very fast and effective processing of entries. We intentionally use BibBrowser in library mode, avoiding using its own inbuilt HTML generator and styling. Instead, the bib2tpl templating functions are reused here, allowing users to create their own templates.

Installation is easypeasy, either:

• search for and install the plugin using the Extension Manager, or
• refer to Plugins on how to install plugins manually.

There are no external dependencies for the bb4dw plugin.

A typical template is of the form:

@{group@
=== @groupkey@ ===
@{entry@
  * @entrykey@ ...
@}entry@
@}group@

Where @{group@…@}group@ and @{entry@…@}entry@ are used to group entries together. For each level there is a @groupkey@ and @entrykey@ field, which respectively map to the plugin's groupby key and Bibtex key.

Basic syntax:

[bb4dw|bibtex=TYPE:SOURCE|template=TYPE:SOURCE|extra=options]

• required
  • bibtex for selecting the Bibtex source
  • template for selecting the template
  • TYPE is either dokuwiki (or url TODO)
  • SOURCE is the path or URL (can also be relative in case of type dokuwiki)

Special extra options:

• key=… can be used to uniquely label for better handling of HTML ID specifying, especially useful in context of Javascript. The key value is exposed in the template as @globalkey@.

Currently, the only plugin level configurations are:

• enforcing caching or not (to reduce load times for the page, especially useful if your Bibtex is very large)

The source code of the plugin is available at GitHub: https://github.com/hv15/bb4dw.

• fix templating wrong variable (2024-01-07 05:59)
• add globalkey for tabbing (2024-01-06 18:34)
• add filtering (2024-01-06 16:56)
• fix missing entrykey parsing (2024-01-06 14:08)
• add bibtex raw to output (2024-01-06 14:00)
• add dokuwiki conf for caching (2024-01-06 06:46)
• add support for parsing further options (2024-01-06 06:46)
• expand groupby options (2024-01-06 06:30)

[this section might not be needed in case of external bug manager, or use RSS feed]

• add support for url type

If you have any questions not answered here, please open an issue in the repo.