Skip to topic
|
Skip to bottom
IST-15905
Mobius
Home
Summary
Partners
Work Packages
End User Panel
Scientific Advisory Board
Publications
Deliverables List
Links to Related Projects
Events
News
Visitors: 102
Intranet
Scientific Issues
Scientific Exchanges
Dissemination & Publication
Scientific Deliverables
Tool Development
Inria GForge
Project Management
Calendar
Contractual Documents
Reporting Activity
Project Status
Meetings
Kick-Off Meeting
Annual Meeting
Website information
Admin
MobiusLogo
EmailLists
Help
Tools
Search
Changes
Help Home
Sandbox
Trash
TWiki Home
Start of topic |
Skip to actions
---+ EmbedBibPlugin This is a plugin that you can use to embed <nop>BibTeX entries in TWiki webs. It uses [[http://www.lri.fr/~filliatr/bibtex2html/][bib2bib]] and [[http://www.lri.fr/~filliatr/bibtex2html/][Bibtex2html]] ---++ Syntax Rules * %<nop>EMBEDBIB{topic="string" style="string" bibfile="string" sort="string" select1="string (string)" select2=...}% * EMBEDBIB uses the <nop>BibTeX file defined in _bibfile_ * The _bibfile_ must be attached (be in the twiki pub directory) and have the path _topic_ * _style_ can be HTML formatted text (html) or raw text (bibtext) * _topic_, and _style_ can be omitted. The plugin will use the preferences variables defined in <nop>EmbedBibPlugin Global Settings * If the _style_ is html, _sort_ can be used to sort the entries by year or by name. The parameter can take the following values: "by-date", "as-bibtex", "unsorted", "reverse" or a combination of them separated by a space, for instance "by-date reverse". If the _style_ is bibtex, _sort_ is ignored * _select1_, _select2_, _select3_, and _select4_ are used to select the <nop>BibTeX entries. _select1_ is mandatory while the others are optional. * The format of _selects_ is: selectx="filter_condition". Examples of filter_condition is "author : \"Barthe\" and year >= 2003" (more examples can be found in [[http://www.lri.fr/~filliatr/bibtex2html/][bib2bib]] manual). ---++ Examples * %<nop>EMBEDBIB{webname="Sandbox" style="html" bibfile="Sandbox/cite.bib" select1="author : \"Einstein\""}% * Use Sandbox/cite.bib as the <nop>BibTeX file * Embeds all of the references from the <nop>BibTeX file which have Einstein in the author field * Format the embedded text as html * %<nop>EMBEDBIB{bibfile="Publications/cite.bib" select1="author : \"Einstein\" or author : \"Fermi\"" select2="year = 2003"} * Use Publications/cite.bib as the <nop>BibTeX file * Embeds all of the references from the <nop>BibTeX file which have Einstein or Fermi in the author field and 2003 in the year field * Format the embedded text as DEFAULTSTYLE ---++ <nop>%TOPIC% Global Settings Plugin settings are stored as preferences variables. To reference a plugin setting write ==%<nop><plugin>_<setting>%==, for example, ==%<nop>EMBEDQTPLUGIN_SHORTDESCRIPTION%== * One line description, shown in the %TWIKIWEB%.TextFormattingRules topic: * Set SHORTDESCRIPTION = Embeds <nop>BibTeX entries in a TWiki page * Debug plugin: (See output in =data/debug.txt=) * Set DEBUG = 0 * Default web name for <nop>BibTeX files: * Set DEFAULTWEBNAME = TWiki * Set DEFAULTOUTPUTFILE = publis.bib * Set TABOOFILE = BibFiles * Default topic name for <nop>BibTeX files: * Set DEFAULTTOPICNAME = EmbedBibPlugin * Default style (bibtex or html): * Set DEFAULTSTYLE = html * Default sorting method (year or name): * Set DEFAULTSORT = year ---++ Plugin Installation Instructions __Note:__ You need to install [[http://lml.ls.fi.upm.es/manuales/bibtool/][BibTool]] and [[http://www-sop.inria.fr/epidaure/personnel/malandain/codes/bibtex2html.html][Bibtex2html]] on the server. The commands bibtool and bibtex2html must be in the path of the process that runs the TWiki scripts. If they are not in the path, change *$bibtoolPath* and *$bibtex2htmlPath* in *lib/TWiki/Plugins/EmbedBibPlugin.pm* to point to the correct location. The following instructions are for the administrator who installs the plugin on the server where TWiki is running. * Download the ZIP file from the Plugin web (see below) * Unzip ==%TOPIC%.zip== in your twiki installation directory. Content: | *File:* | *Description:* | | ==data/TWiki/%TOPIC%.txt== | Plugin topic | | ==data/TWiki/%TOPIC%.txt,v== | Plugin topic repository | | ==lib/TWiki/Plugins/%TOPIC%.pm== | Plugin Perl module | | ==pub/TWiki/EmbedBibPlugin/sample.bib==| Plugin sample <nop>BibTeX file | | ==pub/TWiki/EmbedBibPlugin/sample.bib,v==| Plugin sample <nop>BibTeX file repository | * Test if the plugin is correctly installed: * A list of <nop>BibTeX entries: %EMBEDBIB{bibfile="Publications/full.bib" select1="author : \"Forest\"" sort="by-date reverse" }% ---++ Plugin Info | Plugin Author: | TWiki:Main/DonnyKurniawan | | Plugin Version: | 24 Sep 2003 (V1.000) | | Change History: | <!-- versions below in reverse order --> | | 24 Sep 2003: | Initial version | | CPAN Dependencies: | none | | Other Dependencies: | [[http://lml.ls.fi.upm.es/manuales/bibtool/][BibTool]] and [[http://www-sop.inria.fr/epidaure/personnel/malandain/codes/bibtex2html.html][Bibtex2html]] | | Perl Version: | 5.005 | | Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC% | | Feedback: | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev | __Related Topics:__ %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins -- TWiki:Main/DonnyKurniawan - 24 Sep 2003
End of topic
Skip to action links
|
Back to top
r1.8 :
Edit
|
Attach image or document
|
Printable version
|
Raw text
|
Page history
|
More actions
You are here:
TWiki
>
EmbedBibPlugin
to top
Ideas, requests, problems regarding the Mobius site