CZ:Subpages: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Larry Sanger
No edit summary
imported>Gareth Leng
 
(101 intermediate revisions by 12 users not shown)
Line 1: Line 1:
'''Dear Citizens,'''
{{editintro}}


With an aim of expanding the scope of the ''Citizendium'' to include a number of different [[Biology/Gallery|subpage]] types, and so that we can get some experience with the whole idea of [http://forum.citizendium.org/index.php/topic,973.msg7974.html#msg7974 subpages and subprojects,] I'd like to work with you all on adding a full complement of subpages to a particular article.
A full [[Citizendium]] [[CZ:Article structure|article]] includes a main article [[MediaWiki page|page]] and standard and optional [[MediaWiki subpage|subpages]]; the entire group is called a ''cluster''.


So what topic would you like to "give the subpage treatment to"?  This will be the topic to which we give, for the first time, the "complete" Citizens' Compendium treatment. This would involve putting the following items on their own subpages:
Some subpages contain additional content on the subject of the article. Others are used for a variety of functions, such as discussing the article content, recording information about ''[[CZ:Approval Process|approved]]'' versions of articles (stable versions which have been checked and approved by an [[CZ:Editor|Editor]]), etc.


* '''Links:''' expanding and annotating the list of Web links about the topic
The subpage mechanism provides a header on every page or subpage of a cluster which allows easy navigation among the pages of the cluster. In addition, the header on the ''Talk'' subpage provides access to additional subpage-related functions.
* '''Bibliography:''' annotating and, if necessary, expanding the list of important published books and articles on the topic; link to online source (articles: abstracts, full-text; book: table of contents, reviews in respected sources, author info)
* '''Categories:''' creating an excellent list of subtopics, supertopics, and related topics
* '''Catalogs:''' one or more pages containing almanac-type information about some aspect of the topic, in tabular form; see, e.g., [[catalog of religions]])
* '''Gallery:''' an image gallery
* '''Invited, signed articles:''' one or more possibly "biased" articles written exclusively by real experts
* '''Debate guide:''' one or more pages giving a "map of the dialectical landscape," an account of the arguments on all sides of a controversial issue about the topic; if important to read "map", give dates arguments introduced, a timeline
* '''News guide:''' one or more pages summarizing of ongoing stories about the topic (such that a story itself will probably not become its own encyclopedia article!)
* '''Tutorials:''' one or more pages that introduce a topic specifically for students; would be focused on more "practical" aspects of the topic, have more examples, and even perhaps some problems at the bottom of the page
* '''Timelines:''' one or more pages giving a timeline about some aspect of the topic


In a way, I'm asking: what is going to be our first "CZ 2.0" article?  Here are some constraints for our first showcase topic. It would be nice if the encyclopedia article itself were already well-developed; there were already some ancillary pages, such as a gallery; and if we can imagine adding all the relevant information types described (including "debate guide" and "news summary" topics).
You might look at the [[Biology]] article and its subpages--our "biology cluster"--as an example. The [[Civil society]] article also includes many subpages, including [[CZ:Timelines|Timelines]] in recently (2008) revised format.


'''Accepting nominations, and votes, below.'''  Nominate an article by linking to it; vote for it (you may vote for as many articles as you like) by writing your name after it (separate names by a semicolon <code>;</code> ).  Note, if you vote, you must make at least one edit to the whole article + subpages (an item for which we need a name).
Some of the standard subpages, such as the Talk page, and the [[CZ:Approval|Approval]] subpage, are attached to a main (encyclopedia) page semi-automatically when the main article page is set up to use the [[CZ:Article Checklist|article checklist]]. Other standard and optional subpages can be added by authors or editors.


--[[User:Larry Sanger|Larry Sanger]] 17:03, 5 July 2007 (CDT)
== Basic guidelines ==


P.S. You can now see an example of basic subpage/template functionality on my user page (look in the upper right corner): [[User:Larry Sanger|Larry Sanger]] 22:27, 5 July 2007 (CDT)
===Setting up subpages===


Our first "infoset" will be:
To enable the full subpage functionality:


'''<font size="6">[[Biology/Draft|Biology]]</font>'''
* Include the string <code><nowiki>{{subpages}}</nowiki></code> (which is a [[MediaWiki template]] which invokes the Citizendium subpage functions) at the top of the main article page - and later, all of its subpages, and:
* Create a ''[[CZ:Metadata|Metadata]]'' page for the cluster; the Citizendium subpage system will automatically prompt to do this after the first page or subpage with <code><nowiki>{{subpages}}</nowiki></code> on it has been saved. You will need to fill in some basic information in the Metadata, such as the article name. ''Note:'' the Citizendium subpage mechanisms will not work properly unless the article name is entered correctly.
 
This is enough to turn on the subpage functionality; the system will also prompt to create the Talk and Approval subpages, if they do not exist, and will provide default contents for them which only have to be saved (although they can be modified first, if desired).
 
Don't forget that it is desirable to install the <code><nowiki>{{subpages}}</nowiki></code> statement on all individual subpages. Basic information about subpages is now included in the text in the subpage header on the Talk subpage.
See the [[CZ:Using the Subpages template#Instructions for placing the Subpages template|instructions]] for more details on how to set up an article page to use subpages.
 
=== Default content subpages===
 
In addition to the Metadata, Talk, and Approval subpages, there are three "default" subpages for ''every'' article:
 
* [[CZ:Related Articles|Related Articles]]
* [[CZ:Bibliography|Bibliography]]
* [[CZ:External Links|External Links]]
 
When articles are approved, another basic type is added, to allow Citizendium [[CZ:Author|authors]] and editors to  work on a future revision of the article, alongside the stable, approved, version:
 
* Draft
 
<!-- A special initiative during 2007 added subpage capacilities to all previously created main pages that lacked them. @@Ancient history, now...@@ -->
Activation of individual article subpages must be done manually. It is done by clicking on the appropriate subpage tab either on the main page, or in the ''Unused subpages'' area of the header on the Talk subpage, and saving the subpage, with appropriate contents - not forgetting the <code><nowiki>{{subpages}}</nowiki></code> at the top of the new subpage. CZ will then display the standard Subpages menu on that subpage, and include it in the navigation tabs in the cluster navigation header.
 
For more technical pointers about how the subpage template works, see [[CZ:Using the Subpages template]].
 
== List of subpage types ==
 
For various reasons, we will want to keep a canonical list of subpage types, and ask people to create subpages only of the types listed.
 
We'll also distinguish between ''default'' (required) subpages and ''optional'' subpages. 
Links to the default subpages will appear (on the subpages template) even if they have not yet been created, while links to optional subpages will be created only if they exist.
 
If nevertheless an additional subpage is required then you may consult:
* [[CZ:How to add a new subpage type]]
* [[CZ:Article-specific subpages]]
'''Removal''' of a link from the subpages template:
<br> The link to an optional subpage is inserted whenever the file exists, i.e., it will still be displayed if the page is empty (has been blanked).
In order to remove the link from the list (and again insert it into the list of unused subpages on the talk page template) the page has to be deleted.
Alternatively, in order to save the history, it can be moved to a talk page archive (e.g., of the talk page of this subpage). Then the redirect created by the move has to be deleted.
 
=== Default subpages ===
* '''Talk:''' The first tab to the right of Main Page on every subpages menu bar, Talk is  a page for authors and editors to discuss the contents and composition of the main page and subpages.
* '''[[CZ:Related Articles|Related Articles]]:''' a list of subtopics, parent topics, and other related topics, augmented by [[CZ:definitions|definitions]]
* '''[[CZ:Bibliography|Bibliography]]:''' a substantial list of the most important published books and articles on the topic; with links to online sources for them, if available
* '''[[CZ:External Links|External Links]]:''' a lengthy, categorized, annotated list of Web links about the topic
 
=== Optional subpages ===
 
You can see a complete list of the currently-supported subpages at [[Template:Subpage list]]. (To add a new one, see [[CZ:How to add a new subpage type]].)
<br>
For subpages that are not (yet) fully supported, but are used for some topics see [[CZ:Article-specific subpages]].
 
==== Further bibliographic material ====
* '''[[CZ:Works|Works]]:''' a list of books, articles, artworks, etc., authored by a person
* '''[[CZ:Discography|Discography]]:''' a list of recorded works
* '''[[CZ:Filmography|Filmography]]:''' a list of films, television shows, etc., directed, performed in, etc.
 
==== Summary presentations of information ====
* '''[[CZ:Catalogs|Catalogs]]:''' one or more pages containing almanac-type information about some aspect of the topic, in tabular form; see, e.g., [[catalog of religions]])
* '''[[CZ:Timelines|Timelines]]:''' one or more pages giving a timeline about some aspect of the topic; main content may or may not exist on the "Tutorials" page itself
 
==== Non-text media ====
* '''[[CZ:Gallery|Gallery]]:''' an image gallery
* '''[[CZ:Audio|Audio]]:''' a collection of ''Citizendium''-hosted audio recordings related to the topic
* '''[[CZ:Video|Video]]:''' a collection of ''Citizendium''-hosted videos related to the topic
* '''[[CZ:Code|Code]]:''' a collection of code samples related to the topic
 
==== Presentations of the topic at various levels ====
* '''[[CZ:Tutorials|Tutorials]]:''' one or more pages that introduce a topic specifically for students; would be focused on more "practical" aspects of the topic, have more examples, and even perhaps some problems at the bottom of the page; some topics may lend themselves to more explicit "how to" type instructions (how to change your oil); main content may or may not exist on the "Tutorials" page itself
* '''[[CZ:Student Level|Student Level]]:''' a simplified and entertaining version of the encyclopedia article for younger students
* '''[[CZ:Advanced|Advanced]]:''' a subpage with content that will really only be useful for, or possibly even only intelligible to, specialists in the field
* '''[[CZ:Debate Guide|Debate Guide]]:''' one or more pages giving a "map of the dialectical landscape," an account of the arguments on all sides of a controversial issue about the topic; if important to read "map", give dates arguments introduced, a timeline
 
==== Complementary texts ====
* '''[[CZ:Addendum|Addendum]]:''' supplementary text, specifically serving as a continuation of the main encyclopedia article
* '''[[CZ:Signed Articles|Signed Articles]]:''' one or more possibly "biased" articles written exclusively by real experts, and signed; note that the "Signed" subpage is a ''list'' of articles, which are placed on sub-sub-pages
* '''[[CZ:Function|Function]]:''' Used to describes the known and postulated function of different proteins and genes. It will be used primarily by the Biology workgroup.
* '''[[CZ:Recipes|Recipes]]:''' Each Recipe subpage will have a basic, but comprehensive and representative recipe as a supplement to our culinary articles.
 
=== Planned subpage projects ===
The following projects will not be included in the initial subpage pilot:
<!--
* '''[[CZ:Debate Guide|Debate Guide]]:''' one or more pages giving a "map of the dialectical landscape," an account of the arguments on all sides of a controversial issue about the topic; if important to read "map", give dates arguments introduced, a timeline
-->
* '''[[CZ:News Guide|News Guide]]:''' one or more pages summarizing of ongoing stories about the topic (such that a story itself will probably not become its own encyclopedia article!)
 
== Approval of subpages ==
 
Individual subpages cannot be approved.  Instead, an entire cluster (or infoset) is approved at the same time.
 
Note that once an article is approved, all new edits to subpages will edit the ''approved'' version of the subpages.  Such edits must be aimed, therefore, always at improving the article, and editors should pay special attention to such edits.  We do not want to ''discourage'' editing of subpages of approved articles, but want to apply a higher standard in responding to such edits.
 
==See also==
 
* {{tl|Subpage style}} - Works with {{tl|Subpage list}}
 
{{Content Policy}}

Latest revision as of 12:22, 9 December 2010

[edit intro]

A full Citizendium article includes a main article page and standard and optional subpages; the entire group is called a cluster.

Some subpages contain additional content on the subject of the article. Others are used for a variety of functions, such as discussing the article content, recording information about approved versions of articles (stable versions which have been checked and approved by an Editor), etc.

The subpage mechanism provides a header on every page or subpage of a cluster which allows easy navigation among the pages of the cluster. In addition, the header on the Talk subpage provides access to additional subpage-related functions.

You might look at the Biology article and its subpages--our "biology cluster"--as an example. The Civil society article also includes many subpages, including Timelines in recently (2008) revised format.

Some of the standard subpages, such as the Talk page, and the Approval subpage, are attached to a main (encyclopedia) page semi-automatically when the main article page is set up to use the article checklist. Other standard and optional subpages can be added by authors or editors.

Basic guidelines

Setting up subpages

To enable the full subpage functionality:

  • Include the string {{subpages}} (which is a MediaWiki template which invokes the Citizendium subpage functions) at the top of the main article page - and later, all of its subpages, and:
  • Create a Metadata page for the cluster; the Citizendium subpage system will automatically prompt to do this after the first page or subpage with {{subpages}} on it has been saved. You will need to fill in some basic information in the Metadata, such as the article name. Note: the Citizendium subpage mechanisms will not work properly unless the article name is entered correctly.

This is enough to turn on the subpage functionality; the system will also prompt to create the Talk and Approval subpages, if they do not exist, and will provide default contents for them which only have to be saved (although they can be modified first, if desired).

Don't forget that it is desirable to install the {{subpages}} statement on all individual subpages. Basic information about subpages is now included in the text in the subpage header on the Talk subpage.

See the instructions for more details on how to set up an article page to use subpages.

Default content subpages

In addition to the Metadata, Talk, and Approval subpages, there are three "default" subpages for every article:

When articles are approved, another basic type is added, to allow Citizendium authors and editors to work on a future revision of the article, alongside the stable, approved, version:

  • Draft

Activation of individual article subpages must be done manually. It is done by clicking on the appropriate subpage tab either on the main page, or in the Unused subpages area of the header on the Talk subpage, and saving the subpage, with appropriate contents - not forgetting the {{subpages}} at the top of the new subpage. CZ will then display the standard Subpages menu on that subpage, and include it in the navigation tabs in the cluster navigation header.

For more technical pointers about how the subpage template works, see CZ:Using the Subpages template.

List of subpage types

For various reasons, we will want to keep a canonical list of subpage types, and ask people to create subpages only of the types listed.

We'll also distinguish between default (required) subpages and optional subpages. Links to the default subpages will appear (on the subpages template) even if they have not yet been created, while links to optional subpages will be created only if they exist.

If nevertheless an additional subpage is required then you may consult:

Removal of a link from the subpages template:
The link to an optional subpage is inserted whenever the file exists, i.e., it will still be displayed if the page is empty (has been blanked). In order to remove the link from the list (and again insert it into the list of unused subpages on the talk page template) the page has to be deleted. Alternatively, in order to save the history, it can be moved to a talk page archive (e.g., of the talk page of this subpage). Then the redirect created by the move has to be deleted.

Default subpages

  • Talk: The first tab to the right of Main Page on every subpages menu bar, Talk is a page for authors and editors to discuss the contents and composition of the main page and subpages.
  • Related Articles: a list of subtopics, parent topics, and other related topics, augmented by definitions
  • Bibliography: a substantial list of the most important published books and articles on the topic; with links to online sources for them, if available
  • External Links: a lengthy, categorized, annotated list of Web links about the topic

Optional subpages

You can see a complete list of the currently-supported subpages at Template:Subpage list. (To add a new one, see CZ:How to add a new subpage type.)
For subpages that are not (yet) fully supported, but are used for some topics see CZ:Article-specific subpages.

Further bibliographic material

  • Works: a list of books, articles, artworks, etc., authored by a person
  • Discography: a list of recorded works
  • Filmography: a list of films, television shows, etc., directed, performed in, etc.

Summary presentations of information

  • Catalogs: one or more pages containing almanac-type information about some aspect of the topic, in tabular form; see, e.g., catalog of religions)
  • Timelines: one or more pages giving a timeline about some aspect of the topic; main content may or may not exist on the "Tutorials" page itself

Non-text media

  • Gallery: an image gallery
  • Audio: a collection of Citizendium-hosted audio recordings related to the topic
  • Video: a collection of Citizendium-hosted videos related to the topic
  • Code: a collection of code samples related to the topic

Presentations of the topic at various levels

  • Tutorials: one or more pages that introduce a topic specifically for students; would be focused on more "practical" aspects of the topic, have more examples, and even perhaps some problems at the bottom of the page; some topics may lend themselves to more explicit "how to" type instructions (how to change your oil); main content may or may not exist on the "Tutorials" page itself
  • Student Level: a simplified and entertaining version of the encyclopedia article for younger students
  • Advanced: a subpage with content that will really only be useful for, or possibly even only intelligible to, specialists in the field
  • Debate Guide: one or more pages giving a "map of the dialectical landscape," an account of the arguments on all sides of a controversial issue about the topic; if important to read "map", give dates arguments introduced, a timeline

Complementary texts

  • Addendum: supplementary text, specifically serving as a continuation of the main encyclopedia article
  • Signed Articles: one or more possibly "biased" articles written exclusively by real experts, and signed; note that the "Signed" subpage is a list of articles, which are placed on sub-sub-pages
  • Function: Used to describes the known and postulated function of different proteins and genes. It will be used primarily by the Biology workgroup.
  • Recipes: Each Recipe subpage will have a basic, but comprehensive and representative recipe as a supplement to our culinary articles.

Planned subpage projects

The following projects will not be included in the initial subpage pilot:

  • News Guide: one or more pages summarizing of ongoing stories about the topic (such that a story itself will probably not become its own encyclopedia article!)

Approval of subpages

Individual subpages cannot be approved. Instead, an entire cluster (or infoset) is approved at the same time.

Note that once an article is approved, all new edits to subpages will edit the approved version of the subpages. Such edits must be aimed, therefore, always at improving the article, and editors should pay special attention to such edits. We do not want to discourage editing of subpages of approved articles, but want to apply a higher standard in responding to such edits.

See also


Citizendium Content Policy
Approval Standards | Article Mechanics | Subpages | Importing material from other sources | Citable articles

|width=10% align=center style="background:#F5F5F5"|  |}