BibliographyPlugin Development Discussion

I've just uploaded first version.

One thing that came to my mind just after uploading is that the referencesTopic argument should accept a list of topics.

-- AntonioTerceiro - 18 Jun 2004

Could be updated to use the INCLUDE method to import citations, allowing citations to be maintained across multiple topics in a WEB e.g. %INCLUDE{"MyBookCitations"}% and then use %CITE{"SomethingFromThere"}%.

-- JasonShortt - 03 Aug 2004

I couldn't understand what you mean. In the current state you can INCLUDE topics and the citations there work like if they were made in the current topic.

But if you mean having multiple sources of references (using the referencesTopic argument) , I'm working on it right now.

-- AntonioTerceiro - 23 Aug 2004

It would be nice if there was a way to import BibTeX files as does the EmbedBibPlugin. Perhaps there would be a way to change or modify the output of EmbedBibPlugin so that it produces the tables necessary for BibliographyPlugin?

• Sorry, sligtly OT: I just found a plugin called BibtexPlugin at http://nats-www.informatik.uni-hamburg.de/view/TWiki/BibtexPlugin that seems to do exactly what I need. Is there any reason why it is not listed at TWiki.org? Has anyone tried if it works with Cairo?

-- ChristianKohl - 21 Sep 2004

PluginsConformanceReport reports BibliographyPlugin as using a deprecated handler: startRenderingHandler. TODO: check a way of implementing plugin's functionality without that.

-- AntonioTerceiro - 15 Aug 2005

UPDATE: deprecated handler issue fixed in SVN.

-- AntonioTerceiro - 02 Sep 2005

Antonio, please make sure that the Plugin works with the current production release and with Dakar. Many admins do not upgrade their TWiki for a long time.

-- PeterThoeny - 02 Sep 2005

I've made some changes to BibliographyPlugin, and am looking for feedback and suggestions. Part of my motivation is that I have a twiki with a separate topic for some of the references, so I'd like to use the name of that topic as the key for that reference, and be able to easily access the topic from any citation.

So far, I've added:

1. A new CITEFULL tag inserts the full citation for a key at the current position.
2. A new BIBLIOGRAPHYFULL tag inserts every entry in the specified bibliographies.
3. References can now be sorted by key (order="key").
4. Bib table rows can have a third column containing key=value pairs to reference external databases (e.g. ACM, Amazon, PubMed).
5. A numbered citation (e.g. [2]) can be linked to the topic.
6. A numbered reference can have a link to the topic, or to external sites (see above).
7. BIBLIOGRAPHY now has an optionString attribute to specify the label and URL for accessing external sites (see above).
8. BIBLIOGRAPHY can have multiple instances of referencesTopics and optionString attributes.

So a table entry like this:

1. A. Author. My Great Book. Full Court Press, 2006. (details) (Amazon) (B&N)

I've made a few changes that are not strictly backwards compatible; should I add enable/disable options, or can people live with them?

1. The header is only displayed when there are valid references; this is consistent with TOC behavior.
2. Bib table rows are skipped if the key is a heading or otherwise formatted.

I've attached the new versions (as Bibliography2Plugin). I'd appreciate any constructive feedback. I'd also be happy to try to make other changes while I'm at it.

-- ClifKussmaul - 08 Jun 2006

Here's an updated version with the enhancements described above.

The biggest issue I see now is performance - the same set of references could be assembled many times for a busy site, and could probably be cached. Suggestions welcome!

-- ClifKussmaul - 16 Jun 2006

I'd like one new feature, please. I'm not comfortable with perl to do it myself.

Many documents require more than one kind of references, or that the references be split, perhaps book references, Internet references. Modern documentation typically has normative references and non-normative.

The current plug-in does not allow for more than one list of references, if the %BIBLIOGRAPHY% tag is used more than once, the same list is produced. It would be good if it produced different lists given different sets of references topics. It would also be good to descriminate at the citation, something like %CITE{XML,Normative}%... What do you think?

-- MiguelLSRamos - 05 Mar 2007

Has anyone had any success with this Plugin with TWiki 4? I really want to upgrade to the newest but can’t go over without being able to cite references. I tried the other one but my hosted server doesn’t have Laxtex installed.

-- JasonBenedict - 28 Mar 2007

Miguel, I like your idea for multiple sets of references. If we can come up with a clear design and others agree that it would be valuable, I could try to make it work.

Jason, I'm running 4.0.2 and using Bibliography2Plugin. If you're having trouble, please describe what happens.

-- ClifKussmaul - 28 Mar 2007

Thanks...works a whole lot better when the Plugin is 'enabled'

-- JasonBenedict - 30 Mar 2007

• Bibliography2Plugin.txt: Bibliography2Plugin.txt

• Bibliography2Plugin.pm: Bibliography2Plugin.pm