CZ:Using the subpages template

From Citizendium
Revision as of 13:10, 18 October 2007 by imported>D. Matt Innis (moving a page with subpages)
Jump to navigation Jump to search
Citizendium Technical Help
How to edit an article | Searching | Start article with subpages
The Article Checklist | Subpage template

|width=10% align=center style="background:#F5F5F5"|  |} The current active template is now {{subpages}}.

Why use the Subpages template?

At first glance the subpages template adds the navigation tabs at the top of the page, and while this is useful, the real power of the template is not as obvious. The short version is that when this template is used on every page in an article cluster it saves time and makes the categorisation and look of the pages consistent.

Adds subpage navigation box

Requires that each subpage is a recognised name; see the current list of available subpage types at Template:Subpage list 2

The template adds a subpage navigation box at the top of each page in the article cluster. It can automatically identify each subpage in an article cluster and automatically adds a tab to the navigation box for each one present.

Automatic placement of categories

Requires that each cluster has a metadata template; see an example at Template:Biology/Metadata

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 saves 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.

Automatic placement of headers

Headers for each subpage are added automatically and in the future this one template will allow us to modify the design or wording of ALL the articles in the citizendium 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.

Automatic placement of approval templates

Requires that each cluster has an approval subpage; see an example at Biology/Approval

Constables and editors who manage the approval process will only have to edit the metadata template. Just the addition of an editors name in the ToApprove section of the metadata template will cause the {{ToApprove}} template to appear on all subpages in a cluster and add the article to the ToApprove category. This more simple approach to managing the approval process should help make the approval process easier. With similar ease the {{Approved}} template is correctly placed on an approved article by correctly updating the metadata template.

A consistent look

A final aesthetic touch is that the subpages template controls the background colours for the navigation tabs of approved (green) and unapproved (blue) articles. This has the advantage that the approved articles are move obvious when browsing between the different subpages. The consistent placement of all the navigation tools, notices and categories will make browsing CZ articles much more predicatable for a new user.

Instructions for placing the Subpages template

1) Type {{subpages}} at the top of the article page and save. Don't worry that the page looks messy.

2) Below the messy green template is a prompt to create a metadata template. Replace the ARTICLE_NAME with the name of your article and click the button just below it. A new page will open and you will see an edit box containing the following fields:

{{#switch: {{{info}}}
<!--Pagename must be filled out for template to work correctly-->
|       pagename =
|        variant =
<!--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 =
}}<noinclude>{{subpages}}</noinclude>

3) Fill out the "pagename" (the exact title of the article) and "abc" (same as the pagename, but if a biography: last name, first) and preferably "cat1" too (see our workgroup list). If you want to complete the whole checklist section, which would be nice, see The Article Checklist or read the see descriptions below for all the fields in the metadata template. Don't fill out the "required for ToApprove template" and "required for Approved template" sections.

4) Your article may have already been started and had a TALK page;

a) If this article did not have a TALK page, return to the main article, you will be prompted to create the two utility pages that are common to all articles; the Talk page and the Approval page.
b) If it did have a TALK page already and it has a {{checklist}}, go to the talk page and change the word 'checklist' in the {{checklist}} template to 'subpages'. Select and CUT the sections of the old template from |abc to |date. Click to save. You will then be prompted to 'Create the Approved' page from there. Just click on the blue link and save. Return to the metadata page and Select in the 'checklist' section from |abc to |date and then paste the contents that you cut from the talk page into the metadata page.

5) Once the metadata page and both utility pages are created the article cluster is complete. You are finished!

Parameters

General parameters

pagename = The exact pagename is used. It is required for navigation back to the home page on subpages.
variant = will be used to designate the spelling and grammar, primarily whether the article is written in AE - American, AuE - Australian, BE - British or CE - Canadian 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)

Moving an article with subpages

In the event that it is necessary to move or rename an article. It is necessary to move the metadata page as well. The alternative would be to create a new metadata page with the new name and then delete the old one. Don't forget to copy and paste any information from the old template to the new one.