Author: cyp
1
1.1: Issue
{{#tag:ref}}s in a <references> block supposedly cannot themselves contain _unnamed_ <ref>s (see also #2, below)
1.2: Test case
===Article text===
Lorem ipsum<ref name="expl_A" group="n" />
===Explanatory notes section===
<references group="n">
{{#tag:ref
|AAAA <ref>Ref #1</ref>
|group="n"|name="expl_A"}}
</references>
===References section===
<references />1.3 Test case result
Failure. For one, it will generate a <ref> tag defined in <references> has no name attribute. message. Obviously, the <ref> here does not need a name. Secondly, the <ref> will not be dealt with. Third, just adding a name does not solve the problem. See #2, below.
2
2.1: Issue
For a _named_ <ref> (compare case #1) inside a {{#tag:ref}} inside a <references> block, the ref handler will carp and
ignore the ref.
2.2: Test case
===Article text===
Lorem ipsum<ref name="expl_A" group="n" />
===Explanatory notes section===
<references group="n">
{{#tag:ref
|AAAA <ref name="ref1">Ref #1</ref>
|group="n"|name="expl_A"}}
</references>
===References section===
<references />2.3 Test case result
Failure. Error message <ref> tag with name "ref1" defined in <references> is not used in prior text. The <ref> is not dealt with.
3
3.1: Issue
ref handler will carp and ignore cross-refs to an existing, predefined, named <ref>s (compare case #1/#2)
3.2: Test case
===Article text===
Lorem ipsum<ref name="expl_A" group="n" />
Carpe diem<ref name="ref1">Ref #1</ref>
===Explanatory notes section===
<references group="n">
{{#tag:ref
|AAAA <ref name="ref1" />
|group="n"|name="expl_A"}}
</references>
===References section===
<references />3.3 Test case result
Failure. Error message <ref> tag with name "ref1" defined in <references> is not used in prior text. The <ref> is not dealt with.
6
6.1: Issue
Ungraceful handling of refs that have no backlinks
6.2 Test case
===Article text===
Some text (no refs)
===References section===
<references>
{{#tag:ref
|This is a ref without backlinks
|name="some_name"}}
</references>6.3 Test case result
The ref handler will emit an "error" that <ref> tag with name "expl_B" defined in <references> is not used in prior text. This is unnecessary bitchiness that second guesses the editor. What the ref handler really ought to do is print it without backlinks (in a separate <ul>). If the name has a typo, editors will figure it out. [the same should be done for <ref>s in a <references> block that have no name] Editors ought not to be screamed at.
Notes
- These problems are all limited to tags inside <references>...</references>. They don't apply outside the <references> block.
- The ref handler is much too emphatic. It probably needs to deal with input gracefully, and not shake its fist at editors so much. Please.