Help:Namespace - Revision history

Mcefan at 15:45, 8 October 2012

2012-10-08T15:45:47Z

←Older revision		Revision as of 15:45, 8 October 2012
Line 1:		Line 1:
	[[Category:Wiki ~~Administration~~]]		[[Category:Wiki administration]]
	{{nav}}		{{nav}}
	==Introduction to namespaces==		==Introduction to namespaces==

Mcefan at 15:44, 8 October 2012

2012-10-08T15:44:59Z

←Older revision		Revision as of 15:44, 8 October 2012
Line 1:		Line 1:
	[[Category:Wiki ~~Architecture~~]] {{nav}}		[[Category:Wiki Administration]]
			{{nav}}
	==Introduction to namespaces==		==Introduction to namespaces==
	===Namespaces: the containers===		===Namespaces: the containers===

Mcefan: /* When is a new namespace needed? */

2012-09-30T14:34:42Z

When is a new namespace needed?

←Older revision		Revision as of 14:34, 30 September 2012
Line 15:		Line 15:

	Use namespaces to separate articles just as you would use folders to keep documents.		Use namespaces to separate articles just as you would use folders to keep documents.

	~~{{p}}~~

	~~=== When is a new namespace needed? ===~~
	Mainly when a content type is to be reserved for a defined group of users. If you are a user, all you need to know is that all articles are in the "Main" namespace by default. You do not need a new namespace. Continue reading from [[#Where to place the article?]] below.

	{{p}}		{{p}}

Mcefan: /* Namespaces: the containers */

2012-09-30T14:33:42Z

Namespaces: the containers

←Older revision		Revision as of 14:33, 30 September 2012
Line 4:		Line 4:
	Articles in the Wiki are placed in locations called "namespaces". Namespaces are the Wiki architecture components that hold all articles. The final location of an article is the one that has been specified through its title prefix following the construct '''Namespace:Title'''. <br>		Articles in the Wiki are placed in locations called "namespaces". Namespaces are the Wiki architecture components that hold all articles. The final location of an article is the one that has been specified through its title prefix following the construct '''Namespace:Title'''. <br>
	If an article is titled without the use of the optional location prefix (:Title), it is placed in the ''main namespace'', which is the default location. This is so because '''the main namespace is the null character'''.		If an article is titled without the use of the optional location prefix (:Title), it is placed in the ''main namespace'', which is the default location. This is so because '''the main namespace is the null character'''.

			{{p}}

	===Why namespaces?===		===Why namespaces?===

Mcefan: /* Why namespaces? */

2012-09-30T14:33:03Z

Why namespaces?

←Older revision		Revision as of 14:33, 30 September 2012
Line 8:		Line 8:
	Namespaces are administrative boundaries used to separate content from policy and discussion. <br>		Namespaces are administrative boundaries used to separate content from policy and discussion. <br>
	They isolate pages based on their intended use:		They isolate pages based on their intended use:
			* subject specific
	* public viewing		* public viewing
	* private information intended for the editing community.		* private information intended for the editing community.

			Use namespaces to separate articles just as you would use folders to keep documents.

	{{p}}		{{p}}

Mcefan: /* Namespace administration */

2012-09-30T14:31:44Z

Namespace administration

←Older revision		Revision as of 14:31, 30 September 2012
Line 133:		Line 133:

	== Namespace administration ==		== Namespace administration ==
			'''The remainder of this page contains administrative notes'''.

	===How to create a new namespace===		===How to create a new namespace===
	This is an administrative function used to add custom namespaces to the wiki to further separate content and allow more logical organization.		This is an administrative function used to add custom namespaces to the wiki to further separate content and allow more logical organization.
	~~Use namespaces to separate articles just as you would use folders to keep documents.~~

	~~A custom namespace can be used to hold content that should not be shown on the search results page, for example pages that are used only for transclusion.<br>~~

	~~The remainder of this section~~ are ~~administrative notes~~.		;Note: A custom namespace can be used to hold content that should not be shown on the search results page, for example pages that are used only for transclusion.<br>

	====Edit the configuration file====		====Edit the configuration file====

Mcefan: /* Namespace administration */

2012-09-30T14:29:06Z

Namespace administration

←Older revision		Revision as of 14:29, 30 September 2012
Line 132:		Line 132:
	{{p}}		{{p}}

	~~==Namespace administration==~~
	== Namespace administration ==		== Namespace administration ==
	===How to create a new namespace===		===How to create a new namespace===

Mcefan: /* Working with namespaces */

2012-09-30T14:27:28Z

Working with namespaces

@@ Line 18: / Line 18: @@
 ==Working with namespaces==
 ===How to view the contents of a namespace===
 The special page "[[Special:Allpages]]" contains all the articles created in the wiki by its editors. It lists the contents of the "Main" namespace. <br>
@@ Line 56: / Line 131: @@
 {{p}}
 ==Namespace administration==

Mcefan: /* Built-in namespaces */

2012-09-30T14:26:42Z

Built-in namespaces

@@ Line 59: / Line 59: @@
 ==Namespace administration==
 == Namespace administration ==
 ===How to create a new namespace===

Mcefan: /* Namespace administration */

2012-09-30T14:24:46Z

Namespace administration

←Older revision		Revision as of 14:24, 30 September 2012
Line 60:		Line 60:
	==Namespace administration==		==Namespace administration==
	===Built-in namespaces===		===Built-in namespaces===
	~~MediaWiki~~ ships with 18 built-in namespaces.		The Wiki ships with 18 built-in namespaces.

	~~The following 8 namespaces all have associated discussion namespaces.~~

	{\| class="datatable" border="1"		{\| class="datatable" border="1"
Line 101:		Line 100:

	2 other namespaces have negative indexes and have special purposes. You cannot create or delete pages in these namespaces, and there are no corresponding discussion namespaces.		2 other namespaces have negative indexes and have special purposes. You cannot create or delete pages in these namespaces, and there are no corresponding discussion namespaces.
			Index Name Purpose
			-1 Special Holds special pages
			-2 Media Alias for direct links to media files

	{\| class="datatable"		{\| class="datatable"
Line 109:		Line 111:
	\| -2 \|\| Media \|\| Alias for direct links to media files		\| -2 \|\| Media \|\| Alias for direct links to media files
	\|}		\|}

	~~=== Built-in namespaces===~~

	~~Every MediaWiki installation comes with 18 predefined namespaces. Here are a few facts about some of them:~~


Line 126:		Line 124:
	12 Help Help pages		12 Help Help pages
	14 Category Category description pages		14 Category Category description pages

	~~2 other namespaces have negative indexes and have special purposes. You cannot create or delete pages in these namespaces, and there are no corresponding discussion namespaces.~~
	~~Index Name Purpose~~
	~~-1 Special Holds special pages~~
	~~-2 Media Alias for direct links to media files~~


Line 139:		Line 132:
	* 2 pseudo-namespaces		* 2 pseudo-namespaces

			{{p}}

			== Namespace administration ==
	===How to create a new namespace===		===How to create a new namespace===
			This is an administrative function used to add custom namespaces to the wiki to further separate content and allow more logical organization.
			Use namespaces to separate articles just as you would use folders to keep documents.

			A custom namespace can be used to hold content that should not be shown on the search results page, for example pages that are used only for transclusion.<br>

	~~You can create and add custom namespaces to your wiki to further separate content and allow more logical organization.~~		The remainder of this section are administrative notes.
	Create namespaces to separate your articles just as you would create folders to keep documents.<br> A custom namespace can be used to hold content that should not be shown on the search results page, for example pages that are ~~used only for transclusion~~.~~<br>~~

	====Edit the configuration file====		====Edit the configuration file====

	#Open the <tt>'''/var/www/html/mediawiki/LocalSettings.php'''</tt> file		#Open the <tt>'''/var/www/html/mediawiki/LocalSettings.php'''</tt> file
	#Add a line to create the new namespace:		#Add a line to create the new namespace:
Line 169:		Line 167:
	$wgGroupPermissions['sysop']['editfoo'] = true; #permission "editfoo" granted to <br> users in the "sysop" group <br>		$wgGroupPermissions['sysop']['editfoo'] = true; #permission "editfoo" granted to <br> users in the "sysop" group <br>

	~~{{ref}}~~

	====Specify that it is a content namespace====		====Specify that it is a content namespace====
Line 182:		Line 179:
	* Namespace prefixes should not be confused with prefixes for interwiki linking.		* Namespace prefixes should not be confused with prefixes for interwiki linking.
	* If a page title contains a colon, but the initial part of the title is not one of the pre-defined namespaces, that page is considered to be in the main namespace.		* If a page title contains a colon, but the initial part of the title is not one of the pre-defined namespaces, that page is considered to be in the main namespace.

	{{p}}		{{p}}

	===~~How to resolve~~ namespace conflicts===		===Resolving namespace conflicts===
	When a page is created in a namespace that doesn't exist, e.g. "Bar:Some page", it is treated as being in the main namespace. This will conflict in the future with a new namespace of the same name. The articles will have to be moved.<br>		When a page is created in a namespace that doesn't exist, e.g. "Bar:Some page", it is treated as being in the main namespace. This will conflict in the future with a new namespace of the same name. The articles will have to be moved.<br>
	Within the '''maintenance''' directory, there is a maintenance script which performs the above operation more effectively for a large number of pages; <tt>'''namespaceDupes.php'''</tt>. Alternatively, the following query can be used:		Within the '''maintenance''' directory, there is a maintenance script which performs the above operation more effectively for a large number of pages; <tt>'''namespaceDupes.php'''</tt>. Alternatively, the following query can be used: