| At line 3 changed one line |
| Having edited[1] quite a few documents on Wikipedia, I have to put in a bid for a standardised way on including references within a wiki. This ought to be something simple ??How not to create a standard by M.S.Wolf??. |
| There is a need in most wikis to include references in the text which are expanded at the bottom of the text. The typical format is as follows: |
| At line 5 changed one line |
| (1) How not to create a standard by M.S.Wolf. |
| {{{This is some text I have to explain[3]}}} |
| At line 7 changed one line |
| -- [[Isonomia]] 2007, Apr, 28 |
| In line with the double character tags used by creole, the obvious tag to use is one that refers to a number namely '##'. Whilst this may conflict with some who use ## for monospace, this use is far from intuitive whilst # representing a number is. |
| At line 9 changed one line |
| Wikipedia uses a system that is far from fathomable. At the point of citation in the main text, enter the reference or footnote like this: |
| So, the proposal is to have the markup in the form: |
| At line 11 changed one line |
| {{{ <ref>Excel For Dummies, First Edition, Hungry Minds, Inc., 1980.</ref> }}} |
| {{{ This is some text I have to explain ##My explaination##}}} |
| At line 13 changed one line |
| To cite the same reference or footnote several times, identify it using the name parameter of the <ref> tag: |
| which would produce a number [1], [2], for each new such markup with the proviso that any equivalent 'My explanation' (case insensitive - alphanumeric only compare i.e. not spaces or any punctuation) would result in the same number as the first. |
| At line 15 changed one line |
| {{{ <ref name="Perry">Perry's Handbook, Sixth Edition, McGraw-Hill Co., 1984.</ref> }}} |
| To avoid lengthy repetitions of equivalent "explanations", the proposal makes provision for a label using the format:- |
| At line 17 changed one line |
| Then, at all the other citation points just enter: |
| {{{##This is the text I have to explain | Label###}}} |
| and future references to the same explanation would simply be in the form: |
| {{{##Label##}}} |
| E.g. |
| {{{ There is a clear requirement for references as proposed##Proposal for references in Creole|prop##, |
| you need only look at a typical big wiki##Wikipedia, the nightmare of references by anon## and anyone |
| who argues against it clearly has a very different opinion to what is contained in this proposal##prop##}}} |
| At line 19 changed one line |
| {{{ <ref name="Perry"/> }}} |
| Would produce:- |
| At line 21 changed one line |
| At the point where you want the text of the footnotes or references to appear (usually at the end of the article in a "Notes" or "References" section), insert the tag: |
| {{{There is a clear requirement for references as proposed[1], you need only look at a typical big wiki[2] |
| and anyone who argues against it clearly has a very different opinion to what is contained in this proposal[1]}}} |
| At line 23 changed one line |
| {{{ <references/> }}} |
| ===Generating List=== |
| A list is typically generated in the following format: |
| At line 25 changed 3 lines |
| Which produces a list: |
| # ^ Wiki For Dummies, First Edition, Hungry Minds, Inc., 1980. |
| # ^ Excel For Dummies, First Edition, Hungry Minds, Inc., 1980. |
| {{{1. Proposal for references in Creole |
| 2. Wikipedia, the nightmare of references by anon}}} |
| At line 36 added 3 lines |
| Wikipedia adds '^' as in |
| {{{2. ^ Wikipedia, the nightmare of references by anon}}} |
| where the '^' is an internal link to the reference. (see below) |
| At line 30 changed one line |
| Personally, I would refer something like |
| The mechanism for generating the list may be: |
| #Automatic at the end of the page |
| #and/or Precipitated. |
| At line 32 changed one line |
| This is second [2] reference the first being on the top line to show the link, this is the third[3] reference |
| The prefered mechanism for triggering a reference list is an empty reference: {{{####}}} Unfortunately this might be thought to conflict with a numbered indent. However, reference list will not be valid as part of a numbered list, and who on earth is going to produce a numbered list starting at the fourth level?? Is it even valid? |
| At line 34 changed one line |
| A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text ....A lot of text |
| ===References/Links=== |
| At line 36 changed 3 lines |
| * [#1] This first reference info, Hungry Minds, Inc., 1980.] |
| * [#2] The second reference info, Hound dog deniers Inc., 1580.] |
| * [#3] The third reference info,1180.] |
| Firstly, the reference may be a link so that the following is valid: |
| {{{##[[http://example.com|Example]]##}}} |
| At line 40 changed one line |
| Which is exactly what this wiki [http://www.jspwiki.org/wiki/TextFormattingRules#ref-TextFormattingRules-1] does with the following reproduced text :- |
| **Secondarily, references in the text should have an internal reference to the explanation in the reference table**, for this reason each item in the reference table needs an ID ideally something like: REF1 (and/or the label), and the in-line [2] needs to be a link as in {{{< a href="#REF2">[2]</a>}}}. Where it is necessary to display two sets of text on the same HTML page where each contains their own numbered list (possibly refering to the same text with the same references and therefore labes), the suggestion is to prefix the label with a block specific identifier: e.g. T156REF1 |
| At line 42 changed 7 lines |
| {{{This is second [2] reference the first being on the top line to show the link, this is the third[3] reference |
|
| A lot of text .... |
|
| * [#1] This first reference info, Hungry Minds, Inc., 1980.] |
| * [#2] The second reference info, Hound dog deniers Inc., 1580.] |
| * [#3] The third reference info,1180.] }}} |
| Finally, it is suggested the list should contain an internal reference back to the (first) use. |
| If this scheme is adopted, then it might be sensible to link all the references in a round robin, so that the list links to the first instance of use, the first to the second, etc. until the final use of a reference links back to the reference list. |
.