Loading...
 

footnotes_references_discussion



Documentation

Features

  • Possible to have wiki syntax in the references below, which is useful for hyperlinks.
  • Like Wikipedia, you have links to go from the text to the reference and back. 1

Feature request

  • It should be possible to have, as an option, the reference list in the template (I don't want to copy the footnotearea plugin on each page).
    • Or maybe this should be a wiki page template per category of page? (ex.: if a page is in a category X, it uses the a wiki-page template, and this wiki page template has the footnote plugin at the bottom)
      • Or a feature per workspace

Questions


How can we make it future-proof so people may easily move to a tracker-based system?

It is possible to maintain these references in a tracker: Simple_Reference_Management to be able to eventually become a Bibliography management system (references)

Should this be a specialized implementation of a more general "note" plugin?

The general note plugin could have PluginMouseover, Pluginfade and Pluginfootnotes aka cite/ref as descendants or Signature and/or datestamp and/or approval-vote plugin/syntax. If we do keep separate, let's try to use the same names for the arguments

Should we have the references also available as a mouse-over?

And thus avoiding to scroll down and backup. References at the bottom would remain for printing though

Jean-Marc Libs It seems a good idea but after trying, I found it is a bad idea. The references are fully tiki-parsed. The class we use for automatic mouse-over is more limited to simple text. Plus, it splits between pop-up title and pop-up content after the first colon, which breaks the display of the mouse-over whenever there is a link containing "http://".
All in all, it makes things too complex. Having a referece which looks good in the footnoteare and also the mouse over would restrict the available markup.
Let's make mouse-over a separate thing from footnotes

Shouldn't we try to stay as close as possible to the MediaWiki/Wikipedia syntax?


Wikipedia uses2:
Syntax uses by Wikipedia for references
<ref>California State University 2007.</ref>



Syntax currently in 3.0 to generate a reference:
{FOOTNOTE()}This is quite an interesting concept{FOOTNOTE}

Syntax uses by Wikipedia to generate the reference list, with option to have 2 colums
{{reflist|2}}


Syntax currently in 3.0 to generate the reference list:
{FOOTNOTEAREA()/}

What other features from Wikipedia should we plan ahead for?



http://doc.tiki.org/PluginFootnotes
http://dev.tiki.org/wish1825
http://dev.tiki.org/wish1769
http://freshmeat.net/browse/1099/


A test

Wikipedia footnotes serve two purposes. First, they are used to add material that explains a point in greater detail, particularly if the explanation would be distracting if written out in the main article. Second, they are used to present citations to reliable sources that support assertions in the main article.3 As explained at Wikipedia:Citing sources, footnoting is one of several alternative ways to present citations.

More testing

Donec ante felis, dictum et, placerat nec, egestas ac, justo. Nunc commodo velit non urna mattis condimentum. Sed tincidunt, nulla at semper rhoncus, mi libero accumsan elit, ut auctor nunc metus ut velit. Vivamus vel velit. Maecenas molestie elementum neque. Sed laoreet nisl id tortor. Nulla facilisi. In hac habitasse platea dictumst. Nullam porta 4. Sed nec sem eu diam aliquam aliquam. Fusce non purus. Sed id risus. Phasellus non libero nec ante aliquet fermentum.

Fusce libero turpis, dictum at, pharetra ac, scelerisque ut, purus. Suspendisse elementum mattis ante. Nam vulputate magna id lorem. Sed eros. Aliquam pretium purus. Cras egestas ipsum a risus. Praesent purus nisl, vestibulum vitae, placerat vel, vehicula vitae, nulla. Phasellus eleifend. Integer turpis lacus, adipiscing nec, sodales in, accumsan vitae, nisi. Maecenas in leo. Sed mauris. Nam enim. Quisque interdum elementum magna. Nam arcu dui, placerat at, tincidunt nec, sagittis nec, est.

Etiam feugiat posuere turpis. Morbi leo mi, posuere non, aliquam vitae, vestibulum quis, mauris. Praesent iaculis, urna eget consequat semper, neque diam tincidunt magna, ut tempus massa est id erat. Integer nunc nulla, ornare sit amet, pharetra et, mattis nec, mauris. Donec orci sem, hendrerit et, tristique et, auctor lobortis, mauris. Nunc non eros ac enim sodales volutpat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec sed diam a tortor adipiscing fermentum. Praesent mollis cursus felis. Aliquam libero ligula, feugiat interdum, euismod at, dictum vel, felis. Proin sit amet pede. Mauris pellentesque.

Vestibulum ante ipsum primis in faucibus orci luctus5 et ultrices posuere cubilia Curae; Sed consectetur. Nunc nisl ante, sagittis suscipit, tincidunt eget, interdum at, turpis. Donec mattis neque nec lacus. Nulla a diam at arcu bibendum auctor. Fusce a dui. Aliquam eros. Mauris sagittis quam ac magna. Maecenas id mi in enim tempus ultrices. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.




1. This is not working as of 2009-02-13 working as of 2009-08-12 on profiles.tiki.org, but has been tested successfully on another site with a more recent version of trunk.
2. http://en.wikipedia.org/wiki/Wikipedia:Footnotes 3. Citing">http://en.wikipedia.org/wiki/Template:Reflist
3. Citing sources is important for improving the quality of Wikipedia's articles. A key content policy, Verifiability, says that any material that is challenged or likely to be challenged, including any contentious material about living people and all quotations, must have a source. Unsourced or poorly sourced material may be removed from any article, and if it is, the burden of proof is on the editor who wishes to restore it.
4. This is quite an interesting concept
5. This one, not so much.











Category: Documentation