]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/todo/BibTeX.mdwn
Merge branch 'master' into debian-jessie-backports
[git.ikiwiki.info.git] / doc / todo / BibTeX.mdwn
index d80cc895f0580143f6096ee05df1227c708e83fe..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,10 +16,59 @@ 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.
 
 --[[AlexandreDupas]]
 
 
 Feel free to propose any modifications to enhance this plugin.
 
 --[[AlexandreDupas]]
 
-[[tag soc]] [[tag wishlist]]
+I have not found any other approach to build several wiki page with only one source file. Does someone have an idea?
+
+I also try to build a wiki-wide preprocessing of the source file to find reference to my bib entry (citation) but apparently there is no wiki-wide preprocessing hook allowing to collect data from each page before building the site. Do I miss something?
+
+--[[AlexandreDupas]]
+
+> The scan hook is run on new page content before building --[[Joey]]
+
+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]]