User:Gorgon/Sandbox/Sandbox Alpha: Difference between revisions

From Avlis Wiki
Jump to navigation Jump to search
m (More tweaks)
m (Undo)
Line 19: Line 19:
<templatedata>
<templatedata>
{
{
     "description": "Spell template parameter descriptions.
     "description": "Spell te<noinclude>{{<!-- sec -->User:Gorgon/Sandbox/Sandbox_Beta | User:Gorgon/Sandbox | 1 }}
 
Anything up to/including the '''Template start''' heading will not be included in transclusion of this template (or any part of the trailing documentation section either, though that will eventually be formalized template documentation, possibly with transcluded categories at the end).
 
I love to over-comment my code, so why change things here...
 
 
<div style="float:left; max-width:50%">__TOC__</div>
<br clear=all />
 
 
== Test version of [[Template:Spell]] ==
<!-- Add any revision notes or other ideas here. -->
 
 
=== Extensions that would make this work better [My wish list] ===
 
* [http://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion Extension:Labeled Section Transclusion] - Allows '''selective''' transclusion of marked-off sections of text.
** [[Wikipedia:Wikipedia:Transclusion#Without_using_the_labeled_section_method | Wikipedia:Selective transclusion without using the labeled section method]] - This works here with onlyinclude and includeonly, so transcludesection=SECTIONNAME parameters are doable if [http://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion Extension:Labeled Section Transclusion] isn't added.
 
 
* [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(third-party) Extension:DynamicPageList (third-party)] - Enhanced version of [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(Wikimedia) Extension:DynamicPageList (Wikimedia)]
** [http://semeb.com/dpldemo/index.php?title=DPL:Overview DPL:Overview] - Generate dynamic reports based on category members and selective included info from each (Extension:Labeled Section Transclusion above would really help there).
** [http://semeb.com/dpldemo/index.php?title=Template:Catlist DPL:Template:Catlist] - Picture this totally reformatted as filter/sort options up top of the [[Magic:Spell_List | Spell List]] page, as a dynamic table. It starts showing all spells, but sortable with one click by level, school, class, or any other useful [[Template:Spell]] parameter/category used by them. Then add in the ability to filter results to only certain kinds/combinations (e.g, Show only cleric evocation spells, sorted by level, with the option of showing specific domain ones as well).
** I doubt anyone else besides me would use this (except maybe the occasional dabbler), but it would really be useful for spells, and maybe a few other things eventually. Revamping all spells via this template is a huge undertaking (and my main goal for wiki updating, now that I can verify/test spells again), so adding this extension for that work alone would make a huge difference.
** <s>After looking into the more recent version of [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(Wikimedia) Extension:DynamicPageList (Wikimedia)] (the one used by most Wikimedia projects, not the "enhanced - 3rd party one"), it may be just as useful (or better), since it allows more sort options. Need to see both in practical use before deciding anything.</s>
*** This can't grab sections by template parameter name, but [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(third-party) Extension:DynamicPageList (third-party)] can. See: [http://semeb.com/dpldemo/index.php?title=DPL:Manual_-_DPL_parameters:_Controlling_output_volume#include_contents_related_to_templates include contents related to templates] for how to specify named parameters in a page using a specific template (So grab the name and description in one simple <code>include={Template:Spell}:Name:Description Summary</code> option line, to make a page listing all spells, or filter/sort by whatever criteria, including each Template:Spell parameter)
**** [http://wayback.archive.org/web/20161110223718/http://semeb.com/dpldemo/index.php?title=DPL:Manual_-_DPL_parameters:_Controlling_output_volume#include_contents_related_to_templates Internet Archive link to the same '''include contents related to templates''' link above], since the site is having PhP issues.
** I definitely want this now. The [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(Wikimedia) Extension:DynamicPageList (Wikimedia)] version is '''off my wish list''', since that functionality is pretty much the main reason I want it.
* [http://www.mediawiki.org/wiki/Extension:Arrays Extension:Arrays] - For parsing things like the V, S, M in a single "Descriptors" parameter, without a lot of #explode etc. code (still looking for the best way to do that, and that needs the string parsing extensions enbled).
 
 
=== Revision notes ===
 
* [[NWN:Template:Spell | Template:Spell on the NWN Wiki]] has some ideas, but not quite what I had in mind either.
 
 
* I think [[User:Buddha|Buddha]] had the right idea with his discussion on the [[Avlis_Wiki_talk:Categories#Categorizing_Spells | Categories page]] about reformatting how we categorize spells. The current [[Magic:Spell_List | Spell List]] page (and its various subversions) all rely on manual updating when any new changes happen to it, like a new spell being added. Revisions to this template will improve how each spell is displayed, and categorized (even without new extensions), so moving to category listings that update dynamically makes a lot of sense.
** If the suggested [http://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion Labeled Section Transclusion] extension is added, then short spell descriptions and other info can be dynamically added/updated to manually updated lists, like [[Magic:Cleric_Spells:Level-1 | Cleric Spells:Level-1]], even without moving to categories.
*** [[Wikipedia:Wikipedia:Transclusion#Without_using_the_labeled_section_method | Wikipedia:Selective transclusion without using the labeled section method]] - This works here with onlyinclude and includeonly (see above), so a workaround without [http://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion Labeled Section Transclusion].
** The [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(third-party) Dynamic Page List (third-party)] extension would allow one page to display all variations in any sort of table, sortable and filterable by any useful criteria. Spells would be automatically categorized by this template, but one page would use those categories and/or the template parameters, to display whatever output is requested by the user. Combine this with Labeled Section Transclusion, and any results are updated as each spell gets edited.
 
 
----
 
 
Can the '''Name''' template parameter be taken from the page name automatically?
* Maybe as a default if not given as a parameter?
* Might need some page renaming, but should work.
* Keeping the template from categorizing itself as a spell might be annoying, unless namespace checking or other validation is done.
 
 
* Taking the '''Name''' template parameter from the <nowiki>{{SUBPAGENAME}}</nowiki> isn't so simple.
** The Magic: (and Epic Spell:) prefix needs to be stripped after checking if it exists, especially for using it as a sort key with categories. Checking for it is easy with something like <code><nowiki>{{#ifeq:{{lc:{{padleft:|6|{{SUBPAGENAME}}}}}}|magic:|}}</nowiki></code>. Removing it is harder. <code><nowiki>{{#explode:{{SUBPAGENAME}}|:|1}}</nowiki></code> could do it, but needs the parser functions for string handling enabled with <code>$wgPFEnableStringFunctions = true;</code> in LocalSettings.php (see the second top note at: [http://www.mediawiki.org/wiki/Extension:StringFunctions Extension:StringFunctions]).
*** All the spell pages should be stripped of these prefixes themselves. Someone was setting it up as if there were actual namespaces for them, but there aren't. Do I really want to get into that mess?
** If the <nowiki>{{SUBPAGENAME}}</nowiki> has more than one word for the spell name, the second and latter words need to be capitalized.
*** Using some sort of <code><nowiki>{{#replace:{{#explode:{{SUBPAGENAME}}| |1}}|{{ucfirst:{{#explode:{{SUBPAGENAME}}</nowiki></code> code, that first counts the words and has enough depth levels for them all would get messy fast (for loop in wiki markup?).
*** Someone must have had a similar problem and found an easier solution, so do some searching.
** We'll have to assume all page names like Bigbys have been changed to use apostrophes too (e.g., Bigby's) - no sane way to check and fix that here (well maybe a switch with the known names already, but new ones would need constant updates... which it what this is supposed to eliminate).
** If it isn't easy, just make it a required parameter with error message, like the rest.
 
 
----
 
 
* Redone using onlyinclude sections with transcludesection tags (See above).
** Not as simple as Labeled Section Transclusion, and can't do some things with it, but good enough for now.
* Major School/Subschool/Descriptors redo.
** Added the <b>[[Magic:Spell_Format:Subschool | Subschool]]</b>: and <b>[[Magic:Descriptors | Descriptors]]</b>: prefixes, but they may make the School line too long.
** Added a bunch of validation checks in switches.
* Added <b>Spell Name:</b> at the top.
** Having every spell "Name" be the page name "Magic:Name" was inaccurate and confusing.
** Uses the Name = parameter, or <nowiki>{{SUBPAGENAME}}</nowiki> if not entered.
* All parameters are now Proper Case.
* Lowercase conversion is used for comparison validation of parameter values (when possible).
** ifeq: and case entries in a switch are case sensitive, so this is necessary.
* Proper Case conversion is used (when possible) in output results.
** If people don't use the right case, this should fix at least some of the issues.
* Added a bunch of namespace checks as part of the validation,
** All spells should be in the Main namespace, so anything outside that is a template (or test page in a userspace).
** Added a hak to make my sandbox spell pages work as if in Main (remember to change it back when publishing this).
* Started making missing parameter entries (without forced defaults or warnings) not show in Main, instead of the <nowiki>{{{parameter name}}}</nowiki> (like in the Template namespace).
** Better to add warnings (when defaults aren't possible) for all that should be included. If they see annoying red stuff, they will have to fix it.
* Split Description Summary and Description Details parameters, so the summary can be transcluded as a short description elsewhere.
** Need to make the Description Details optional (and conditional on the summary) and add a default "No description" blurb to the summary.
* I don't like all the ifeq: <nowiki>{{NAMESPACE}}</nowiki> | Main checks I added (part of my hiding missing entries above). That can be done a better way.
* Also need to split up all the level parameters.
* Just getting started. Too many other things to do, so not gonna try listing them all (lots of trial and error with ideas anyway).
 
 
'''I'm an idiot. I'm trying to use transcludesection directly from the template, instead of passing it on to each spell. Taking a break and I'll come at it fresh later.'''
 
 
----
 
 
* School, Subschool and Descriptor links aren't being transcluded, just the names.
** I haven't added the Descriptor links to the template yet...
** Fixed: This wasn't passing my test for being a sandbox spell, so it was using the template page display...
 
 
* Don't really like having 3 separate parameters for Descriptors, and later the same deal for Components. Figure out a way to use an array from one parameter (cold, acid, ...).
 
 
----
 
 
:'''Whatever is done here is only RENDERED in the page. To have the spell code changed, the sec# tags must be added to each spell.'''
 
:* Even [http://www.mediawiki.org/wiki/Extension:Labeled_Section_Transclusion#Limitations Extension:Labeled Section Transclusion - Limitations] can't do that.
:* [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(third-party)#Which_steps_are_necessary.3F Extension:DynamicPageList (third-party) - Define contents you want to show section] can (not the [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(Wikimedia) Extension:DynamicPageList (Wikimedia)] version).'''
:** See: [http://semeb.com/dpldemo/index.php?title=DPL:Manual_-_DPL_parameters:_Controlling_output_volume#include_contents_related_to_templates include contents related to templates] for how to specify named parameters in a page using a specific template (So grab the name and description in one simple <code>include={Template:Spell}:Name:Description Summary</code> option line, to make a page listing all spells, or filter/sort by whatever criteria, including each Template:Spell parameter)
:** [http://wayback.archive.org/web/20161110223718/http://semeb.com/dpldemo/index.php?title=DPL:Manual_-_DPL_parameters:_Controlling_output_volume#include_contents_related_to_templates Internet Archive link to the same '''include contents related to templates''' link above], since the site is having PhP issues.
:* I definitely want this now. The [http://www.mediawiki.org/wiki/Extension:DynamicPageList_(Wikimedia) Extension:DynamicPageList (Wikimedia)] version is '''off my wish list''', since that functionality is pretty much the main reason I want it.
:* Updated the top list with this info.
 
 
* Parameters that are named with empty values are defined when checked. E.g., If <code>Parameter Name =</code> is in the spell code with no value, <code><nowiki>{{#if: {{{Parameter Name|}}} | yes | no }}</nowiki></code> is yes. Redo all of my checks (only 3 of them).
 
 
* Too many extra spaces are being added to things, like the end of the '''Name''' parameter. I may have to get rid of readable code format in many places, to get the correct output (commenting out space is even worse in many cases... maybe OK for newlines).
** [[Special:ExpandTemplates]] works well for this, and can cut down on template edits, if what is causing a problem is obvious enough to fix in np++, instead of extra trial and error saves (Offline/preview editing is great for most pages, but not templates used by other pages, so anything that can reduce the page save spam is good).
*** Use any name of a spell for '''Context title''' (E.g., Magic:Aid or User:Gorgon/Sandbox/Sandbox_Alpha/SbA01). This is used while expanding info used as <nowiki>{{FULLPAGENAME}}</nowiki> or whatever by the template, so using Template:Test will act as if in the template namespace (including a full preview as if in that namespace, with the provided page name and working category links. Handy!).
*** Paste the full spell (template call and parameters) into the '''Input text:''' box, and it shows all the hidden stuff used to render the page, including white-spaces (if a space is at the end of a line, it still shows the cursor being one space right... or just copy and paste all into np++ and show white-spaces there).
*** '''Show XML parse tree''' and '''Show raw HTML''' give even more useful info for this (in separate views), so use them all the time when checking. Toggling '''Remove comments''' is useful for seeing commented out categories in test spells (and being sure they don't get included.)
** The current version needs a lot of fixes after seeing it that way (ugh).
** Might also look at adding [[Wikipedia:Template:Trim|Template:Trim]] here, to clean up all parameters added on the spell pages, if they start adding more spaces (whitespace characters are stripped from the beginnings and ends of named parameter names and values, so this could only happen with ones in quotes).
 
 
* The error results for bad/missing parameter values (in red) should be links to the spell format documentation, which should be in this template's documentation. Basically this template makes the spells link back here on errors.
 
 
* Trying to grab the spell '''Name''' from <nowiki>{{SUBPAGENAME}}</nowiki> isn't working (see the extra info on that I added to my orignal notes above). Making it a required parameter with an error message, like the rest.
 
 
* Every spell in spelld.2da has a school (which is any spell like effect from anything pretty much), and there is no universal in NWN, only a general constant (SPELL_SCHOOL_GENERAL) for any spell in the 2da that doesn't have a school letter aassigned (e.g., ****). This shouldn't allow a blank school, but should allow <code>general</code> as a parameter (or <code>universal</code>???). See if that universal school term is used anywhere else outside of [[Magic:Spell_Format]] before using <code>general</code>.
 
 
* Testing for defined/empty parameters:
: ''"The value of a parameter can be the empty string (pipe or equals sign followed immediately by the next pipe or the closing braces). This is different from omitting the parameter altogether, which leaves it undefined, although templates are often coded so as to behave the same in both cases."''
 
:* Add [[Template:Ifparadef]] usage for parameters that need it.
 
 
* I forgot the '''"Main"''' namespace returns blank when checking <nowiki>{{NAMESPACE}}</nowiki>. I could use a blank, but better to show it by number, so all <code>Main</code> instances have been replaced with <code><nowiki>{{ns:0}}</nowiki></code>.
 
 
----
 
 
* Revamp for '''<nowiki>{{ns detect}}</nowiki>''' (Namespace detect) template usage, instead of complicated namespace checks.
** Transclusion of this template should only work in the main namespace.
** In the template or user namespace, is shows the parameters. The user namespace is intentional (and permanent) for testing template edits.
** For testing transclusion in a user namespace (i.e., a sandbox spell), use the <code>| demospace = main</code> optional parameter value.
** In any other namespace, this doesn't render anything, unless the <code>| demospace = main</code> or <code>| demospace = template</code> optional parameter values are used (<code>| page = Pagename</code> or <code>| page = Template:Pagename</code> give the same results).
 
 
----
 
 
More to come...
 
 
<!-- End of notes. -->
== Template start ==
 
 
</noinclude>{{ns detect | talk = | avlis wiki = | file = | mediawiki = | help = | category =
| other =
<div class="notice metadata" id="spell updates" style="background-color: #FFFFE0; margin: 1em; padding: 10px; border: 1px solid #CDCDB4;">
 
<font style="font-size: 16px; font-style: italic;">Spell articles are presently undergoing an overhaul to improve ease of updating. Please excuse any mess that this may cause for the duration.</font>
</div>
 
<b>Spell Name:</b> {{ns detect | main = {{{Name | <span style="color:red">Missing "Name" parameter value!</span> }}} | other = {{{Name}}} | demospace = {{{demospace|}}} | page = {{{page|}}} }}<br />
<b>[[Magic:School | School:]]</b> {{ns detect | main =
    {{#switch: {{lc: {{{School|}}} }}
        |              = <span style="color:red">Missing "School" parameter value!</span>
        | abjuration    = [[Magic:Abjuration    | Abjuration]]
        | conjuration  = [[Magic:Conjuration  | Conjuration]]
        | divination    = [[Magic:Divination    | Divination]]
        | enchantment  = [[Magic:Enchantment  | Enchantment]]
        | evocation    = [[Magic:Evocation    | Evocation]]
        | illusion      = [[Magic:Illusion      | Illusion]]
        | necromancy    = [[Magic:Necromancy    | Necromancy]]
        | transmutation = [[Magic:Transmutation | Transmutation]]
        | general      = [[Magic:General      | General]]
        | #default      = <span style="color:red">Invalid "School" parameter value!</span>
    }}
    {{#if: {{{Subschool|}}} |<!-- Is &nbsp; needed here, or will the next space be preserved? --> ( <b>[[Magic:Spell_Format:Subschool | Subschool:]] </b>
        {{#switch: {{lc: {{{Subschool|}}} }}
            | calling    = {{#ifeq: {{lc: {{{School|}}} }} | conjuration | [[Magic:Conjuration#Calling | Calling]] ) | <span style="color:red">"Subschool = Calling" requires "School = Conjuration"!</span> ) }}
            | creation  = {{#ifeq: {{lc: {{{School|}}} }} | conjuration | [[Magic:Conjuration#Creation | Creation]] ) | <span style="color:red">"Subschool = Creation" requires "School = Conjuration"!</span> ) }}
            | healing    = {{#ifeq: {{lc: {{{School|}}} }} | conjuration | [[Magic:Conjuration#Healing | Healing]] ) | <span style="color:red">"Subschool = Healing" requires "School = Conjuration"!</span> ) }}
            | summoning  = {{#ifeq: {{lc: {{{School|}}} }} | conjuration | [[Magic:Conjuration#Summoning | Summoning]] ) | <span style="color:red">"Subschool = Summoning" requires "School = Conjuration"!</span> ) }}
            | charm      = {{#ifeq: {{lc: {{{School|}}} }} | enchantment | [[Magic:Enchantment#Charm | Charm]] ) | <span style="color:red">"Subschool = Charm" requires "School = Enchantment"!</span> ) }}
            | compulsion = {{#ifeq: {{lc: {{{School|}}} }} | enchantment | [[Magic:Enchantment#Compulsion | Compulsion]] ) | <span style="color:red">"Subschool = Compulsion" requires "School = Enchantment"!</span> ) }}
            | figment    = {{#ifeq: {{lc: {{{School|}}} }} | Illusion | [[Magic:Illusion#Figment | Figment]] ) | <span style="color:red">"Subschool = Figment" requires "School = Illusion"!</span> ) }}
            | glamer    = {{#ifeq: {{lc: {{{School|}}} }} | Illusion | [[Magic:Illusion#Glamer | Glamer]] ) | <span style="color:red">"Subschool = Glamer" requires "School = Illusion"!</span> ) }}
            | pattern    = {{#ifeq: {{lc: {{{School|}}} }} | Illusion | [[Magic:Illusion#Pattern | Pattern]] ) | <span style="color:red">"Subschool = Pattern" requires "School = Illusion"!</span> ) }}
            | phantasm  = {{#ifeq: {{lc: {{{School|}}} }} | Illusion | [[Magic:Illusion#Phantasm | Phantasm]] ) | <span style="color:red">"Subschool = Phantasm" requires "School = Illusion"!</span> ) }}
            | shadow    = {{#ifeq: {{lc: {{{School|}}} }} | Illusion | [[Magic:Illusion#Shadow | Shadow]] ) | <span style="color:red">"Subschool = Shadow" requires "School = Illusion"!</span> ) }}
            | #default  = <span style="color:red">Invalid "Subschool" parameter value!</span> )
        }}
    }}
    {{#if: {{{Descriptors|}}} |<!-- Is &nbsp; needed here, or will the next space be preserved? --> ( <b>[[Magic:Descriptors | Descriptors:]] </b><!-- Redo with #explode and comma separated Descriptors. Just test the first letter of each (so v, verbal... or vine all return "V") -->
        {{#switch: {{lc: {{{Descriptors|}}} }}
            | = <!-- This blank case and result is needed to not trigger the default Invalid "Descriptor" error -->
            | acid | chaotic | cold | darkness | death | disease | divine | electricity | evil
            | fear | fire | force | good | language-dependent | lawful | light | mind-affecting
            | negative | nature | paralyze | poison | positive | sonic | teleportation
            | weapon enchantment = &nbsp;[ <b>[[Magic:Descriptors | Descriptors]]:</b> {{{Descriptor}}}
                {{#if: {{{Descriptor 2|}}}
                |  {{#switch: {{lc: {{{Descriptor 2}}} }}
                        | {{lc: {{{Descriptor}}} }} = <span style="color:red">, Duplicate "Descriptor 2" parameter value!</span>
                        | acid | chaotic | cold | darkness | death | disease | divine | electricity | evil
                        | fear | fire | force | good | language-dependent | lawful | light | mind-affecting
                        | negative | nature | paralyze | poison | positive | sonic | teleportation
                        | weapon enchantment = , {{{Descriptor 2}}}
                        | #default          = <span style="color:red">, Invalid "Descriptor 2" parameter value!</span>
                    }}
                    {{#if: {{{Descriptor 3|}}}
                    |  {{#switch: {{lc: {{{Descriptor 3}}} }}
                            | {{lc: {{{Descriptor}}} }} | {{lc: {{{Descriptor 2}}} }} = <span style="color:red">, Duplicate "Descriptor 3" parameter value!</span>
                            | acid | chaotic | cold | darkness | death | disease | divine | electricity | evil
                            | fear | fire | force | good | language-dependent | lawful | light | mind-affecting
                            | negative | nature | paralyze | poison | positive | sonic | teleportation
                            | weapon enchantment = , {{{Descriptor 3}}}
                            | #default          = <span style="color:red">, Invalid "Descriptor 3" parameter value!</span>
                        }}
                    }}
                }} ]
            | #default = &nbsp;[ <b>[[Magic:Descriptors | Descriptors]]:</b> <span style="color:red">Invalid "Descriptor" parameter value!</span> ]
        }}
    }}
| other = {{{School}}} ( <b>[[Magic:Spell_Format:Subschool | Subschool]]:</b> {{{Subschool}}} ) [ <b>[[Magic:Descriptors | Descriptors]]:</b> {{{Descriptors}}} ]
| demospace = {{{demospace|}}}
| page = {{{page|}}}
}} <br />
<b>[[Magic:Level | Level(s)]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Level|}}} | {{{Level}}} }} <br />
<b>[[Magic:Innate_Level | Innate Level]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Innate Level|}}} | {{{Innate Level}}} }} <br />
<b>[[Magic:Components | Component(s)]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Components|}}} | {{{Components}}} }} <br />
<b>[[Magic:Casting_Time | Casting Time]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Casting Time|}}} | {{{Casting Time}}} }} <br />
<b>[[Magic:Range | Range]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Range|}}} | {{{Range}}} }} <br />
<b>[[Magic:Target | Target]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Target|}}} | {{{Target}}} }} <br />
<b>[[Magic:Duration | Duration]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Duration|}}} | {{{Duration}}} }} <br />
<b>[[Magic:Counter | Counter(s)]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Counters|}}} | {{{Counters}}} }} <br />
<b>[[Magic:Saving_Throw | Saving Throw]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Saving Throw|}}} | {{{Saving Throw}}} }} <br />
<b>[[Magic:Spell_Resistance | Spell Resistance]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Spell Resistance|}}} | {{{Spell Resistance}}} }} <br />
<b>[[Magic:Metamagic | Metamagic]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Metamagic|}}} | {{{Metamagic}}} }} <br />
<b>[[Magic:Energy_Substitution | Energy Substitution]]:</b> {{#ifeq: {{NAMESPACE}} | {{ns:0}} | {{{Energy Substitution|}}} | {{{Energy Substitution}}} }} <br />
<!-- Redo the rest of these (above) to check if set, then give the "required" warnings. -->{{{Description Summary|{{ns detect | main = <span style="color:red">Missing "Description Summary" parameter value!</span> | other = {{{Description Summary}}} }} }}}
{{ifparadef | {{{Description Details|¬}}} | <br /><br />{{{Description Details}}} | {{ns detect | other = <br /><br />{{{Description Details}}} }} | {{ns detect | other = <br /><br />{{{Description Details}}} }} }}
{{ns detect | main =
[[Category:Magic |{{{Name |{{PAGENAME}} }}}]]
[[Category:{{{School}}}_Spells |{{{Name |{{PAGENAME}} }}}]] }}
| demospace = {{{demospace|}}}
| page = {{{page|}}}
}}<noinclude>
 
<!-- Add template documentation here, or include a doc subpage (see: http://wikipedia.org/wiki/Wikipedia:Template_documentation#How_to_create_a_documentation_subpage). -->
== Non-transcluded template documentation [or an included doc subpage] ==
 
Add template documentation here, or include a doc subpage (see: [[Wikipedia:Wikipedia:Template_documentation#How_to_create_a_documentation_subpage | How to create a documentation subpage]]).
 
* A <nowiki>{{</nowiki>[[Wikipedia:Template:Documentation |Documentation]]<nowiki>}}</nowiki> sub-template would be useful for all templates on this wiki, since they need usage documentation (stripped down version, without the dozens of other templates).
 
 
* [[Magic:Spell_Format]] should be here as documentation, instead of that hard to find page.
 
 
* Include instructions for using this in namespaces outside of main, with a simple <code>| demospace = main</code> parameter example above the name parameter.
 
 
* Obviously I've added more parameters for class and domain spells, similar to the NWN Wiki version of [[NWN:Template:Spell | Template:Spell]]. Their full parameter list is below (they don't use Subschool, and I used proper case with spaces for all parameters):
 
 
:'''Spell levels:'''
:*''bardlevel'' &mdash; The level of this spell when cast by a [[bard]]. ''Optional''
:*''clericlevel'' &mdash; The level of this spell when cast by a [[cleric]]. ''Optional''
:*''druidlevel'' &mdash; The level of this spell when cast by a [[druid]]. ''Optional''
:*''paladinlevel'' &mdash; The level of this spell when cast by a [[paladin]]. ''Optional''
:*''rangerlevel'' &mdash; The level of this spell when cast by a [[ranger]]. ''Optional''
:*''magelevel'' &mdash; The level of this spell when cast by a [[sorcerer]] or [[wizard]]. ''Optional''
:*''domain'' &mdash; The clerical [[domain]] that grants access to this spell. ''Optional''
:*''domainlevel'' &mdash; The level of this spell when granted by this domain. ''Required if domain is specified''
:*''domain2'' &mdash; A second clerical domain that grants access to this spell. ''Optional''
:*''domain2level'' &mdash; The level of this spell when granted by the second domain. ''Required if domain2 is specified''
:*''domain3'' &mdash; A third clerical domain that grants access to this spell. ''Optional''
:*''domain3level'' &mdash; The level of this spell when granted by the third domain. ''Required if domain3 is specified''
:*''domain4'' &mdash; A fourth clerical domain that grants access to this spell. ''Optional''
:*''domain4level'' &mdash; The level of this spell when granted by the fourth domain. ''Required if domain4 is specified''
:*''innatelevel'' &mdash; The innate level of this spell.
 
 
:'''Lines of spells:'''
:* ''line'' &mdash; a name for the spell line this spell belongs to. ''Optional, but if not set then ''line0'' through ''line9'' are ignored''
:* ''line0'' through ''line9'' &mdash; names of spells (not linked) that are considered in the same "line" of spells as the current spell. Use the parameter corresponding to the spell's innate level. Include the current spell. ''Optional, but some should be used if "line" is set''
:* ''linebreach'' &mdash; set this (to "yes") to get a table for the breach line of spells. (This is a hack to accommodate ''disjunction'' having two spell lines.) ''Optional''
 
 
:'''Other:'''
:*''area'' &mdash; The area affected by this spell. The values "small", "medium", "large", "huge", "gargantuan", "colossal", and "spellcone" should be used when appropriate.
:**''areanote'' &mdash; Additional information about the area of effect (e.g. a limit on the number of targets in a colossal area). ''Optional''
:**''conesize'' &mdash; This can override the default length of "10" for spell cones.
:*''components'' &mdash; "V", "S", or "VS" indicating the components this spell utilizes. ''Optional''
:*''counters'' &mdash; Additional counterspells, preferably linked. ''Optional''
:*''duration'' &mdash; The duration of the spell.
:*''immunity'' &mdash; The [[Magic:Descriptors | descriptor]] (immunity type) of this spell. ''Optional''
:*''range'' &mdash; "p", "t", "s", "m", or "l" indicating the range of the spell.
:*''save'' &mdash; The save allowed for this spell, preferably linked. ''Optional''
:*''school'' &mdash; The [[Magic:School | spell school]] of this spell, preferably linked.
:*''spellcraft'' &mdash; The spellcraft requirement (for epic spells). ''Optional, epic only''
:*''spellresistance'' &mdash; Should be "yes" if spell resistance can bock this spell. Should be "yes*" if the BioWare description says spell resistance can block this spell, but it does not actually do so. ''Optional''
 
:*''desc'' &mdash; The spell's in-game description.
:*''icon'' &mdash; The name of the image (icon) for this spell. ''Optional''
 
 
<!-- End of documentation. -->
{{ns detect | template = [[Category:Templates |{{PAGENAME}}]] }}</noinclude>
mplate parameter descriptions.
     Note: All parameter values (except the 'Description') should be in uppercase unless using full sentences. Try to keep any description of effects in the 'Description' parameter.",
     Note: All parameter values (except the 'Description') should be in uppercase unless using full sentences. Try to keep any description of effects in the 'Description' parameter.",
     "params": {
     "params": {

Revision as of 06:20, 4 January 2024

[[Magic:{{{School}}}|{{{School}}}]] {{{Subschool}}} {{{Descriptors}}}
Level: {{{Level}}}
Innate Level: {{{Innate Level}}}
Component(s): {{{Components}}}
Casting Time: {{{Casting Time}}}
Range: {{{Range}}}
Target: {{{Target}}}
Duration: {{{Duration}}}
Counter(s): {{{Counters}}}
Saving Throw: {{{Saving Throw}}}
Spell Resistance: {{{Spell Resistance}}}
Metamagic: {{{Metamagic}}}
Energy Substitution: {{{Energy Substitution}}}

{{{Description}}}

<templatedata> {

"description": "Spell te

This is a user sandbox of Gorgon. A user sandbox is a subpage of the user's user page. It serves as a testing spot and page development space for the user, and is not an Avlis wiki article.

Anything up to/including the Template start heading will not be included in transclusion of this template (or any part of the trailing documentation section either, though that will eventually be formalized template documentation, possibly with transcluded categories at the end).

I love to over-comment my code, so why change things here...




Test version of Template:Spell

Extensions that would make this work better [My wish list]


  • Extension:DynamicPageList (third-party) - Enhanced version of Extension:DynamicPageList (Wikimedia)
    • DPL:Overview - Generate dynamic reports based on category members and selective included info from each (Extension:Labeled Section Transclusion above would really help there).
    • DPL:Template:Catlist - Picture this totally reformatted as filter/sort options up top of the Spell List page, as a dynamic table. It starts showing all spells, but sortable with one click by level, school, class, or any other useful Template:Spell parameter/category used by them. Then add in the ability to filter results to only certain kinds/combinations (e.g, Show only cleric evocation spells, sorted by level, with the option of showing specific domain ones as well).
    • I doubt anyone else besides me would use this (except maybe the occasional dabbler), but it would really be useful for spells, and maybe a few other things eventually. Revamping all spells via this template is a huge undertaking (and my main goal for wiki updating, now that I can verify/test spells again), so adding this extension for that work alone would make a huge difference.
    • After looking into the more recent version of Extension:DynamicPageList (Wikimedia) (the one used by most Wikimedia projects, not the "enhanced - 3rd party one"), it may be just as useful (or better), since it allows more sort options. Need to see both in practical use before deciding anything.
    • I definitely want this now. The Extension:DynamicPageList (Wikimedia) version is off my wish list, since that functionality is pretty much the main reason I want it.
  • Extension:Arrays - For parsing things like the V, S, M in a single "Descriptors" parameter, without a lot of #explode etc. code (still looking for the best way to do that, and that needs the string parsing extensions enbled).


Revision notes


  • I think Buddha had the right idea with his discussion on the Categories page about reformatting how we categorize spells. The current Spell List page (and its various subversions) all rely on manual updating when any new changes happen to it, like a new spell being added. Revisions to this template will improve how each spell is displayed, and categorized (even without new extensions), so moving to category listings that update dynamically makes a lot of sense.




Can the Name template parameter be taken from the page name automatically?

  • Maybe as a default if not given as a parameter?
  • Might need some page renaming, but should work.
  • Keeping the template from categorizing itself as a spell might be annoying, unless namespace checking or other validation is done.


  • Taking the Name template parameter from the {{SUBPAGENAME}} isn't so simple.
    • The Magic: (and Epic Spell:) prefix needs to be stripped after checking if it exists, especially for using it as a sort key with categories. Checking for it is easy with something like {{#ifeq:{{lc:{{padleft:|6|{{SUBPAGENAME}}}}}}|magic:|}}. Removing it is harder. {{#explode:{{SUBPAGENAME}}|:|1}} could do it, but needs the parser functions for string handling enabled with $wgPFEnableStringFunctions = true; in LocalSettings.php (see the second top note at: Extension:StringFunctions).
      • All the spell pages should be stripped of these prefixes themselves. Someone was setting it up as if there were actual namespaces for them, but there aren't. Do I really want to get into that mess?
    • If the {{SUBPAGENAME}} has more than one word for the spell name, the second and latter words need to be capitalized.
      • Using some sort of {{#replace:{{#explode:{{SUBPAGENAME}}| |1}}|{{ucfirst:{{#explode:{{SUBPAGENAME}} code, that first counts the words and has enough depth levels for them all would get messy fast (for loop in wiki markup?).
      • Someone must have had a similar problem and found an easier solution, so do some searching.
    • We'll have to assume all page names like Bigbys have been changed to use apostrophes too (e.g., Bigby's) - no sane way to check and fix that here (well maybe a switch with the known names already, but new ones would need constant updates... which it what this is supposed to eliminate).
    • If it isn't easy, just make it a required parameter with error message, like the rest.




  • Redone using onlyinclude sections with transcludesection tags (See above).
    • Not as simple as Labeled Section Transclusion, and can't do some things with it, but good enough for now.
  • Major School/Subschool/Descriptors redo.
    • Added the Subschool: and Descriptors: prefixes, but they may make the School line too long.
    • Added a bunch of validation checks in switches.
  • Added Spell Name: at the top.
    • Having every spell "Name" be the page name "Magic:Name" was inaccurate and confusing.
    • Uses the Name = parameter, or {{SUBPAGENAME}} if not entered.
  • All parameters are now Proper Case.
  • Lowercase conversion is used for comparison validation of parameter values (when possible).
    • ifeq: and case entries in a switch are case sensitive, so this is necessary.
  • Proper Case conversion is used (when possible) in output results.
    • If people don't use the right case, this should fix at least some of the issues.
  • Added a bunch of namespace checks as part of the validation,
    • All spells should be in the Main namespace, so anything outside that is a template (or test page in a userspace).
    • Added a hak to make my sandbox spell pages work as if in Main (remember to change it back when publishing this).
  • Started making missing parameter entries (without forced defaults or warnings) not show in Main, instead of the {{{parameter name}}} (like in the Template namespace).
    • Better to add warnings (when defaults aren't possible) for all that should be included. If they see annoying red stuff, they will have to fix it.
  • Split Description Summary and Description Details parameters, so the summary can be transcluded as a short description elsewhere.
    • Need to make the Description Details optional (and conditional on the summary) and add a default "No description" blurb to the summary.
  • I don't like all the ifeq: {{NAMESPACE}}