CZ:Article structure: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>J. Noel Chiappa
imported>Gareth Leng
No edit summary
(14 intermediate revisions by 4 users not shown)
Line 1: Line 1:
An '''article''' (or '''cluster''', to give it its technical name) on [[Citizendium]]) consists of a set of [[MediaWiki pages]]. Almost all of these pages are in the main 'article' [[MediaWiki namespace|namespace]].
{{editintro}}


There is one main page, where the main text of article is to be found, and a number of ''subpages'' which are associated with the article, and logically are parts of it. These subpages contain ancillary material which we don't wish to clutter up the main article page with, such as lengthy bibliographies, advanced material which will only be of use to specialists, etc. A header on ever page which is part of a cluster allows easy navigation among all the (sub)pages which are part of the cluster.
An '''article''' (or '''cluster''', to give it its technical name on [[Citizendium]]) consists of a set of [[MediaWiki pages]]. Almost all of these pages are in the main 'article' [[MediaWiki namespace|namespace]].
 
There is one main page, where the main text of article is to be found, and a number of [[MediaWiki subpages]] which are parts of it. These subpages contain material such as bibliographies, advanced material of use to specialists, etc. A header on every page which is part of a article allows easy navigation among all the (sub)pages.


==Subpages==
==Subpages==
In Citizendium, to make our subpage mechanisms work, we have to make such page names into {{MW|Help:Redirect|redirects}}; for example, [[GNU/Linux]]. (See [[CZ:Articles with a slash character in their names]] for more on this topic.)


A subpage is basically just a ordinary [[MediaWiki]] page with a "/" in its title. Subpages, which have names of the form "Foo/Bar", are all associated with a particular top-level page, which is the one with the name consisting of the part of the subpage's name before the "/" (in this example, "Foo"). (And of course the process is [[recursion|recursive]], so that "Foo/Bar/Zap" is a subpage of "Foo/Bar".)
For more about subpages, including a list of the standard subpages, see [[CZ:Subpages]].
 
Other than being related to a particular top-level page, there is almost no real difference in how they are actually handled by MediaWiki. (See [http://meta.wikimedia.org/wiki/Link#Subpage_feature this page] for more details. In fact, depending on how MediaWiki is configured, and which namespace they are in, the MediaWiki software may not even recognize subpages at all in that namespace.)
 
On [[Wikipedia]], sub-pages are turned off in their main 'article' namespace. As we developed the subpage structure of Citizendium, it became clear that for technical reasons which need not concern us here, it would not work without subpages being enabled in the main namespace.
 
One advantage Wikipedia gains by having subpages turned off in the main article namespace is that it makes it easier to use a backslash in an article name, where that would be natural (such as [[Apollo Command/Service Module]]). In Citizendium, to make our current subpage mechanisms work, we have to make such page names into {{MW|Help:Redirect|redirects}}; for example, [[GNU/Linux]].
 
For more about subpages, including a list of the currently defined standard subpages, see [[CZ:Subpages]].


<!-- This section name is the target of the redirect [[CZ:Metadata]]; if you change it, please update the redirect. -->
==Metadata==
==Metadata==
<small>See also [[CZ:Using the Subpages template]]</small>


There is one subpage which is not like the others; it's called the ''metadata'', and it contains material which is not displayed to users, but rather used internally to Citizendium, to contain information about the article (hence its name).
One subpage is not like the others; the ''metadata'' contains material which contains information about the article like its quality etc. Information which it contains is used to add the article to categories.


===Metadata contents===
===Metadata contents===
Here is a list of the fields in the metadata:
Here is a list of the fields in the metadata:


{{Checklist blank}}
{{Metadata_doc}}


A detailed explanation for each of the field is available [[CZ:The Article Checklist#The template fields explained|here]].
A detailed explanation for each of the field is available [[CZ:The Article Checklist#The template fields explained|here]].


===Metadata implementation===
===Metadata implementation===
 
The metdata is a [[MediaWiki template]] (i.e. a piece of [[MediaWiki markup]] which is ''transcluded'' (i.e. copied over) into every page which uses the template). Any page which needs access to any information in the metadata transcludes the template which holds the metadata. The metadata is kept in the Template: namespace (for article "Foo", the metadata is at "Template:Foo/Metadata").
The current instantiation (briefly) is that the metdata is a [[MediaWiki template|template]] (i.e. a piece of [[MediaWiki markup]] which is ''transcluded'' (
i.e. copied over) into every page which uses the template). Any page that needs access to any information which is kept in the metadata simply transcludes the template which holds the metadata. The metadata is kept (because it's a template) in the Template: namespace (which is where all templates normally live); specifically, for article "Foo", the metadata is at "Template:Foo/Metadata".


==Subpages implementation==
==Subpages implementation==
 
Every (sub)page has at the top a call to the {{tl|subpages}} template. That generates the navigation header at the top of the page, etc.
Every (sub)page which is part of an article contains at the top a call to the {{tl|subpages}} template. That template generates the navigation header at the top of the page, etc.
See [[CZ:Using the Subpages template]] for more information.
See [[CZ:Using the Subpages template]] for more information.


Line 40: Line 33:


* [[CZ:Namespaces]] - A list of all CZ's namespaces
* [[CZ:Namespaces]] - A list of all CZ's namespaces
* [[:Template:Blank metadata]] - A blank metadata page
* [[Template:Subpage list]] - A list of the current defined subpage types
* [[Template:Blank metadata]] - A blank metadata page
 
{{Technical Help}}

Revision as of 04:48, 24 December 2010

[edit intro]

An article (or cluster, to give it its technical name on Citizendium) consists of a set of MediaWiki pages. Almost all of these pages are in the main 'article' namespace.

There is one main page, where the main text of article is to be found, and a number of MediaWiki subpages which are parts of it. These subpages contain material such as bibliographies, advanced material of use to specialists, etc. A header on every page which is part of a article allows easy navigation among all the (sub)pages.

Subpages

In Citizendium, to make our subpage mechanisms work, we have to make such page names into redirects; for example, GNU/Linux. (See CZ:Articles with a slash character in their names for more on this topic.)

For more about subpages, including a list of the standard subpages, see CZ:Subpages.

Metadata

See also CZ:Using the Subpages template

One subpage is not like the others; the metadata contains material which contains information about the article like its quality etc. Information which it contains is used to add the article to categories.

Metadata contents

Here is a list of the fields in the metadata:

{{#switch: {{{info}}}

<!--general article properties-->
|       pagename = 
|        variant = 

<!--Required for checklist-->

|            abc =  
|      cat_check = 
|         status = currently no status
|    underlinked = 
|        cleanup = 
|             by = 
|           cat1 = 
|           cat2 = 
|           cat3 = 
|           sub1 = 
|           sub2 = 
|           sub3 = 
|           tab1 = 
|           tab2 = 
|           tab3 = 

<!--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>

In brief:

  • pagename: must contain the correct name of the article.
  • variant: records the dialect of English which the article is written in.


  • abc: means the form of the title for alphabetization, e.g. "Doherty, John" or "Orient, The". Please think this one through.
  • 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: obsolete; leave blank.
  • cat1, cat2 and cat3: workgroups; fill in numerical order.
  • sub1, sub2 and sub3: sub-workgroups; fill in numerical order.
  • tab1, tab2 and tab3: per-article subpages; fill in numerical order.


  • article url: a URL link to the version to approve.
  • subpage url: a URL link to the version of a subpage to approve.
  • cluster: blank unless the whole cluster needs to be approved.
  • now: the date and time when the nomination was made.
  • ToA editor, ToA editor2, ToA editor3: name of the editor(s) who nominated the article for approval; fill in numerical order.
  • date: deadline for comments (format yyyymmdd).


  • A editor, A editor2, A editor3: copied from ToA editor etc when Approval is completed.

A detailed explanation for each of the field is available here.

Metadata implementation

The metdata is a MediaWiki template (i.e. a piece of MediaWiki markup which is transcluded (i.e. copied over) into every page which uses the template). Any page which needs access to any information in the metadata transcludes the template which holds the metadata. The metadata is kept in the Template: namespace (for article "Foo", the metadata is at "Template:Foo/Metadata").

Subpages implementation

Every (sub)page has at the top a call to the {{subpages}} template. That generates the navigation header at the top of the page, etc. See CZ:Using the Subpages template for more information.

See also


Citizendium Technical Help
How to edit an article | Searching | Start article with subpages
The Article Checklist | Subpage template
See also: Getting Started
How to Edit
Getting Started Organization Technical Help
Policies Content Policy
Welcome Page