Difference between revisions of "Manual:Namespace"
[unchecked revision] | [unchecked revision] |
Fbaeckmann (talk | contribs) m (Text replacement - "[[Reference:NamespaceCss" to "[[Reference:BlueSpiceNamespaceCss") |
(Tag: Visual edit) |
Contents
What are namespaces?[edit | edit source]
Namespaces are used to divide a wiki into different areas. This can be used to stop some areas appearing in search results, to assign permissions differently in different areas and to give these areas different designs. Assigning permissions can be very important to give different groups in a wiki different areas to work in. Nevertheless
Namespaces structure and organize a wiki for these purposes:
- Rights management: To assign content to different rights and roles. For example, a company's HR department can use its own namespace to grant only Human Resources personnel access to the pages in that namespace a major reason for creating namespaces. However, flat hierarchies are recommended for wikis.
- Search function: To exclude pages and files in the wiki from the search.
- Design: To format pages in different wiki areas differently.
We often take the example of cupboards to make clear the principle of namespaces. There are shelves which where everyone can look at and change the contentsinside and work on something. There are locked glass-fronted cabinets which everyone glass cupboards with a lock that you can look into but only those with a key can change the contents. Finally, there are locked wooden cabinets and , but not everyone can handle everything. There are closed wooden cabinets with lock, then only selected people can look at them or change the contents. Every cupboard, of course, inside and work on it. And every cupboard can look different.
BlueSpice Standard Namespaces in MediaWiki[edit | edit source]
The standard installation of MediaWiki has 15 namespaces, the standard (main) namespace, and 2 pseudo namespaces, which are listed below in the table. Every page will be assigned to the main namespace, unless it is specifically assigned somewhere else.
Although the pseudo namespace are used like normal namespaces, no pages can be created and no existing pages can be changed.
Most of the pages in the namespaces are automatically generated: special Among other things, BlueSpice uses the 15 standard and two so-called pseudo namespaces from MediaWiki:
ID | Namespace | 'Function' |
---|---|---|
Media | Pseudo-namespace for uploaded images and files. Will be replaced by path of the files. | |
special | Pseudo-namespace for special pages. | |
0 | (pages) | These are given without a prefix. |
1 | discussion | talk page. Is created in addition to each article (also in the following namespaces) to speak about its contents. Additional tab (+). |
2 | user | User page. Will be created for every logged in user. |
3 | Benutzer_Diskussion | See Discussion. |
4 | [Wiki Name] | Information about the wiki or the current project. Here: BlueSpice. |
5 | _discussion | See Discussion. |
6 | file | Description of a picture and other files. Is automatically supplemented with version information and information about the occurrence of the file |
7 | Datei_Discussion | See Discussion. |
8 | MediaWiki | system messages. A complete list can be found under Special: AllMessages. Can only be changed by registered users. |
9 | MediaWiki_Discussion | See Discussion. |
10 | template | Templates can be integrated into other pages. |
11 | Vorlage_Diskussion | See Discussion. |
12 | Help | Help pages describe how to perform actions in the wiki. No clear separation from the [wiki name] namespace. |
13 | Hilfe_Discussion | See Discussion. |
14 | category | Pages can be assigned to categories, which are then accessible in this namespace. |
15 | Kategorie_Discussion | See Discussion. |
Standard namespace: A page is assigned to the (pages) namespace, as long as no other information is given.
Pseudo namespaces: The two pseudo namespaces (medium, special) are used like normal namespaces, but neither pages can be created nor existing pages changed.
Most pages in the namespaces are created automatically:
- Special pages are generated by the system during installation
- Media and image pages
- are created by uploading a file
- User pages are created
- whenever a user acts
- on the wiki
- Discussion pages are
- also created with the respective pages
- This leaves only
- the pages in the main namespace (pages), [
- wiki name],
- template, help and category
- that can be freely
-
created. The pages for the respective categories can be requested via the special page "All pages".
Note: In the standard MediaWiki distribution, the names of these areas are hard coded. This means that they are set in the source code of MediaWiki and cannot be changed by users.
{{{Note text}}}
Calling pages in the namespace[edit | edit source]
In order to To address or create a page in a particular specific namespace or, if it does not exits, to create it, simply place the namespace's name before the page name, separating them with , its name is simply placed in front of the page title and separated by a colon:
[[Category:BlueSpice_free|All the Extensions of BlueSpice free]]
Setup:Installation
In the example, the pipe symbol (the vertical straight line) is added to the end as well. This will then not show the namespace was also added. It has the effect that the name space can not be displayed when the link is displayed . Instead a or another text can be entered following the pipe symbol to be displayed which might be easier to read, which facilitates readability.
If you enter specify a namespace which that is not part of known to the wiki, then the page will be is created in the main standard namespace Main. The part portion of the link given reference specified as the namespace will be is then added to the title of the article rather than item and is not recognized as a label for an area label.
One namespace per page: A page can only be put in assigned to a single namespace. The same page name in a different areas creates different pagesnamespace creates a new page.
Flat structure: Namespaces are all only available on the same level, this means that an area cannot be further divided up into namespaces. Therefore the discussion pages for a namespace belong to another new namespace instead of being part of an overall discussion area.
The search function lets you restrict your search to individual namespaces.
one level. H. a namespace can not have child namespaces.
Search for contents in namespaces: In the search, the scope to be included can be limited to individual namespaces.
Create own namespaces[edit | edit source]
Creating Even creating your own namespaces is also only possible in MediaWiki without BlueSpice only with access to the scripts.
In BlueSpice you can create additional namespaces using namespace management.
Organize content without namespaces[edit | edit source]
However, one can use the namespace syntax and so simulate namespaces within the main namespace by giving the pages that should belong to a specific area the prefix with a colon attached to the name. The general advantages syntax of the namespaces to help simulate an area in the namespace Main by prefixing the pages of a desired area with a colon. The general benefits of using namespaces are preserved. In this way,
So it is possible to use pages that have with the same name in different "spacesrooms" and so get thus let different groups working in one work on a wiki. As Since these own "namespace" prefixes you create are actually a part of the page name, one you can search in now display all pages within this in a "namespace" by simply searching for the prefix in the search field.
Show all pages withinSince you can organize pages across categories and subpages, you should start by understanding how to manage the content in your wiki.
You can visualize this for example with the BlueSpice draw.io Plugin directly in BlueSpice and discuss it with your team.
All pages of a namespace[edit | edit source]
It is possible to showing all the pages within a namespace:
- Call up the Special page "All pages"
- Leave the text boxes empty
- Choose a namespace and click on "Go"
Table of namespaces[edit | edit source]
Namespace | Function |
---|---|
Media | Pseudo namespace for uploaded images and files. It is replaced by the path of the file. |
Special | Pseudo namespace for special pages. |
(Main) Normal pages | These are given without prefix. |
Talk | Talk pages. These are created alongside articles (including in the namespaces that follow) to give a space for the contents to be discussed. Additional tab (+). |
User | User pages. These are created for each logged on user. |
User talk | Cf. talk. |
[Wiki-Name] | Data concerning the wiki or the project involved. Here: BlueSpice. |
[Wiki-Name]_Talk | Cf. talk. |
Image | Description of an image or other file. Information about the version and the uses of the file is automatically included. |
File_talk | Cf. talk. |
MediaWiki | System notifications. A complete list is available at Special:AllMessages. This can only be edited by users who are logged on. |
MediaWiki_Talk | Cf. talk. |
Template | Templates can be included in other pages. |
Template_talk | Cf. talk. |
Help | Help pages are there to describe how to get things done in the wiki. There is no clear division of contents between this and the [Wiki-Name] namespace. |
Help_talk | Cf. talk. |
Category | Pages can be assigned categories which are then accessible in this namespace. |
Category_talk | Cf. talk. |
The display of all pages of a namespace is possible:
- Special Page "All Pages"
- Leave input field empty
-
Select namespace and click "Apply"
__NOTOC__ '''Namespaces''' ==What are namespaces?== '''Namespaces''' are used to divide a wiki into different areas. This can be used to stop some areas appearing in search results, to assign permissions differently in different areas and to give these areas different designs. Assigning permissions can be very important to give different groups in a wiki different areas to work in. Nevertheless Namespaces structure and organize a wiki for these purposes: *'''Rights management:''' To assign content to different rights and roles. For example, a company's HR department can use its own namespace to grant only Human Resources personnel access to the pages in that namespace a major reason for creating namespaces. However, flat hierarchies are recommended for wikis. Compare namespaces to cupboards helps to make the principle clear. There are shelves which everyone can look at and change the contents. There are locked glass-fronted cabinets which everyone can look into but only those with a key can change the contents. Finally, there are locked wooden cabinets and *'''Search function:''' To exclude pages and files in the wiki from the search. *'''Design:''' To format pages in different wiki areas differently. We often take the example of cupboards to make clear the principle of namespaces. There are shelves where everyone can look inside and work on something. There are glass cupboards with a lock that you can look into, but not everyone can handle everything. There are closed wooden cabinets with lock, then only selected people can look at them or change the contents. Every cupboard, of course, can look different. ==Namespaces in MediaWiki== The '''standard installation''' of MediaWiki has 15 namespaces, the standard (main) namespace, and 2 pseudo namespaces, which are listed below in the table. Every page will be assigned to the main namespace, unless it is specifically assigned somewhere else. Although the '''pseudo namespace''' inside and work on it. And every cupboard can look different. ==BlueSpice Standard Namespaces== Among other things, BlueSpice uses the 15 standard and two so-called pseudo namespaces from MediaWiki: <br /> {| class="wikitable tablefullwidth" |- !ID !|'''Namespace''' ! |'' 'Function' '' |- | ||Media ||Pseudo-namespace for uploaded images and files. Will be replaced by path of the files. |- | ||special ||Pseudo-namespace for special pages. |- |0 ||(pages) ||These are given without a prefix. |- |1 ||discussion ||talk page. Is created in addition to each article (also in the following namespaces) to speak about its contents. Additional tab (+). |- |2 ||user ||User page. Will be created for every logged in user. |- |3 ||Benutzer_Diskussion ||See Discussion. |- |4 ||[Wiki Name] ||Information about the wiki or the current project. Here: BlueSpice. |- |5 ||_discussion ||See Discussion. |- |6 ||file ||Description of a picture and other files. Is automatically supplemented with version information and information about the occurrence of the file |- |7 ||Datei_Discussion ||See Discussion. |- |8 ||MediaWiki ||system messages. A complete list can be found under Special: AllMessages. Can only be changed by registered users. |- |9 ||MediaWiki_Discussion ||See Discussion. |- |10 ||template ||Templates can be integrated into other pages. |- |11 ||Vorlage_Diskussion ||See Discussion. |- |12 ||Help ||Help pages describe how to perform actions in the wiki. No clear separation from the [wiki name] namespace. |- |13 ||Hilfe_Discussion ||See Discussion. |- |14 ||category ||Pages can be assigned to categories, which are then accessible in this namespace. |- |15 ||Kategorie_Discussion ||See Discussion. |} '''Standard namespace:''' A page is assigned to the (pages) namespace, as long as no other information is given. '''Pseudo namespaces:''' The two pseudo namespaces (medium, special) are used like normal namespaces, no but neither pages can be created and no nor existing pages can be changed. Most of the pages in the namespaces are created automatically generated: special : *Special pages are generated by the system during installation; media *Media and image pages when data is uploaded. are created by uploading a file *User pages are created whenwhenever a user acts inon the wiki. *Discussion pages are generated alongside the article they belong to. This leaves only those pages in main, [Wiki-Name], templates, help and category to be freely drawn up. All the pages belonging to an individual category can be called up using also created with the respective pages *This leaves only the pages in the main namespace (pages), [wiki name], template, help and category that can be freely created. The pages for the respective categories can be requested via the special page "All pages". <br /> {{Box_Note|Note text = Text =In the standarddefault MediaWiki distribution, the names of these areas are "hard -coded". This means that they are have been set in the source code of the MediaWiki and cannot can not be changed by the users.}} ==CallCalling pages in namespaces== In order to addressthe namespace== To address or create a page in a particularspecific namespace or, if it does not exits, to create it, simply place the namespace's name before the page name, separating them with a colon: <code><nowiki>[[Category:BlueSpice_free|All the Extensions of BlueSpice free]]</nowiki></code> , its name is simply placed in front of the page title and separated by a colon: <code>Setup:Installation</code> In the example, the pipe symbol (the vertical straight line) is was also added to the end as well. This will then not show the namespace . It has the effect that the name space can not be displayed when the link is displayed. Instead a or another text can be entered following the pipe symbol to be displayed which might be easier to read. If you enter a namespace which is not part of the wiki, then the page will be created in the main namespace. The part of the link given as the namespace will be, which facilitates readability. If you specify a namespace that is not known to the wiki, the page is created in the standard namespace Main. The portion of the reference specified as the namespace is then added to the title of the article rather than recognized as a label for an area. <br/>item and is not recognized as an area label. <br /> '''One namespace per page:''' A page can only be put inassigned to a single namespace. The same page name in a different areasnamespace creates different pages. Namespaces are all on the same level, this means that an area cannot be further divided up into namespaces. Therefore the discussion pages for a namespace belong to another new namespace instead of being part of an overall discussion area. <br/>The search function lets you restrict your search to individual namespaces. ==Your own namespaces== Creating a new page. '''Flat structure:''' Namespaces are only available on one level. H. a namespace can not have child namespaces. '''Search for contents in namespaces:''' In the search, the scope to be included can be limited to individual namespaces. ==Create own namespaces== Even creating your own namespaces is also only possible in MediaWiki without BlueSpice only with access to the scripts. In BlueSpice you can create additional namespaces using namespace management. ==Organize content without namespaces== However, one can use the namespace syntax and so '''simulate namespaces within the main namespace''' by giving the pages that should belong to a specific area the prefix with a colon attached to the name. The general advantagesof the namespaces to help '''simulate an area in the namespace Main''' by prefixing the pages of a desired area with a colon. The general benefits of using namespaces are preserved. In this way, So it is possible to use pages that have with the same name in different "spaces"rooms" and so getthus let different groups working in onework on a wiki. AsSince these own "namespace" prefixes you create are actually a part of the page name, oneyou can search innow display all pages within thisin a "namespace" by simply searching for the prefix. ==Show all pages within a namespace== It is possible to showing all the pages within a namespace: * Call up the [[Special:AllPages|Special page "All pages"]] * Leave the text boxes empty * Choose a namespace and click on "Go" ==Table of namespaces== {| class="contenttable" style="width: 600px;" |- !|'''Namespace''' !|'''Function''' |- ||Media ||Pseudo namespace for uploaded images and files. It is replaced by the path of the file. |- ||Special ||Pseudo namespace for special pages. |- ||(Main) Normal pages ||These are given without prefix. |- ||Talk ||Talk pages. These are created alongside articles (including in the namespaces that follow) to give a space for the contents to be discussed. Additional tab (+). |- ||User ||User pages. These are created for each logged on user. |- ||User talk ||Cf. talk. |- ||[Wiki-Name] ||Data concerning the wiki or the project involved. Here: BlueSpice. |- ||[Wiki-Name]_Talk ||Cf. talk. |- ||Image ||Description of an image or other file. Information about the version and the uses of the file is automatically included. |- ||File_talk ||Cf. talk. |- ||MediaWiki ||System notifications. A complete list is available at Special:AllMessages. This can only be edited by users who are logged on. |- ||MediaWiki_Talk ||Cf. talk. |- ||Template ||Templates can be included in other pages. |- ||Template_talk ||Cf. talk. |- ||Help ||Help pages are there to describe how to get things done in the wiki. There is no clear division of contents between this and the [Wiki-Name] namespace. |- ||Help_talk ||Cf. talk. |- ||Category ||Pages can be assigned categories which are then accessible in this namespace. |- ||Category_talk ||Cf. talk. |} {{Box_Links-en | Thema1 =[[Reference:BlueSpiceNamespaceCss|NamespaceCSS]]| Thema2 =[[Reference:NamespaceManager|Namespace Manager]] | Thema3 = | Thema4 = }} [[Category:MediaWiki]] [[en:{{FULLPAGENAME}}]][[de:Namensraum in the search field. Since you can organize pages across categories and subpages, you should start by understanding how to manage the content in your wiki. You can visualize this for example with the BlueSpice draw.io Plugin directly in BlueSpice and discuss it with your team. ==All pages of a namespace== The display of all pages of a namespace is possible: *[[Special:AllPages|Special Page "All Pages"]] *Leave input field empty *Select namespace and click "Apply"<br /> {{Box_Links | Topic1 =[[Reference: NamespaceCss|NamespaceCSS]] | Topic2 =[[Namespace Management|Namespace Management]] | Topic3 = | Topic4 = }} [[en: {{FULLPAGENAME}}]] [[S: namespace]]
Line 1: | Line 1: | ||
− | + | ==What are namespaces?== | |
+ | '''Namespaces''' are used to divide a wiki into different areas. | ||
− | + | Namespaces structure and organize a wiki for these purposes: | |
− | + | *'''Rights management:''' To assign content to different rights and roles. For example, a company's HR department can use its own namespace to grant only Human Resources personnel access to the pages in that namespace a major reason for creating namespaces. However, flat hierarchies are recommended for wikis. | |
+ | *'''Search function:''' To exclude pages and files in the wiki from the search. | ||
+ | *'''Design:''' To format pages in different wiki areas differently. | ||
− | + | We often take the example of cupboards to make clear the principle of namespaces. There are shelves where everyone can look inside and work on something. There are glass cupboards with a lock that you can look into, but not everyone can handle everything. There are closed wooden cabinets with lock, then only selected people can look inside and work on it. And every cupboard can look different. | |
− | |||
− | + | ==BlueSpice Standard Namespaces== | |
+ | Among other things, BlueSpice uses the 15 standard and two so-called pseudo namespaces from MediaWiki: | ||
− | + | <br /> | |
− | + | {| class="wikitable tablefullwidth" | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | {| class=" | ||
|- | |- | ||
+ | !ID | ||
!|'''Namespace''' | !|'''Namespace''' | ||
− | !|'''Function''' | + | ! |'' 'Function' '' |
|- | |- | ||
+ | | | ||
||Media | ||Media | ||
− | ||Pseudo namespace for uploaded images and files. | + | ||Pseudo-namespace for uploaded images and files. Will be replaced by path of the files. |
|- | |- | ||
− | || | + | | |
− | ||Pseudo namespace for special pages. | + | ||special |
+ | ||Pseudo-namespace for special pages. | ||
|- | |- | ||
− | ||( | + | |0 |
− | ||These are given without prefix. | + | ||(pages) |
+ | ||These are given without a prefix. | ||
|- | |- | ||
− | || | + | |1 |
− | || | + | ||discussion |
+ | ||talk page. Is created in addition to each article (also in the following namespaces) to speak about its contents. Additional tab (+). | ||
|- | |- | ||
− | || | + | |2 |
− | ||User | + | ||user |
+ | ||User page. Will be created for every logged in user. | ||
|- | |- | ||
− | || | + | |3 |
− | || | + | ||Benutzer_Diskussion |
+ | ||See Discussion. | ||
|- | |- | ||
− | ||[Wiki | + | |4 |
− | || | + | ||[Wiki Name] |
+ | ||Information about the wiki or the current project. Here: BlueSpice. | ||
|- | |- | ||
− | || | + | |5 |
− | || | + | ||_discussion |
+ | ||See Discussion. | ||
|- | |- | ||
− | || | + | |6 |
− | ||Description of | + | ||file |
+ | ||Description of a picture and other files. Is automatically supplemented with version information and information about the occurrence of the file | ||
|- | |- | ||
− | || | + | |7 |
− | || | + | ||Datei_Discussion |
+ | ||See Discussion. | ||
|- | |- | ||
+ | |8 | ||
||MediaWiki | ||MediaWiki | ||
− | || | + | ||system messages. A complete list can be found under Special: AllMessages. Can only be changed by registered users. |
|- | |- | ||
− | || | + | |9 |
− | || | + | ||MediaWiki_Discussion |
+ | ||See Discussion. | ||
|- | |- | ||
− | || | + | |10 |
− | ||Templates can be | + | ||template |
+ | ||Templates can be integrated into other pages. | ||
|- | |- | ||
− | || | + | |11 |
− | || | + | ||Vorlage_Diskussion |
+ | ||See Discussion. | ||
|- | |- | ||
+ | |12 | ||
||Help | ||Help | ||
− | ||Help pages | + | ||Help pages describe how to perform actions in the wiki. No clear separation from the [wiki name] namespace. |
|- | |- | ||
− | || | + | |13 |
− | || | + | ||Hilfe_Discussion |
+ | ||See Discussion. | ||
|- | |- | ||
− | || | + | |14 |
− | ||Pages can be assigned categories which are then accessible in this namespace. | + | ||category |
+ | ||Pages can be assigned to categories, which are then accessible in this namespace. | ||
|- | |- | ||
− | || | + | |15 |
− | || | + | ||Kategorie_Discussion |
+ | ||See Discussion. | ||
|} | |} | ||
− | |||
− | |||
− | [[en:{{FULLPAGENAME}}]][[ | + | '''Standard namespace:''' A page is assigned to the (pages) namespace, as long as no other information is given. |
+ | |||
+ | '''Pseudo namespaces:''' The two pseudo namespaces (medium, special) are used like normal namespaces, but neither pages can be created nor existing pages changed. | ||
+ | |||
+ | Most pages in the namespaces are created automatically: | ||
+ | |||
+ | *Special pages are generated by the system during installation | ||
+ | *Media and image pages are created by uploading a file | ||
+ | *User pages are created whenever a user acts on the wiki | ||
+ | *Discussion pages are also created with the respective pages | ||
+ | *This leaves only the pages in the main namespace (pages), [wiki name], template, help and category that can be freely created. The pages for the respective categories can be requested via the special page "All pages". <br /> | ||
+ | {{Box_Note|Note Text =In the default MediaWiki, the names of these areas are "hard-coded". This means that they have been set in the source code of the MediaWiki and can not be changed by the users.}} | ||
+ | |||
+ | ==Calling pages in the namespace== | ||
+ | To address or create a page in a specific namespace, its name is simply placed in front of the page title and separated by a colon: | ||
+ | |||
+ | |||
+ | <code>Setup:Installation</code> | ||
+ | |||
+ | |||
+ | In the example, the pipe symbol (straight line) was also added. It has the effect that the name space can not be displayed when the link is displayed or another text can be entered, which facilitates readability. | ||
+ | |||
+ | If you specify a namespace that is not known to the wiki, the page is created in the standard namespace Main. The portion of the reference specified as the namespace is then added to the title of the item and is not recognized as an area label. <br /> | ||
+ | |||
+ | '''One namespace per page:''' A page can only be assigned to a single namespace. The same page name in a different namespace creates a new page. | ||
+ | |||
+ | '''Flat structure:''' Namespaces are only available on one level. H. a namespace can not have child namespaces. | ||
+ | |||
+ | '''Search for contents in namespaces:''' In the search, the scope to be included can be limited to individual namespaces. | ||
+ | |||
+ | ==Create own namespaces== | ||
+ | Even creating your own namespaces is possible in MediaWiki without BlueSpice only with access to the scripts. | ||
+ | |||
+ | In BlueSpice you can create additional namespaces using namespace management. | ||
+ | |||
+ | ==Organize content without namespaces== | ||
+ | However, one can use the syntax of the namespaces to help '''simulate an area in the namespace Main''' by prefixing the pages of a desired area with a colon. The general benefits of using namespaces are preserved. | ||
+ | |||
+ | So it is possible to use pages with the same name in different "rooms" and thus let different groups work on a wiki. Since these own "namespace" prefixes are part of the page name, you can now display all pages in a "namespace" by searching for the prefix in the search field. | ||
+ | |||
+ | Since you can organize pages across categories and subpages, you should start by understanding how to manage the content in your wiki. | ||
+ | |||
+ | You can visualize this for example with the BlueSpice draw.io Plugin directly in BlueSpice and discuss it with your team. | ||
+ | |||
+ | ==All pages of a namespace== | ||
+ | The display of all pages of a namespace is possible: | ||
+ | |||
+ | *[[Special:AllPages|Special Page "All Pages"]] | ||
+ | *Leave input field empty | ||
+ | *Select namespace and click "Apply"<br /> | ||
+ | |||
+ | {{Box_Links | Topic1 =[[Reference: NamespaceCss|NamespaceCSS]] | Topic2 =[[Namespace Management|Namespace Management]] | Topic3 = | Topic4 = }} | ||
+ | |||
+ | [[en: {{FULLPAGENAME}}]] | ||
+ | [[S: namespace]] |