git.oblomov.eu Git - ikiwiki/blob - doc/todo/BibTeX.mdwn

   1 I would *love* to see a plugin that lets you create one or more BibTeX-formatted bibliography pages and add citations to other pages.  The plugin could also render the bibliographies themselves using a chosen BibTeX style and an HTML formatter for LaTeX (such as HeVeA).
   2
   3 --[[JoshTriplett]]
   4
   5 I work on a plugin to htmlize '.bib' files.
   6
   7 A sample result is shown on my webpage : <http://alexandre.dupas.free.fr/code/pub/>.
   8
   9 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.
  10
  11 This plugin uses two templates to render the html version of each file.
  12
  13 I have a problem to create a new page that render like any other page in the wiki. I have used the Ikiwiki's internal **genpage($$)** routine but I suppose that there is another way to do this. My method lack the backlink support for the individual entry files as well as the modification date of these file.
  14
  15 Is it possible to create several wiki page from only one source file?
  16
  17 The source of this plugin could be found on this page : <http://alexandre.dupas.free.fr/code/ikiwiki/> .
  18
  19 Feel free to propose any modifications to enhance this plugin.
  20
  21 --[[AlexandreDupas]]
  22
  23 I have not found any other approach to build several wiki page with only one source file. Does someone have an idea?
  24
  25 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?
  26
  27 --[[AlexandreDupas]]
  28
  29 > The scan hook is run on new page content before building --[[Joey]]
  30
  31 What notation did you have in mind for citations?  A preprocessor
  32 directive?  Something LaTeX-inspired might be
  33
  34     \[[!cite key="foo"]]
  35
  36 which would output "(Foo, 2008)".  With the appropriate options, this
  37 could allow for several variations like "Foo (2008)" and "(Foo, 2008,
  38 p. 28)".  A `nocite` option could cause the reference to be printed in
  39 the bibliography but produce no output.
  40
  41 What about the references section?  There are several ways to
  42 go about it, for example:
  43
  44 1. It could be included at the bottom of the page automatically for
  45    pages with references, with a configurable title and heading level
  46    (e.g., `<h2>References</h2>`) followed by a list of references.
  47
  48 2. Use another preprocessor directive like
  49
  50         ## References ##
  51
  52         \[[!bibliography ]]
  53
  54    or
  55
  56         \[[!bibliography title="References" headerlevel="2"]]
  57
  58    with configurable default values.  Would it be tedious to do this on
  59    every page?
  60
  61 3. Use HTML::Template and allow users to add a bibliography section to
  62    `page.tmpl` to include the bibliography if references are present and
  63    loop over the references to emit a list.  The downside here is having
  64    to ask people to modify their templates (unless the plugin is
  65    eventually included in the distribution).
  66
  67 Any thoughts on the best way to proceed?
  68
  69 --[[JasonBlevins]], March 23, 2008 21:41 EDT
  70
  71
  72 [[!tag soc]] [[!tag wishlist]]