Editing User:Pharap/Wiki Improvement Proposals
From Guild of Archivists
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 2: | Line 2: | ||
=== Inline D'ni Dictionary Template === | === Inline D'ni Dictionary Template === | ||
==== Summary ==== | ==== Summary ==== | ||
Line 61: | Line 54: | ||
=== Apocrypha Banner === | === Apocrypha Banner === | ||
==== Summary ==== | ==== Summary ==== | ||
Line 88: | Line 74: | ||
| issue = is [[GoArch:Apocrypha|apocrypha]]. It should be considered [[GoArch:Canon policy|non-canon]] and may consist of fan-created content. | | issue = is [[GoArch:Apocrypha|apocrypha]]. It should be considered [[GoArch:Canon policy|non-canon]] and may consist of fan-created content. | ||
| small = {{#if:{{{sect|{{{section|{{{1|}}}}}}}}}|{{#if:{{{small|{{{left|}}}}}}|left}} }} | | small = {{#if:{{{sect|{{{section|{{{1|}}}}}}}}}|{{#if:{{{small|{{{left|}}}}}}|left}} }} | ||
| sect = | | sect = {{{1|}}} | ||
}} | }} | ||
Line 104: | Line 90: | ||
| issue = is [[GoArch:Apocrypha|apocrypha]]. It should be considered [[GoArch:Canon policy|non-canon]] and may consist of fan-created content. | | issue = is [[GoArch:Apocrypha|apocrypha]]. It should be considered [[GoArch:Canon policy|non-canon]] and may consist of fan-created content. | ||
| small = {{#if:{{{sect|{{{section|{{{1|}}}}}}}}}|{{#if:{{{small|{{{left|}}}}}}|left}} }} | | small = {{#if:{{{sect|{{{section|{{{1|}}}}}}}}}|{{#if:{{{small|{{{left|}}}}}}|left}} }} | ||
| sect = | | sect = {{{1|}}} | ||
}} | }} | ||
<noinclude> | <noinclude> | ||
Line 114: | Line 100: | ||
This template currently includes no documentation, though if any were needed it should simply be a matter of adapting the documentation provided for the {{tlx|OOC}} or {{tlx|Unexplored Branches}} templates. | This template currently includes no documentation, though if any were needed it should simply be a matter of adapting the documentation provided for the {{tlx|OOC}} or {{tlx|Unexplored Branches}} templates. | ||
=== Add a <code>quote</code> Parameter to {{tlx|cite journal}} === | |||
==== Summary ==== | |||
I propose to add a <code>quote</code> parameter to the {{tlx|cite journal}} template so that references may include specific quotes relevant to the claim being supported by the citation. | |||
==== Reasoning ==== | |||
The intent of such a quotation would be to make it easier to verify claims as readers would not have to (for example) go hunting through entire journals just to find the one sentence that supports the claim made in the article. | |||
==== Example ==== | |||
The <code>quote</code> parameter could then be used as thus: | |||
<pre><nowiki> | |||
<ref name="Tay">{{cite journal|author=Catherine|journal=Personal journal|journal-page=Reference:Catherine, personal journal (Riven)|game=Riven|quote=They have named it "Tay"}}</ref> | |||
</nowiki></pre> | |||
Producing an output of: | |||
<blockquote><samp>Catherine, ''Personal journal''. Riven. "They have named it "Tay""</samp></blockquote> | |||
The presence or absence of quote marks and/or the style of the quote marks would be up for discussion. | |||
Should anyone find the nesting of the same style of quotes unsatisfactory, I ''believe'' it should be possible to enforce the inner quotes being made a different style. | |||
==== Implementation ==== | |||
This proposal could be implemented by simply adding <code><nowiki>{{#if:{{{quote|}}}| "{{{quote}}}"|}}</nowiki></code> to the existing template, such that it becomes: | |||
<pre><nowiki> | |||
{{{author}}}. ''{{{journal-nolink|[[{{{journal-page|Reference:{{{author}}}, {{{journal}}}}}}|{{{journal}}}]]}}}''. {{{game-nolink|[[{{{game-page|{{{game}}}}}}|{{{game}}}]]}}}.{{#if:{{{quote|}}}| "{{{quote}}}"|}}<noinclude>{{documentation}}</noinclude> | |||
</nowiki></pre> | |||
The documentation for the template could be ammended with: | |||
<pre><nowiki> | |||
"quote": | |||
{ | |||
"label": "Quote", | |||
"description": "A selected quote from the referenced journal. The chosen quote should be relevant to the article content that makes use of the citation. If omitted, no quote is included in the reference.", | |||
"example": "They have named it \"Tay\"", | |||
"type": "string" | |||
} | |||
</nowiki></pre> | |||
As well as the addition of <code>"quote"</code> to the end of the <code>paramOrder</code> array. | |||
Note: In regards to enforcing that nested quotes use a different style, I don't believe templates alone are capable of text replacement that sophisticated, though it's possible they support some sort of regex-replacement feature that I'm unaware of at the time of writing. To support such a feature would, I believe, require a Lua module. I haven't researched that as I'm presuming it won't be an issue, but should it be an issue I have sufficient experience with Lua and parsing that I'm confident I could make a good go of it. | |||
=== IPA Hover Guides === | |||
==== Summary ==== | |||
Wikipedia has an {{tl|IPAc-en}} template that produces IPA that provides a pronunciation guide when hovering over the individual characters. For example, the [https://en.wikipedia.org/wiki/Basalt?useskin=vector Basalt] page features examples such as /ˈbæsɔːlt/ where hovering over the 'b' gives "'b' in 'buy'", hovering over the 'æ' gives "'a' in 'bad'", hovering over the 's' gives "'s' in 'sigh'", et cetera. | |||
It would be useful if similar functionality could be reproduced on this wiki. | |||
==== Reasoning ==== | |||
It would provide a useful starting point for people who aren't familiar with IPA and are trying to understand how to pronounce various names and D'ni words. | |||
==== Example ==== | |||
A hypothetical <nowiki>{{IPAc-en|t|ɛ|.|l|ɛ|.|d|ɑ|n}}</nowiki> would give /<span style="border-bottom: 1px dotted"><span title="/t/: 't' in 'tigh'">t</span><span title="/ɛ/: 'e' in 'dress'">ɛ</span>.<span title="/l/: 'l' in 'lie'">l</span><span title="/ɛ/: 'e' in 'dress'">ɛ</span>.<span title="/d/: 'd' in 'dye'">d</span><span title="/ɑ/: 'a' in 'father'">ɑ</span><span title="/n/: 'n' in 'nigh'">n</span></span>/. | |||
==== Implementation ==== | |||
Despite being used as a template, this would be best implemented as a module. | |||
The exact implementation is currently ''to be confirmed'', but the general idea is simple enough: | |||
* Each numbered parameter will be examined. | |||
* The specific IPA character will be looked up in a table of tooltips. | |||
* If a corresponding piece of tooltip text was found: | |||
** The character will be inserted into the page surrounded by a <code>span</code> with the <code>title</code> set to whatever the found tooltip was. | |||
** Otherwise, the character will be inserted without any additional processing. | |||
The whole thing would be wrapped in a <code>span</code> element with its <code>style</code> attribute set to produce a dotted line, and that would be bookended by forward slashes. | |||
=== Hover Text Template === | === Hover Text Template === | ||
==== Summary ==== | ==== Summary ==== | ||
Line 148: | Line 204: | ||
=== Abbreviation Template === | === Abbreviation Template === | ||
==== Summary ==== | ==== Summary ==== | ||
Line 186: | Line 235: | ||
=== Sic Template === | === Sic Template === | ||
==== Summary ==== | ==== Summary ==== | ||
Line 202: | Line 244: | ||
(A surplus of examples can be found in the [https://en.uesp.net/wiki/Bloodmoon:Airship_Captain%27s_Journal Bloodmoon:Airship Captain's Journal] article.) | (A surplus of examples can be found in the [https://en.uesp.net/wiki/Bloodmoon:Airship_Captain%27s_Journal Bloodmoon:Airship Captain's Journal] article.) | ||
I would also propose that the revised {{tl|sic}} link to an internal article on the wiki rather than externally linking to Wikipedia, to avoid the generation of the <span class="extiw" | I would also propose that the revised {{tl|sic}} link to an internal article on the wiki rather than externally linking to Wikipedia, to avoid the generation of the <span class="extiw" /> icon, which clutters the page. The most obvious candidate at the moment would be the [[GoArch:Style_guide#Quotations|Quotations]] section of the style guide. | ||
==== Reasoning ==== | ==== Reasoning ==== | ||
Line 222: | Line 264: | ||
A functional implementation can be viewed at <code><nowiki>{{</nowiki>[[User:Pharap/Templates/Sic]]<nowiki>}}</nowiki></code>. | A functional implementation can be viewed at <code><nowiki>{{</nowiki>[[User:Pharap/Templates/Sic]]<nowiki>}}</nowiki></code>. | ||
== Incomplete Proposals == | == Incomplete Proposals == | ||
* Further proposals for adding <code>quote</code> parameters to other <code>cite</code> templates, such as {{tlx|cite dialog}}. | * Further proposals for adding <code>quote</code> parameters to other <code>cite</code> templates, such as {{tlx|cite dialog}}. | ||
* Add an <code>access-date</code> parameter to the {{tlx|cite forum post}} template. | * Add an <code>access-date</code> parameter to the {{tlx|cite forum post}} template. | ||
* Add relevant details to <code>Reference:</code> pages that archive forum posts such that they can be properly cited with a {{tlx|cite forum post}}. In particular, the original forum post URL would be useful - the reference page should be considered the archived form if no [http://web.archive.org/ Wayback Machine] page exists. | * Add relevant details to <code>Reference:</code> pages that archive forum posts such that they can be properly cited with a {{tlx|cite forum post}}. In particular, the original forum post URL would be useful - the reference page should be considered the archived form if no [http://web.archive.org/ Wayback Machine] page exists. | ||