Difference between revisions of "User:Pixali/comictemplate/"

Explain xkcd: It's 'cause you're dumb.
Jump to: navigation, search
m
(collapsed code to correct formatting)
Line 1: Line 1:
 
<!-- The old template with my changes is broken as hell. This is a rewritten version. -->
 
<!-- The old template with my changes is broken as hell. This is a rewritten version. -->
<includeonly>
+
<includeonly><metadesc>Explain xkcd is a wiki dedicated to explaining the webcomic xkcd. Go figure.</metadesc><!--
  <metadesc>Explain xkcd is a wiki dedicated to explaining the webcomic xkcd. Go figure.</metadesc>
+
 
 +
  Create the 'box' around the comic template
 
    
 
    
   <!-- Create the 'box' around the comic template -->
+
   --><table class="{{{bodyclass|}}}" cellspacing="5" style="background-color: #FFFFFF;
  <table class="{{{bodyclass|}}}" cellspacing="5"
+
      border: 1px solid #AAAAAA; color: black; font-size: 88%;
    style="background-color: #FFFFFF; border: 1px solid #AAAAAA; color: black; font-size: 88%; line-height: 1.5em;
+
      line-height: 1.5em; margin: 0.5em 0 0.5em 1em; padding: 0.2em;
      margin: 0.5em 0 0.5em 1em; padding: 0.2em; text-align: center; width:98%; {{{bodystyle|}}}">
+
      text-align: center; width:98%; {{{bodystyle|}}}"><!--
 
 
    <!-- This table will contain a table row (tr) and cell (td) -->
 
    <tr><td>
 
 
        
 
        
       <!-- Now make an unordered list which will display as the navigation bar -->
+
       This table will contain a table row (tr) and cell (td)
      <ul style="text-align: center; margin-bottom: 10px;" class="no-link-underline">
+
  --><tr><td><!--
       
+
 
        <!-- Generate the |< and prev buttons, but only if {{{number}}} exists and is greater than 1 -->
+
      Now make an unordered list which will display as the navigation bar
        {{#ifexpr: {{{number|-1}}} > 1
+
  --><ul style="text-align: center; margin-bottom: 10px;" class="no-link-underline"><!--
         
+
 
          <!-- {{{number}}} is greater than 1; make a list item and put a button in it that links to #1 -->
+
      Generate the |< and prev buttons, but only if {{{number}}} exists and is greater than 1
          | <li style="background-color: #6E7B91;
+
    -->{{#ifexpr:{{{number|-1}}}>1<!--
 +
   
 +
        {{{number}}} is greater than 1; make a list item and put a button in it that links to #1
 +
      -->|<li style="background-color: #6E7B91;
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
               margin: 0 4px; padding: 1.5px 0;">
+
               margin: 0 4px; padding: 1.5px 0;"><!--
            <!-- link to #1 -->
+
              link to #1
            [[1|<span style="color: #FFFFFF; padding: 0 12px;">&#124;&lt;</span>]]
+
        -->[[1|<span style="color: #FFFFFF; padding: 0 12px;">&#124;&lt;</span>]]</li><!--
            </li>
+
       
           
+
        We're not done here yet, make the back button next
            <!-- We're not done here yet, make the back button next -->
+
        --><li style="background-color: #6E7B91;
            <li style="background-color: #6E7B91;
 
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
               margin: 0 4px; padding: 1.5px 0;">
+
               margin: 0 4px; padding: 1.5px 0;"><!--
              <!-- link to previous comic -->
+
             
              [[{{#expr:{{{number}}} - 1}}|<span style="color: #FFFFFF; padding: 0 12px;">&lt;&nbsp;Prev</span>]]
+
              link to previous comic
            </li>
+
          -->[[{{#expr:{{{number}}}-1}}|<span style="color: #FFFFFF; padding: 0 12px;">&lt;&nbsp;Prev</span>]]</li><!--
          <!-- {{{number}}} doesn't exist or is less than 1; just put non-breaking spaces here -->
+
             
          | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
              {{{number}}} doesn't exist or is less than 1; just put non-breaking spaces here
        }}
+
              -->|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}}<!--
        <!-- Regardless of {{{number}}}, we need to make the comic date, link etc. -->
+
       
        <li style="background-color: #6E7B91;
+
        Regardless of {{{number}}}, we need to make the comic date, link etc.
 +
      --><li style="background-color: #6E7B91;
 
           border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
           border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
           display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
 
           display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
 
           margin: 0 4px; padding: 1.5px 0;"
 
           margin: 0 4px; padding: 1.5px 0;"
            class="plainlinks">
+
          class="plainlinks"><!--
 +
         
 +
          [ and ] makes an external link, vs. [[ and ]] which are internal only.
 +
          Depending whether {{{number}}} exists or not, toggle between using wide link mode or number link mode.
 +
          Wide link mode requires {{{lappend}}} to be set, while {{{ldomain}}} can default to www
 +
          -->[{{#ifexpr:{{{number|-1}}}>=1<!--
 
            
 
            
           <!-- [ and ] makes an external link, vs. [[ and ]] which are internal only. -->
+
           Comic number is probably valid, use number link mode
          <!-- Depending whether {{{number}}} exists or not, toggle between using wide link mode or number link mode. -->
+
          -->|http://www.xkcd.com/{{{number}}}/<!--
          <!-- Wide link mode requires {{{lappend}}} to be set, while {{{ldomain}}} can default to www -->
+
         
          [{{#ifexpr: {{{number|-1}}} >= 1
+
          Comic number is invalid or doesn't exist, use wide link mode
            <!-- Comic number is probably valid, use number link mode -->
+
          -->|http://{{{ldomain|www}}}.xkcd.com/{{{lappend}}}/}}<!--
            | http://www.xkcd.com/{{{number}}}/
+
         
            <!-- Comic number is invalid or doesn't exist, use wide link mode -->
+
          Generate the title, with date if it exists
            | http://{{{ldomain|www}}}.xkcd.com/{{{lappend}}}/
+
          --><span style="color: #FFFFFF; padding: 0 12px;">Comic&nbsp;<!--
          }}
+
           -->{{#ifexpr:{{{number|-1}}}>= 1||&#35;}}{{{number|}}}&nbsp;{{#if:{{{date|}}}|({{{date}}})}}</span>]</li><!--
          <!-- Generate the title, with date if it exists -->
+
         
          <span style="color: #FFFFFF; padding: 0 12px;">Comic&nbsp;
+
        Now make the next and >| buttons provided comic number exists
           {{#ifexpr: {{{number|-1}}} >= 1 ||&#35;}}{{{number|}}}&nbsp;{{#if:{{{date|}}}|({{{date}}})}}</span>]
+
        -->{{#ifexist:{{#expr:{{{number|-1}}}+1}}<!--
        </li>
+
       
        <!-- Now make the next and >| buttons provided comic number exists -->
+
        Comic number is valid, generate the buttons
        {{#ifexist: {{#expr: {{{number|-1}}} + 1}}
+
        -->|<li style="background-color: #6E7B91;
          <!-- Comic number is valid, generate the buttons -->
 
          | <li style="background-color: #6E7B91;
 
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
               margin: 0 4px; padding: 1.5px 0;">
+
               margin: 0 4px; padding: 1.5px 0;"><!--
              [[{{#expr:{{{number}}} + 1}}|<span style="color: #FFFFFF; padding: 0 12px;">Next&nbsp;&gt;</span>]]
+
        -->[[{{#expr:{{{number}}}+1}}|<span style="color: #FFFFFF; padding: 0 12px;">Next&nbsp;&gt;</span>]]</li><!--
            </li>
+
       
            <!-- Make a button that points to LATESTCOMIC (which is of course the latest comic) -->
+
        Make a button that points to LATESTCOMIC (which is of course the latest comic)
            <li style="background-color: #6E7B91;
+
        --><li style="background-color: #6E7B91;
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               border: 1.5px solid #333333; border-radius: 3px 3px 3px 3px; box-shadow: 0 0 5px 0 gray;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
 
               display: inline; font-size: 16px; font-variant: small-caps; font-weight: 600;
               margin: 0 4px; padding: 1.5px 0;">
+
               margin: 0 4px; padding: 1.5px 0;"><!--
               [[{{LATESTCOMIC}}|<span style="color: #FFFFFF; padding: 0 12px;">&gt;&#124;</span>]]
+
               -->[[{{LATESTCOMIC}}|<span style="color: #FFFFFF; padding: 0 12px;">&gt;&#124;</span>]]</li><!--
            </li>
+
       
          <!-- Comic number (plus one) is not valid, don't show the buttons -->
+
        Comic number (plus one) is not valid, don't show the buttons
          | &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
        -->|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}}</ul><!--
        }}
+
    --></td></tr><!--
      </ul>
+
   
     </td></tr>
+
    Now that the nav bar has been generated, display the rest of the filled-out comic template
 +
   
 +
    Comic title in =BOLD=
 +
    -->{{#if:{{{title|}}}|<tr><td style="font-size: 20px; padding-bottom:10px">'''{{{title}}}'''</td></tr>}}<!--
 +
   
 +
    Display the (optional) text just before the comic
 +
     -->{{#if:{{{before|}}}|<tr><td style="padding-bottom:10px">{{{before}}}</td></tr>}}<!--
 +
   
 +
    Almost done; just need to display the comic, title text and a bit more
 +
    --><tr><td><!--
 
      
 
      
     <!-- Now that the nav bar has been generated, display the rest of the filled-out comic template -->
+
     {{{custom}}} will replace the image with whatever it contains if it exists
 +
    -->{{#if: {{{custom|}}}|{{{custom|}}}<!--
 
      
 
      
     <!-- Comic title in =BOLD= -->
+
     Not going to replace the image, so let's draw that if it exists
    {{#if:{{{title|}}}|<tr><td style="font-size: 20px; padding-bottom:10px">
+
    -->|{{#if:{{{image|}}}|[[File:{{{image|}}}|{{{imagesize|}}}|{{{titletext|}}}]]}}}}<!--
      '''{{{title}}}'''
 
    </td></tr>}}
 
 
      
 
      
     <!-- Display the (optional) text just before the comic -->
+
     {{{imagesize}}} will allow the comic to be shrinked if it's especially large
    {{#if:{{{before|}}}|<tr><td style="padding-bottom:10px">
+
    -->{{#if:{{{imagesize|}}}|<br />[Click comic to enlarge]}}<!--
      {{{before}}}
 
    </td></tr>}}
 
 
      
 
      
     <!-- Almost done; just need to display the comic, title text and a bit more -->
+
     Final bit; if the comic has text on mouse-over, add that in a small print underneath the comic
    <tr><td>
+
    -->{{#if:{{{titletext|}}}|<br /><span style="{{{captionstyle|}}}"><span style="color:grey">Title text:</span> {{{titletext}}}<!--
      <!-- {{{custom}}} will replace the image with whatever it contains if it exists -->
+
    --></span>}}</td></tr></table><!--
      {{#if: {{{custom|}}}
+
   
      | {{{custom|}}}
+
    Categorisation for people who like that kind of thing
      <!-- Not going to replace the image, so let's draw that if it exists -->
+
   
      | {{#if:{{{image|}}}
+
    Sort this page in categories by number. The padding ensures that #9 comes before #10
        | [[File:{{{image|}}} | {{{imagesize|}}} | {{{titletext|}}}]]
+
    It otherwise sorts 'alphanumerically'; as in since the first char of 10 is 1, it would normally be placed before 9
        }}
+
    The padding turns each into 0009 and 0010 etc. and since 0 is less than 1, #9 gets sorted before #10.
      }}
+
    -->{{#ifexpr:{{{number|-1}}}>=1|{{DEFAULTSORT:&nbsp;{{padleft:{{{number}}}|4}}}}|<!--
      <!-- {{{imagesize}}} will allow the comic to be shrinked if it's especially large -->
+
    -->}}<!--
      {{#if:{{{imagesize|}}}|<br />[Click comic to enlarge]}}
+
   
      <!-- Final bit; if the comic has text on mouse-over, add that in a small print underneath the comic -->
+
  Only categorise if in the main namespace
      {{#if:{{{titletext|}}}|<br /><span style="{{{captionstyle|}}}"><span style="color:grey">Title text:</span> {{{titletext}}}</span>}}
+
  -->{{#ifeq:{{NAMESPACE}}|{{ns:0}}<!--
    </td></tr>
 
  </table>
 
 
 
  <!-- Categorisation for people who like that kind of thing -->
 
 
    
 
    
   <!-- Sort this page in categories by number. The padding ensures that #9 comes before #10 -->
+
   Don't try to categorise the main page
  <!-- It otherwise sorts 'alphanumerically'; as in since the first char of 10 is 1, it would normally be placed before 9 -->
+
   -->|{{#ifeq:{{FULLPAGENAME}}|{{int:mainpage}}<!--
   <!-- The padding turns each into 0009 and 0010 etc. and since 0 is less than 1, #9 gets sorted before #10. -->
 
  {{#ifexpr: {{{number|-1}}} >= 1
 
  | {{DEFAULTSORT:&nbsp;{{padleft:{{{number}}}|4}}}}
 
  | <!-- Nothing -->
 
  }}
 
 
    
 
    
  <!-- Only categorise if in the main namespace -->
+
     Alright, start putting it in the appropriate date categories
  {{#ifeq:{{NAMESPACE}}|{{ns:0}}
+
    -->||[[Category:Comics]]{{#if:{{{date|}}}|[[Category:Comics from {{#time:Y|{{{date}}}}}]]<!-- Years
     <!-- Don't try to categorise the main page -->
+
    -->[[Category:Comics from {{#time:F|{{{date}}}}}]]                                       <!-- Months
  | {{#ifeq:{{FULLPAGENAME}}|{{int:mainpage}}
+
    -->[[Category:{{#time:l|{{{date}}}}} comics]]                                           <!-- Weekdays
      <!-- Alright, start putting it in the appropriate date categories-->
+
    -->}}}}|}}<!--
    || [[Category:Comics]]
+
--></includeonly><noinclude>
      {{#if:{{{date|}}}
 
      | [[Category:Comics from {{#time:Y|{{{date}}}}}]] <!-- Years   -->
 
        [[Category:Comics from {{#time:F|{{{date}}}}}]] <!-- Months   -->
 
        [[Category:{{#time:l|{{{date}}}}} comics]]     <!-- Weekdays -->
 
      }}
 
    }}
 
  |}}
 
</includeonly><noinclude>
 
 
<!-- and now for the documentation. -->
 
<!-- and now for the documentation. -->
 
This is the basic infobox-style header template used to display [[xkcd]] comics on their own pages, including the comic number (with external link to xkcd), publication date, title, comic image, and title text.
 
This is the basic infobox-style header template used to display [[xkcd]] comics on their own pages, including the comic number (with external link to xkcd), publication date, title, comic image, and title text.
Line 167: Line 160:
 
* If the '''custom''' field is not empty, the image field will be ignored and be replaced with any text that you put in the '''custom''' field.
 
* If the '''custom''' field is not empty, the image field will be ignored and be replaced with any text that you put in the '''custom''' field.
 
* if '''number''' is left undefined, most of the navigation bar will be disabled.
 
* if '''number''' is left undefined, most of the navigation bar will be disabled.
** '''lappend''' must be defined as <code>...kd.com/lappend/</code> to keep the link to xkcd.com valid.
+
** '''lappend''' must be defined as <pre>...kd.com/'''lappend'''/</pre> to keep the link to xkcd.com valid.
** If the link is to eg. a blog post (blog.xkcd.com) '''ldomain''' can be defined as <code>blog</code> to change the subdomain in the link.
+
** If the link is to eg. a blog post (blog.xkcd.com) '''ldomain''' can be defined as <pre>blog</pre> to change the subdomain in the link.
  
 
The example in [[User_talk:Pixali/comictemplate/|the talk page]] is produced by the following code:
 
The example in [[User_talk:Pixali/comictemplate/|the talk page]] is produced by the following code:

Revision as of 04:37, 6 March 2015


This is the basic infobox-style header template used to display xkcd comics on their own pages, including the comic number (with external link to xkcd), publication date, title, comic image, and title text. This is an upgraded version that has support for undefined/invalid numbers; allowing use with comics that are not present in the main series (for example, Radiation).

Sample

The following is a sample usage of this template: (see talk page)

Usage

{{comic
| number    =
| date      =
| title     =
| before    =
| image     =
| custom    =
| imagesize =
| titletext =
| ldomain   =
| lappend   =
}}

Notes

  • At least the number, title and image are required.
  • The date should be written in the form: January 1, 2006
  • The imagesize field is optional.
    • The comic's width will be limited to the set size. Format must be in pixels (eg: "350px")
    • The comic's height may be set by adding an 'x' to the start (eg: "x350px")
    • Warning: If the size is larger than the image, the image will be stretched.
  • before is a special field for inserting text before the comic. One use is for extremely large comics (e.g. Umwelt), to skip to the explanation.
  • If the custom field is not empty, the image field will be ignored and be replaced with any text that you put in the custom field.
  • if number is left undefined, most of the navigation bar will be disabled.
    • lappend must be defined as
      ...kd.com/'''lappend'''/
      to keep the link to xkcd.com valid.
    • If the link is to eg. a blog post (blog.xkcd.com) ldomain can be defined as
      blog
      to change the subdomain in the link.

The example in the talk page is produced by the following code:

{{User:Pixali/comictemplate/
| date      = October 4, 2005
| title     = Example with different link
| image     = schrodinger.jpg
| titletext = I went to a dinner where there was a full 10 minutes of Holy Grail quotes exchanged, with no context, in lieu of conversation.  It depressed me badly.
| ldomain   = www
| lappend   = radiation
}}