Difference between revisions of "Meta:Wiki Structure"

From Synfig Studio :: Documentation
Jump to: navigation, search
(few more words)
(Namespaces and page location: described namespaces and their purpose)
Line 1: Line 1:
 
== Namespaces and page location ==
 
== Namespaces and page location ==
...
+
Pages on this wiki are grouped into collections called "'''namespaces'''", which differentiate between the purpose of the pages at a high level. Pages in certain namespaces can also have special properties or behave differently when they interact with other pages.
 +
 
 +
Namespaces are indicated in page titles by prefixing the page name with "<tt>namespace:</tt>", so the prefix "<tt>{{NAMESPACE}}:</tt>" in this page's title ("{{FULLPAGENAME}}") indicates that this page is in the {{NAMESPACE}} namespace. Note, however, that colons and prefixes can also appear in page titles ''without'' indicating a namespace: The page [[Foo:{{PAGENAME}}]] is a page located in the Main namespace because the namespace "Foo" does not exist (the "Main namespace" does not have a prefix).  Similarly the page [[{{NAMESPACE}}:Foo:{{PAGENAME}}]] is in the "{{NAMESPACE}}" namespace.
 +
 
 +
You can read more about namespaces [http://www.mediawiki.org/wiki/Manual:Namespace here].
 +
 
 +
'''If you creating a new page in this wiki, please consider putting it into right namespace.'''
 +
 
 +
Here's a list of defined namespaces and their descriptions:
 +
* '''Main''' - These pages describing concepts and definitions. Usually they are part of the  {{l|Category:Reference}} or {{l|Category:Glossary}}. Remember, that pages in main namespace have no prefix, that makes them easy to reference from other pages.
 +
* '''Doc''' - This namespace is for {{l|Category:Manual|manual}} and {{l|Tutorials|tutorials}} pages. Generally they dedicated to describing some process, i.e. [[Doc:Creating Shapes]], [[Doc:Animation Basics]].
 +
* '''Command''' - Pages in this category describe functionality of commands from Synfig menus (i.e. [[Command:Open]], [[Command:Save_as]]).
 +
* '''Dev''' - These pages are to help developers and/or to describe project functionalities as they are implemented, i.e. [[Dev:Roadmap]].
 +
* '''Meta''' - These pages deals with the wiki itself, its usage, development and standards.
 +
 
 +
Just like in any other wiki based on MediaWiki engine, you will find following built-in namespaces:
 +
* '''Category''' - Categories pages.
 +
* '''User''' -  In your user page you’re quite free to add anything you want (should be related to Synfig though). Please avoid spamming with links to commercial sites unrelated to Synfig.
  
 
== Page head ==
 
== Page head ==

Revision as of 19:22, 30 January 2010

Namespaces and page location

Pages on this wiki are grouped into collections called "namespaces", which differentiate between the purpose of the pages at a high level. Pages in certain namespaces can also have special properties or behave differently when they interact with other pages.

Namespaces are indicated in page titles by prefixing the page name with "namespace:", so the prefix "Meta:" in this page's title ("Meta:Wiki Structure") indicates that this page is in the Meta namespace. Note, however, that colons and prefixes can also appear in page titles without indicating a namespace: The page Foo:Wiki Structure is a page located in the Main namespace because the namespace "Foo" does not exist (the "Main namespace" does not have a prefix). Similarly the page Meta:Foo:Wiki Structure is in the "Meta" namespace.

You can read more about namespaces here.

If you creating a new page in this wiki, please consider putting it into right namespace.

Here's a list of defined namespaces and their descriptions:

  • Main - These pages describing concepts and definitions. Usually they are part of the Reference or Glossary. Remember, that pages in main namespace have no prefix, that makes them easy to reference from other pages.
  • Doc - This namespace is for manual and tutorials pages. Generally they dedicated to describing some process, i.e. Doc:Creating Shapes, Doc:Animation Basics.
  • Command - Pages in this category describe functionality of commands from Synfig menus (i.e. Command:Open, Command:Save_as).
  • Dev - These pages are to help developers and/or to describe project functionalities as they are implemented, i.e. Dev:Roadmap.
  • Meta - These pages deals with the wiki itself, its usage, development and standards.

Just like in any other wiki based on MediaWiki engine, you will find following built-in namespaces:

  • Category - Categories pages.
  • User - In your user page you’re quite free to add anything you want (should be related to Synfig though). Please avoid spamming with links to commercial sites unrelated to Synfig.

Page head

Title tag

That tag is used to specify proper title for translated pages. Although it's not required for every...

Category tag

You can specify categories page belongs using "Category" tag, like this:

{{Category|Manual}}

Please add those lines at the top of the page.

Consider the fact that this syntax statement differs from usual MediaWiki syntax. In ordinary MediaWiki setup category is specified with [[Category:MyCategory]] statement and you are forced to use [[:Category:MyCategory]] syntax if you want a link to category. That approach is replaced by more logical for our taste, where all links are defined by L tag and categories set with Category tag.