This is an old revision of the document!
Table of Contents
RefNotes Discussion Archive
Missing popup in Angua
I have a localhost wiki with the latest (Angua) version installed. When I upgraded, I noticed that the mouseover tooltip popup is now longer displaying. I have also tested this with a clean install (not an upgrade install) and just this one plugin, and get the same result. If I uncheck “Use footnotes syntax”, then the tooltips work as expected, but also the named footnotes (((name>footnote text))
) render as the name, and not the footnote itself. — Ashtagon 2012/02/25 23:29
In Angua there were significant changes in JavaScript, some of which are apparently breaking backward compatibility. I guess that's the reason for missing popup.
The “Use footnotes syntax” check box behavior is correct. When you uncheck it ((text))
syntax is handled by DokuWiki core (not by the plugin), so you get properly working popup but loose all extra features provided by the plugin (e.g. named notes). — Mykola Ostrovskyy 2012/02/26 16:35
Fixed in version 2012-07-15. — Mykola Ostrovskyy 2012/07/15 22:59
Use with data plugin
Is it possible to combine this with the data plugin, or another structured/semantic plugin? I would love to have one page for each publication (automatically generated, optionally with additional notes on etc), with a ref table on each. If I could use the data plugin to store the reference information, I could also generate lists of publications by author, by keyword, etc. — houshuang 2011/04/30 03:32
Sounds interesting, but currently there are no plans for such integration. — Mykola Ostrovskyy 2011/05/04 10:57
Implemented in version 2012-07-15. — Mykola Ostrovskyy 2012/07/16 00:13
Hack to hide namespaces
I prefer that the namespaces in the reference database sheets and cards be hidden. I was able to make it work by hacking refnotes/namespace.php
, inserting the following around line 28:
function refnotes_parseName($name) { + $name = trim($name,'[]'); // hack to allow links as note names. This will strip [[]] surrounding names $pos = strrpos($name, ':');
It allows you to use internal links, such as [[:ref:Knuth68]], for note names–refnotes will ignore the surrounding brackets with this hack. It works because DokuWiki hides internal link namespaces.
With this change your reference database may look like1):
Note name | Note text |
---|---|
Knuth68 | Knuth, Donald E. The Art of Computer Programming, Volume 1: Fundamental Algorithms, First edition, Addison-Wesley, 1968, ISBN 0-201-03801-3. |
Knuth69 | Knuth, Donald E. The Art of Computer Programming, Volume 2: Seminumerical Algorithms, First edition, Addison-Wesley, 1969, ISBN 0-201-03802-1. |
Fowler99 | Fowler, Martin; Beck, Kent; Brant, John; Opdyke, William; Roberts, Don. Refactoring: Improving the Design of Existing Code, Addison-Wesley, 1999, ISBN 0-201-48567-2. |
— Rik Blok 2011/02/14 05:08
I have a bad feeling about this hack.
From looking around the source it seems to me, that this function is also used for lookups in the ref-database - so this might/should break namespaces in some way.
Maybe a more appropriate place to hack this is in refnotes/syntax/references.php
line 715, 721 (or rather 188? dunno…). Looks more like the place, where the entries are rendered to the page.
— bjoernX 2011/04/22 08:24
Multibyte languages support
Can't handle multibyte language? When I use Chinese for namespace, I can't create pages under it. When using Engligh, everything is OK. — lainme 2010/05/13 15:18
I'm not sure what you mean by “I can't create pages under it” as RefNotes namespaces have nothing to do with pages. Nevertheless you are right, multibyte languages are currently not supported. — Mykola Ostrovskyy 2010/05/24 19:24
Note block formatting issues
Hi,
Thanks for the excellent work done with this plugin. My only issue is that if I try to add a References section per your example, I get a double underline between the header of the section and the references per se: one is coming from the section formatting, the other from the REFNOTES formatting. Any trick to solve this? The solution previously suggested (in previous Discussions) is not working.
— Sylvain Foisy 2010/05/03
Did you try notes block separator style? For example:
===== References ===== <refnotes ref> notes-separator: none </refnotes>
Of course, you can also set this style in the configuration if you want to disable the separator permanently for a given namespace. — Mykola Ostrovskyy 2010/05/07 14:50
Hi,
Thanks for the input I try the block separator routine but no success.
— Sylvain Foisy 2010/05/09
Nevermind… I goofed with the namespace Everything looks great now. Keep up the good work!
— Sylvain Foisy 2010/05/10
Namespaces confusion
Sorry I can't understand this. The preset namespace on the configuration page is :refnotes: and my database page is :refnotes:johnson1985. Now what note name am I supposed to give the entry? johnson1985, :ref:johnson1985, :refnotes:ref:johnson1985? I tried all variants but neither is working.
I tried to elaborate a bit on the difference between DokuWiki and RefNotes namespaces. Hope that helps. — Mykola Ostrovskyy 2010/04/11 23:45
Thanks, it is much clearer now. However, it is still not working when I do this:
On the page :refnotes:programming I insert a note.
Note name | Note text |
---|---|
:ref:Knuth68 | Knuth, Donald E. The Art of Computer Programming, Volume 1: Fundamental Algorithms, First edition, Addison-Wesley, 1968, ISBN 0-201-03801-3. |
On another page I insert the [(:ref:Knuth68)]. This gives me a reference but then the note is not rendered at all when I add the note block using ~~REFNOTES~~. As opposed to that, when I add [(:ref: > This is a note.)] after the first reference, it is rendered correctly as note 2 (while note 1 is missing).
Am I missing something?
One thing to check is if configuration is okay:
- The database is enabled (by default it's off).
- The database namespace is
:refnotes:
.
Another is to verify that refnotes:programming
page is mentioned in the page index (/data/index/page.idx
). This index is used by the plugin to discover the database pages.
If both are true, then there might be something wrong. Report it on the bugtracker. — Mykola Ostrovskyy 2010/04/12 16:14
Complete formatting for inline notes
I tried to use bug tracker but I have yet to figure out how I can specify the plug-in, and what type of defect it is. I post my request here, just in case.
Inline notes can not be formatted completely in the configuration editor. Superscript for example seems to be enabled permanently. It would be best if all formatting could be done in the configuration editor.
— Tammo 2010/04/05
See the rest of this discussion on the bug tracker. — Mykola Ostrovskyy 2010/04/18 17:18
More flexible formatting for inline notes is added in version 2012-07-15. — Mykola Ostrovskyy 2012/07/15 22:59
Error after editing page
I get the following error(s) after I simply edited a page that contains references. The page displayed without problems. The editing was restricted to editing text (not references). The error messages are
- Warning: Cannot use a scalar value as an array in […]\DokuWikiStick\dokuwiki\lib\plugins\refnotes\syntax\references.php on line 242
- Warning: Cannot modify header information - headers already sent by (output started at […]\DokuWikiStick\dokuwiki\lib\plugins\refnotes\syntax\references.php:242) in […]\DokuWikiStick\dokuwiki\inc\common.php on line 1472
After closing the page and reopening it, everything displays fine. Simply reloading does not work. This is a rather annoying problem. Otherwise this is a great plugin. Thank you for your work.
Tammo 2010/04/02
It might be fixed in the latest version. If the problem persists, please report it on the bug tracker. — Mykola Ostrovskyy 2010/04/05 20:22
This seems to have fixed it. Thank you.
Configuration page doesn't work
The Configuration RefNotes gives error corrupted data from the server and I can not configure it. Installation without problems with the Manager plugins. This happens in Release 2009-12-25c “Lemming” of DokuWiki.
Any ideas? — Anonymous 05/11/2010
The only obvious thing that comes to my mind is to reinstall and try again. If that doesn't resolve the problem, please report it on the bug tracker. — Mykola Ostrovskyy 2010/05/24 19:14
I have the exact same problem in release 2011-11-10 No way to change the setup. The installation worked fine. I reinstalled, and obtained the same result. I wonder what to do. Michel 2012-01-01
There was an unreleased fix for webhosts that add extra stuff to served pages. If you don't run your own HTTP server, you could try to update action.php and admin.js to their latest versions. — Mykola Ostrovskyy 2012/01/12 08:06
Note blocks
Hi I'm just a little confused with how to get the reference section like you did in the screenshot. Could you give the code you used? Specifically I want to have a References
section with all my citations just like Wikipedia does.
Also the ~~REFNOTES~~ doesn't seem to work (i.e. doesn't place the note block where I put this tag) unless it's specified with the namespace (i.e. ~~REFNOTES cite~~ works fine.)
– Marc 20-Jan-10
Just create a section and put ~~REFNOTES ns~~
in it:
===== References ===== ~~REFNOTES ref~~
As mentioned in the documentation, ~~REFNOTES~~
without namespace specification renders notes from the root namespace. If all your notes are in cite
namespace ~~REFNOTES~~
will not render anything. — Mykola Ostrovskyy 2010/01/20 08:22
Ok I understand it better now. I guess I was confused by the huge amount of documentation and jargon. Thanks! The plugin works perfectly. — Marc 2010/01/21
Notes from reference database are not rendered
Could you give an example (ideally live) of linking to the reference database from an article?
I have…
- configured the reference database to use the :ref: namespace
- added bibliographic reference information in a card in :ref:longley2005 (using the namespace template)
Note name | :ref:longley2005 |
---|---|
Note text | Longley, Paul A. Goodchild, Michael F. Maguare, David J. & Rhind, David W., 2005. Geographic Information Systems and Science. 2nd ed. Chichester: John Wiley & Sons Ltd. |
- linked to this in an article [(:ref:longley2005)]
- nothing! no note text appears in the article
— Anonymous 2009/10/03 20:19
From what you describe this is exactly how it's supposed to work. Please create an issue on the bug tracker and I will try to fix it. — Mykola Ostrovskyy 2009/10/04 16:22