User:Miranche/BiblioTex

This page helps me document work on the merger of extensions Biblio and BibTex I am working on.

Name
The working name of this extension is a portmanteu of the names of two extensions it merges. I like it, but there is a shareware program with the same name. On the other hand, since I'm building up from Biblio which hasn't been updated in a few years, I'm trying to track down the maintainers to see if it makes sens for me to take it over.

Data Sources and Formats

 * Done
 * Extend PubMed requests to handle DOIs
 * Get rid of dependence on SOAP in favor of CGI requests
 * use SimpleXML to process Web query results rather than purpose-written XML parsers
 * Standardize representation of data retrieved by PubMed & ISBNdb.com requests, using data structures modeled on BibTeX
 * Parse author names correctly depending on data source, breaking them into first, last, "von" and "jr" parts as described in BibTeX documentation (Tame the BeaST)
 * Extend &lt;biblio&gt; tag parser to accept BibTeX entries (already largely implemented in the NMR version) and to recognize and handle plain BibTex syntax
 * Provide a way to look for and source BibTex files from a location in the file system


 * Planned
 * Get citations from other repositories, see Extension:Bibwiki for possibilities (Amazon, Arxiv etc)
 * Standardize the API of generating citations from external sources and/or files, provide a way for users to program in their own source types.
 * Output COinS: see http://ocoins.info/, Citation and Citation core templates in wp
 * If necessary, consider changing the underlying data structure from BibTeX-based to something more general, and/or provide support for less-than-standard BibTeX entry types. JabRef provides @electronic, @patent, @periodical and @standard.

Display of Citations

 * Done
 * Write a general bibliography entry renderer expecting a BibTeX-like data structure, unify BibTex, PubMed and ISBN &lt;biblio&gt; entries to use it
 * Support different citation styles: Chicago author-date & humanities, APA, AMA, MLA
 * Create a citation style ("biblio-2006") that defines the legacy biblio display


 * In progress
 * Special characters seem to prevent "BibTeX" popup. See citations by Daniken, Tilberg & Pakarati
 * Several citation styles are unfinished:
 * MLA, APA & AMA don't have @inbook, @techreport, @manual
 * Create a citation style ("wikipedia") that generates & parses a Cite template


 * Planned
 * Display in-text links by name, sorted in name-author format
 * Complete all standard cit types above, esp: improve @techreport (also implement @periodical?)
 * Generalize output decorators
 * Handle semi-standard bibtex attributes that can "decorate" the citation with links & popups, e.g. annot, abstract, ps, pdf, url
 * Expand citation styles to meta-styles which include
 * Citation style (generates text only)
 * In-text link style (numeric vs author-date, possibly part of citation style)
 * Set of decorators (adds bells & whistles to citation text while & after it's created, inclu. headers & footers)
 * Create meta-styles that mimic full legacy &lt;bibtex&gt; and &lt;biblio&gt; output

MediaWiki Integration

 * Done
 * Add BibTeX namespace, meant for BibTeX & Biblio source information
 * Optionally display citation titles as links to the individual citation pages, which may in turn link or redirect to custom annotation pages within the Wiki. (Similar to RefHelper but without automagically creating pages.)
 * Pre-load the content of a citation page when it's first edited
 * Create a citation style ("wikititle") that defines the default title of the annotation page
 * Optionally combine Biblio & Cite/Cite.php syntax if Cite is present:
 * Handle &lt;cite&gt; tags as named &lt;ref&gt;s
 * Allow the &lt;biblio&gt; section to appear within &lt;references&gt;, or to double as &lt;references&gt;


 * In Progress
 * Full integration with Cite numbered links
 * Handle &lt;nocite&gt; links correctly: allow for citations with no references in the text
 * In absence of Cite, still provide Cite-like anchors between &lt;biblio&gt; citation list and text
 * Unify Cite and Biblio error display?
 * Clean up makeUrl & calls to local wiki pages


 * Planned
 * Extend Cite class to create author-name in-text links for &lt;ref&gt;s that use appropriate templates
 * When Cite is present, possibly treat &lt;bibtex&gt; tag as a named &lt;ref&gt;?
 * Unify CSS, make styles consistent with those used in MediaWiki, Extension:Cite and Template:Citation
 * Where appropriate, use DOM, SimpleXml and/or MediaWiki Xml functions to generate XML content, rather than just strings

Compatibility

 * In progress
 * Use parse instead of recursiveTagParse prior to 1.8
 * Make sure original &lt;bibtex&gt; and &lt;biblio&gt; syntax work
 * &lt;biblio&gt;: sourcing URLs: wiki, interwiki & external
 * &lt;bibtex&gt;: in-text citation, help output, pasting bibtex templates into the edit window (esp. on Iexplore)


 * Planned
 * Test in other browsers, esp. IE7 and IE8
 * Google Scholar bibtex compatibility ("hack to remove extra braces?")
 * Try installing on Mac OS X & (maybe) Windows
 * Test in the oldest mediawiki version still used by Biblio users

Links

 * Mediawiki


 * Extension:Biblio
 * Extension:Bibtex
 * Extension:Bibwiki
 * Extension:Cite/Cite.php
 * Extension:RefHelper


 * Authors and Users


 * http://openwetware.org/wiki/Wikiomics:Biblio
 * http://gsc2.cemif.univ-evry.fr/index.php/Mediawiki_extensions
 * http://nmrwiki.org/wiki/index.php?title=Help:Biblio_Extension
 * http://nmrwiki.org/wiki/index.php?title=Using_BibTex_in_NMRWiki
 * http://www.hodgeslab.org/2010/02/php_mediawiki_biblio_and_nusoa.html (test case on mac)
 * http://neurov.is/on/Help:Creating_citations
 * http://neurov.is/on/Cite:Gray_Atkinson_2003
 * http://neurov.is/w/index.php?title=Special:RefSearch
 * http://neurov.is/w/index.php?title=Special:RefHelper


 * BibTex


 * BibTeX entry types
 * http://www.kfunigraz.ac.at/~binder/texhelp/bibtx-7.html
 * http://www.lsv.ens-cachan.fr/~markey/bibla.php
 * http://artis.imag.fr/~Xavier.Decoret/resources/xdkbibtex/bibtex_summary.html
 * http://www.math.utah.edu/~beebe/bibliographies.html
 * http://ftp.math.utah.edu/pub//emacs/bibtex-mods.el


 * Citation Style Guides


 * http://www2.liu.edu/cwis/cwp/library/workshop/citation.htm
 * http://library.hsu.edu/Tutorial/
 * http://www.chicagomanualofstyle.org/tools_citationguide.html
 * http://www.umuc.edu/library/guides/chicago.shtml