Template:Job table/doc: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
No edit summary
Line 23: Line 23:
Maybe the name of the page you're working on is [[visual effects producer]] but the property is [[Property:VFX producer]].  In this case, you'll have to make a slight modification: {{tlx|job table|job1=VFX producer}}.  This ability to change the property name comes in handy when you want to drop on of these tables onto a completely different page, as was done above with the table of writers.
Maybe the name of the page you're working on is [[visual effects producer]] but the property is [[Property:VFX producer]].  In this case, you'll have to make a slight modification: {{tlx|job table|job1=VFX producer}}.  This ability to change the property name comes in handy when you want to drop on of these tables onto a completely different page, as was done above with the table of writers.
=== When there's a ''lot'' of output ===
=== When there's a ''lot'' of output ===
For some of the more ubiquitous titles, like [[writer]], you'll probably want to break the table down into smaller tables — logically, one for each show.  Or maybe you're working on a series page where you want to show only the writers for that particular series.  In these cases you'll want to narrow the category down.  For instance, {{tlx|job table|job1=DOP|cat=Series 5 (Doctor Who) stories}} will show you all the [[DOP|directors of photography for series 5.
For some of the more ubiquitous titles, like [[writer]], you'll probably want to break the table down into smaller tables — logically, one for each show.  Or maybe you're working on a series page where you want to show only the writers for that particular series.  In these cases you'll want to narrow the category down.  For instance, {{tlx|job table|job1=DOP|cat=Series 5 (Doctor Who) stories}} will show you all the [[DOP|directors of photography]] for series 5.
{{job table|job1=DOP|cat=series 5 (Doctor Who) stories}}
{{job table|job1=DOP|cat=series 5 (Doctor Who) stories}}
==Limitations==
{{As of|2012|5}}, there are a ''lot'' of limitations.  At present, you can only categorise one element.  This means you can't sort by the story number or the series number — nor can you put, say, directors and cinematographers in the same table — all of which would clearly be desirable.  You also can't affect the titles in the headers.
However, none of these problems is likely insoluble.  And there's certainly a way to do ''all'' of that with SMW, manually.  These functionalities have merely not been integrated into '''this template''' as of yet.
== How it works ==
== How it works ==
This template is powered by [[T:SMW|SMW]], a powerful extension to the standard MediaWiki software which allows the creation of truly relational data.
This template is powered by [[T:SMW|SMW]], a powerful extension to the standard MediaWiki software which allows the creation of truly relational data.

Revision as of 00:03, 15 May 2012

{{Job table/doc}} is one of four templates used to create tables which list the episodes that have had a particular credit. The other templates in this series — all of which are required for the final product — are:

  • {{job table head}}, the template that creates the table headers
  • {{job table foot}}, the template that closes the template
  • {{job table core}}, the template that formats the data in the main body of the template
  • {{job table}}, the template that actually gets put on pages

Usage

Default variables

By default, this template assumes that it is working on all pages within the broad category, category:television stories. It also assumes that you are attempting to tabulate information about the property that has the same name as the page name.

These assumptions can both be changed.

Simplest case

In most instances, you would just place {{job table}} on a page and be done with it. As long as the page name matches the name of the [[Special:Properties|property}} name, you don't really need to do much else.

If I typed {{job table}} on the page 3D artist, it will automatically generate a table which was formatted like the rest of our infoboxes and tables. On the list would be all the 3D artists who had been credited on any episode of any television show that this wiki covers.

You can see this most dramatically by choosing a more ubiquitous title like writer.


... further results

The list always appears in a collapsed state — a condition which cannot be changed by using this template. Also the list is organised in alphabetical order of the title of the story, but it respects {{TitleSort}}. This means that [[wikipedia:article (grammar)|]]s at the beginning of titles are not considered during alphabetisation.

More complicated cases

When the {{PAGENAME}} doesn't match the property name

Maybe the name of the page you're working on is visual effects producer but the property is Property:VFX producer. In this case, you'll have to make a slight modification: {{job table}}. This ability to change the property name comes in handy when you want to drop on of these tables onto a completely different page, as was done above with the table of writers.

When there's a lot of output

For some of the more ubiquitous titles, like writer, you'll probably want to break the table down into smaller tables — logically, one for each show. Or maybe you're working on a series page where you want to show only the writers for that particular series. In these cases you'll want to narrow the category down. For instance, {{job table}} will show you all the directors of photography for series 5.

Limitations

As of May 2012, there are a lot of limitations. At present, you can only categorise one element. This means you can't sort by the story number or the series number — nor can you put, say, directors and cinematographers in the same table — all of which would clearly be desirable. You also can't affect the titles in the headers.

However, none of these problems is likely insoluble. And there's certainly a way to do all of that with SMW, manually. These functionalities have merely not been integrated into this template as of yet.

How it works

This template is powered by SMW, a powerful extension to the standard MediaWiki software which allows the creation of truly relational data.

Retrieved from "https://tardis.wiki/w/index.php?title=Template:Job_table/doc&oldid=1097292"