=== Plugin Name ===
Contributors: tango
Donate link: 
Tags: formatting, bibtex
Requires at least: 1.5
Tested up to: 2.1.3
Stable tag: 0.7

bib2html enables to add bibtex entries formatted as HTML in wordpress pages and posts. The input data is the bibtex text file and the output is HTML. 

== Description ==

bib2html is my first Wordpress plugin. I needed a solution for publishing the list of my publications directly from the bibtex text file that I maintain. I wanted to avoid the maintance of many different representations of the same information (bibtex format, html format), that’s why this plugin.

bib2html enables to add bibtex entries formatted as HTML in wordpress pages and posts. The input data is the bibtex text file and the output is HTML. The entries are formatted by default using the IEEE style. Bibtex source file and a link to the publication are also available from the HTML.

Features:

* input data directly from the bibtex text file
* automatic HTML generation
* easy inclusion in wordpress pages/posts by means of a dedicated tag
* possibility of filtering the bibtex entries based on their type (allow, deny)
* possibility to access the single bibtex entry source code to enable copy&paste (toggle-enabled visualization)
* expose URL of each document (if network-reachable)
* possibility of editing the bibtex file directly from the wordpress administration page

The bib2html plugin has been developed and tested under Wordpress 2.0.3 and is being used with Wordpress 2.1.3.

== Installation ==

1. download the zip file and extract the content of the zip file into a local folder
2. copy your bibtex files in bib2html/data/ directory
3. upload the folder bib2html into your wp-content/plugins/ directory
4. log in the wordpress administration page and access the Plugins menu
5. activate bib2html

== Frequently Asked Questions ==

= Do you have plans to extend this pluging =

Yes, I've already a few contributions that I plan to add. You are welcome to post suggestions and requirements for further evolution.

== Screenshots ==

1. This is an example on how to use the tag into a page bib2html-tag.png
2. This is an example of the output from my blog bib2html-output.png


== A brief Markdown Example ==

When writing a page/post, you can use the tag [bibtex] as follows:

This is my whole list of publications: [bibtex file=mypub.bib]
If you want to filter the type of bibtex items, you can use the attributes allow, deny and key as follows:

This is my list of journal articles:
[bibtex file=mypub.bib allow=article]

This is my list of conference articles and technical reports:
[bibtex file=mypub.bib allow=inproceedings,techreport]

This is the rest of my publications:
[bibtex file=mypub.bib deny=article,inproceedings,techreport]

This is my latest conference paper:
[bibtex file=mypub.bib key=CGW2006]