CZ:Using the subpages template

From Citizendium
Revision as of 16:32, 5 September 2007 by imported>Chris Day
Jump to navigation Jump to search

The current active template is {{subpages9}} although we will transition to the {{subpages}} template very soon.

Why use the Subpages template?

What is the role for the subpages template? The short version is that when this template is on every page in a cluster it saves time and makes the categorisation and look of all the pages consistent.

At first glance it adds the navigation tabs at the top of the page and can identify and add a tab for each subpage in the cluster. While this is useful the real power is not so obvious. Using the information about each article that is stored on a specific metadata template, the subpages template manages the placement of categories and approval templates in a cluster. For example, if one new workgroup is added, or one removed, from the metadata template this has an immediate global effect on the categories in the whole cluster. This save a lot of time since the manual placement or removal of categories is no longer required. This has the added advantage that all the pages in a cluster are consistent at all times.

Additionally the headers for each subpage are currently added automatically and in the future this one template will allow us to modify the design or wording of ALL pages with a minimal number of edits. The checklist table also "magically" appears on the talk page of the article after the checklist fields are completed on the metadata template.

The final advantage is for the constables and editors who manage the approval process. Just the addition of an editors name in the ToApprove section will cause the ToApprove template to appear on all subpages in a cluster and add the article to the ToApprove category. This more simplae approach to managing the approval process should help make the easier since only the metadata template needs to be edited to set up process in the whole cluster. Similarly the Approval templates are correctly placed on the approved article. Note also that we currently have different background colours for the navigation tabs between approved and unapproved articles. This has the advantage that the approved articles are move obvious when browsing between the different subpages.

How to use the Subpages template

1) Place {{subpages9}} at the top of every page in a cluster, including all talk pages and subpages.

2) For the subpages9 template to function correctly it is important to set up an additonal Metadata template for each article. This is easily done by cutting and pasting the following code to a generic template named Template:ARTICLENAME/Metadata.

{{#switch: {{{info}}}
<!--Pagename must be filled out for template to work correctly-->
|       pagename =
|        dialect =
<!--required for checklist -->
|            abc = 
|      cat_check = 
|         status = 
|    underlinked = 
|        cleanup = 
|             by = 
|           cat1 = 
|           cat2 = 
|           cat3 = 
<!--required for ToApprove template-->
|    article url =
|    subpage url = 
|        cluster =
|            now =
|     ToA editor = 
|    ToA editor2 =
|    ToA editor3 =
|           date =
<!--required for Approved template-->
|       A editor = 
|      A editor2 = 
|      A editor3 =
}}

The checklist parameters should be filled out in the usual way (see instructions below for a description of usage for all the fields in the metadata template.) Converting a current article is easily achived by cutting and pasting the parameters from the current checklist, that already exists on the talk page, to the new Metadata template for the article.

3) In addition to the checklist parameters it is also important to complete the pagename parameter. A warning note will pop up on the navigation template if this is not done.

4) Two other pages need to be created to complete the new cluster. An approval subpage and a Unused subpages list. A {{subpages9}} template should be placed at the top of both these pages. Neither of these pages are as important as the metadata template page and they could be created at a later date.

Parameters

General parameters

pagename = The exact pagename is used. It is required for navigation back to the home page on subpages.
dialect = will be used to designate the spelling and grammar, primarily whether the article is written in American or English English.

Checklist parameters

abc = used to categorise based on last names. For example, the Barbara McClintock approval template is written as abc = McClintock, Barbara so she is categorised under M, or List of Biologists would be abc = Biologists, List of so it is categorised under B.
cat_check = put "yes" if you want someone to check over the categories
status = 0 for approved articles; 1 developed, 2 developing, 3 stub, 4 external
underlinked = put "yes" if not enough other articles link to it (click "What links here" at left)
cleanup = put "yes" if basic cleanup has been done.
by = Names of anyone editing the checklist, in reverse chronological order.
cat1 = must be an existing workgroup
cat2 = second workgroup (optional but must use before group3 if only two workgroups)
cat3 = third workgroup (optional)

ToApprove parameters

Type of approval:
Whole cluster use the article url and the cluster field.
Article only use the article url and leave the cluster field blank.
Subpage only us the subpage url field and leave the cluster field blank.
Article and ONE subpage use both the article and subpage url fields but leave the cluster field blank.
article url = the location in the page history where the version-to-approve lives.
subpage url = the location in the page history where the version-to-approve lives.
cluster = add text here if the whole cluster needs to be approved, otherwise leave blank.
now = the date and time when the template is added. Use ~~~~~ (five tildes) to let the computer generate it automatically.
ToA editor = the username of the person who did the approval (or who nominated the article on behalf of a group of people)
ToA editor2 = second editor (optional field but must use before editor3 if only two editors approved)
ToA editor3 = third editor (optional field)
date = format yyyymmdd (typically three days after "now", to allow copyedits and suggestions)

Approved template

A editor = the username of the person who initiated the approval (or who nominated the article on behalf of a group of people)
A editor2 = second editor (optional field but must use before editor3 if only two editors approved)
A editor3 = third editor (optional field)