]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/todo/BibTeX.mdwn
Test checkconfig().
[git.ikiwiki.info.git] / doc / todo / BibTeX.mdwn
index d471b0e8298104d38f11a19dfa99c08a7e83a36f..16aa1a0f91e0edd9a89caf968e53903773f99bcf 100644 (file)
@@ -2,9 +2,11 @@ I would *love* to see a plugin that lets you create one or more BibTeX-formatted
 
 --[[JoshTriplett]]
 
 
 --[[JoshTriplett]]
 
+> There is such a plugin at [[plugins/contrib/bibtex|plugins/contrib/bibtex]]. --[[MatthiasIhrke]]
+
 I work on a plugin to htmlize '.bib' files.
 
 I work on a plugin to htmlize '.bib' files.
 
-A sample result is shown on my webpage : <http://alexandre.dupas.free.fr/code/pub/>.
+A sample result is shown on my webpage : <http://www.adupas.org/research/publications/>.
 
 It features the htmlization of the bibtex with 4 types of entry supported (InProceedings, Article, MastersThesis and PhdThesis). I will add the book entry support soon. It creates for each '.bib' file an html version, and for each entry a specific page with abstract as well as an individual bib file. It lack some features like the possibility to have a pdf or ps version of the article attached.
 
 
 It features the htmlization of the bibtex with 4 types of entry supported (InProceedings, Article, MastersThesis and PhdThesis). I will add the book entry support soon. It creates for each '.bib' file an html version, and for each entry a specific page with abstract as well as an individual bib file. It lack some features like the possibility to have a pdf or ps version of the article attached.
 
@@ -14,7 +16,7 @@ I have a problem to create a new page that render like any other page in the wik
 
 Is it possible to create several wiki page from only one source file?
 
 
 Is it possible to create several wiki page from only one source file?
 
-The source of this plugin could be found on this page : <http://alexandre.dupas.free.fr/code/ikiwiki/> .
+The source of this plugin could be found on this page : <http://www.adupas.org/software/ikiwiki/> .
 
 Feel free to propose any modifications to enhance this plugin.
 
 
 Feel free to propose any modifications to enhance this plugin.
 
@@ -28,4 +30,45 @@ I also try to build a wiki-wide preprocessing of the source file to find referen
 
 > The scan hook is run on new page content before building --[[Joey]]
 
 
 > The scan hook is run on new page content before building --[[Joey]]
 
-[[tag soc]] [[tag wishlist]]
+What notation did you have in mind for citations?  A preprocessor
+directive?  Something LaTeX-inspired might be
+
+    \[[!cite key="foo"]]
+
+which would output "(Foo, 2008)".  With the appropriate options, this
+could allow for several variations like "Foo (2008)" and "(Foo, 2008,
+p. 28)".  A `nocite` option could cause the reference to be printed in
+the bibliography but produce no output.
+
+What about the references section?  There are several ways to
+go about it, for example:
+
+1. It could be included at the bottom of the page automatically for
+   pages with references, with a configurable title and heading level
+   (e.g., `<h2>References</h2>`) followed by a list of references.
+
+2. Use another preprocessor directive like
+
+        ## References ##
+
+        \[[!bibliography ]]
+
+   or
+
+        \[[!bibliography title="References" headerlevel="2"]]
+
+   with configurable default values.  Would it be tedious to do this on
+   every page?
+
+3. Use HTML::Template and allow users to add a bibliography section to
+   `page.tmpl` to include the bibliography if references are present and
+   loop over the references to emit a list.  The downside here is having
+   to ask people to modify their templates (unless the plugin is
+   eventually included in the distribution).
+
+Any thoughts on the best way to proceed?
+
+--[[JasonBlevins]], March 23, 2008 21:41 EDT
+
+
+[[!tag soc]] [[!tag wishlist]]