publist plugin

Download and install the plugin using the Plugin Manager using the URL given above. Refer to Plugins on how to install plugins manually.

Note that publist is pretty much only a wrapper of bib2tpl. Therefore, most problems considering the actual work is most certainly caused by a bug or deficiency of bib2tpl. Please check wether you have the latest bib2tpl – and correct templates – installed and use bib2tpl's bugtracker for issues related to it.

For issues that are definitely caused by the DokuWiki part of publist, please use publist's bugtracker rather than this site. I will probably not check it for bugreports.

Put the following on a page:

[publist|$sourceB:$nameB|$targetT:$sourceT:$nameT]

with

• $sourceB
  Can be file or page
• $nameB
  Name of a BibTeX file in plugin subfolder bibtex or ID of a wiki page that contains (only) BibTeX code
• $targetT
  Can be html or wiki
• $sourceT
  Can be file or page
• $nameT
  Name of a template file in plugin subfolder template or ID of a wiki page that contains (only) template code

Note:

• Relative page IDs work
• If you choose wiki target, DokuWiki's markup renderer is used on the conversion result. Otherwise, the code is inserted as is.

Additionally, publist can relate all options that bib2tpl understands. Just append the options you want to specify to the other stuff in any order you want; syntax for one options is as follows:

|$name:$value

For possible names and values, please check the bib2tpl documentation. The only special thing is filter specification. Learn by example:

• |only:author=doe
• |only:author=doe,sue
• |only:entrytype=book
• |only:author=doe,sue;entrytype=book

Note that comma-separation implies an or while semicolon-separation implies and. That is, the last example only allows only books written by Doe or Sue. Note also that the individual values are used inside a case-insensitive regexp (/$value/i). You can use the power that gives you, but be careful.

Have a look at those more complete examples:

• [publist|page::internal:bibtex|wiki:file:simple.tpl]
• [publist|page:bibtex|html:file:easy.tpl|group:firstauthor|order:asc]
• [publist|file:lib.bib|wiki:page:template|only:author=doe|group:year|lang=de]

Stuff bib2tpl can not understand is silently ignored as long as you provide the necessary core stated above.

For explanation of the syntax and examples, see here.