Difference between revisions of "Template:Key Start/doc"

{{SingleAccessKey | id = Example | title = Example key | description = Only a demo |
{{Lead | 1 | Blätter gegenständig    |  2 }}
{{Lead | 1 | Blätter wechselständig  | 18
  |image=[[Image:xyz.jpg|thumb|200px|A caption for the image]]  }}

Example key in German
This key is a demo key only, containing links to the German Wikipedia (Geographic scope not specified) — Collaboration: open — (Status not specified) — Edited by: (not specified)

Start of an English Key with backlinks, links to English Wikipedia, and a footnote

---

Single access keys created with these templates may be strictly dichotomous (two alternatives, as above) or they may be polytomous (some couplets having more than 2 alternatives, not shown). Furthermore, it is possible to design keys in statement-style (as above) or in question-answer-style as follows:

Example of the start of a key in question-answer-style

For testing, also a technical sample of a reticulated key, resulting in a Directed Acyclical Graph (this key is complete, i.e. unlike the other examples it has no dangling leads):

Techical example of reticulated key (lead 4 has two parents: 3 and 6)

This is just a test of complicate data structures for Javier test)

Introduction for developers

The key is a table with a dummy column to enable partial overlap between left and right text in different rows. Overlap is possible only between a long lead statement with a short number pointer, long lead statements with a long taxon name can not overlap. Each lead is a separate row, if images are present they are added in an additional row where required.

Javascript programmability: Each row contains an id attribute with "L" + lead number + "row", the lead cell itself an id attribute with "L" + lead number. The table is styled mostly using css classes, with the text span background an exception (to allow parameterization of the background).

TODO

• Add the key id to each lead id, to support multiple keys on a wikipage. Work on this was started, but not finished!
• Improvements: The key title could be displayed better than as caption. The description text could perhaps be styled differently.

• A FRIDA html key for comparison. One major difference is that FRIDA always places the taxon in a row of its own.

Known problems

1. A plain three column layout is less than satisfactory; the occasional wide taxon names force the whole last column to be very wide.
   • To some extent, this is already worked around by providing a four-column layout with alternating colspan (33% of table width is assigned to statement, if no taxon is present, or to taxon, if that is present. However, this still means that the statement may be presented shorter than necessary.
2. Clicking on the hyperlinks usually has no effect if the screen already contains the target lead.
   • Proposed solution: some javascript additions. Note: JS can not be called directly from within the wiki text for security reasons, or any user could reprogram the wiki into a dangerous tool.
3. Leads do not automatically renumber.
   • There is an obvious service solutions for this: The project would have to program a "bot" program, the works through all keys that have a category like "Please renumber" set, renumbering the key in an optimal way, and then deleting (or commenting out) the category.
4. There are no lead dots running from the statement to the number.
   • Attempting to fix this with <span style="float:right"> . . . .</span> did not work well!
   • Can this be fixed with a repeated background image and non-transparent text? Could be worth testing!

Dependencies

• Styles in MediaWiki:Common.css, one of which refers to a background image which must be available, and it needs the StringFunctions extension installed.
• The target highlighting depends on code in MediaWiki:Common.js
• The associated templates are: Template:Lead, and Template:LeadQuestion
• Documentation templates at: Template:SingleAccessKey/doc, Template:Lead/doc
• Secondary tool templates are Template:Trim, Template:Documentation, Template:Documentation/subpage, Template:Documentation/docname, Template:Documentation/preload.