Help:Navigation

From Vectorlab
Jump to: navigation, search


Vcor is a wiki. It means that the common rules of navigating sites do not quite apply here. Wikies don't have a fixed structure: files can be dynamically edited, created and moved by every user (but you need special privileges for deleting them).

Navigating Vcor

On vcor you navigate the site through the Category links:

  • Go to the bottom of this page: you'll see a link containing
    Categories: Help
    Categories is a list of all categories on vcor.
    Help is the first category this page belongs to. A page can belong to many (or no) categories, every category is separated by "|"
  • Click on Help
    you will be brought to a list of all pages belonging to this category
  • Follow the links on that page

Links to the main vcor categories are always available on the Navigation menu on the left:

From there you can move down to the subcategories or pages contained

The structure of most home-pages resembles a tree, not unlike the structure of the files in your computer. The content of a wiki is different, it is flat: one folder contains all files.

To be honest we don't even have files in a wiki, we have "pages". With the exception of images, all content is stored as text in a database driven by a database engine: MySQL. Whenever you create a page, MySQL takes care of storing all of the information needed for retrieving it later. The most important thing for storing information in a wiki is the Page Name. That is the main key for organizing the content, so a page name must be unique.

This concretely means you won't find here pop-ups or other common navigational items, as you might be used to in most home-pages. In order to navigate the site you can follow the categories links displayed at the bottom of every page or the links you might find in the text of the pages. At the beginning it could be confusing.

In a wiki there are:

Pages

Pages can be organized through Categories and Namespaces. They can interact, much like in VectorWorks Classes interact with Layers. The first does not exclude the other.

(under construction)

Categories

Categories are a simple way to organize articles in a wiki, grouping them to common themes. A page can and should be declared to belong to one or more categories with a simple syntax (see below). If the category you just declared is missing, a new one is automatically created.

Every category contains a list of:

  • Subcategories if any (when you declare a category to belong to another category, it becomes a subcategory).
  • Pages if any (sometimes also called "articles").

To every category corresponds a page where all its members are listed. The present page, for example, belongs to the category "Help". If you scroll to the bottom of this page you'll see a link named "Category:Help". If you click on "help" you'll be brought to the automatically generated page listing all pages within the category "Help".

The page Special:Categories lists all currently available categories: also this page is dynamically generated and it is always up-to-date. Every page which has been categorized offers a direct link to Special:Categories. At the bottom of the present page, immediately before "Help" you can see a link called "Category:". This link brings you to the list of all categories.

Whenever you write an article you might wish to have it placed in one of the given categories. Choose the one which is appropriate for your article.

Example
you wish to place an article in the category "VectorWorks". In order to do this you simply write the line below at the beginning of your page.
[[category:VectorWorks]]
Example
you wish to link to the category "VectorWorks". Prefix the name of the category with a colon (more about links under Referencing):
[[:category:VectorWorks]]
Note
Should you wish to create a new category, please propose it first to the community. Do not act on your own. Having abundance of categories with little content can impair the readability of vcor considerably.

(There is much more about categories that could be discussed here.)

Info tools

There are some built-in facilities for managing categories, which are to be accessed from Special:Specialpages

Management tools

The following special pages are a help for the people administrating this wiki:

  • Special:Uncategorizedpages pages waiting to be categorized. We should care for these pages to be categorized, parse the list and place these pages where they should belong.
  • Special:Unusedcategories unused categories. How can it happen? It happens when a category is declared somewhere, then some content is placed into the category page, content which is created by a user and not only automatically generated lists. When no pages link to this category its page survives anyway. And lands into the "Unusedcategories" special page. It should be manually removed by a sysop.
  • Special:Wantedcategories categories wich have been called but whose pages do not include any text but the automatically generated content (the list of all subcats or pages)

For an extensive explanation about categories please visit Wikipedia:Categorization FAQ.

Namespaces

Namespaces define different areas of content in a deeper way than categories do. Among other things, namespaces allows special rights to be set to a whole block of content, according to the status of the user. This is not possible with categories.

Namespaces are always in pairs: <namespace> and <namespace talk>. For example the present page is in the namespace "Help" and has a talk space called "Help talk", while its name is "Navigation". The most notable function for this dichotomy is to split content from opinions.

As a rule one strives to be essential and factual in articles, which on vcor would belong to Main or NNA. The corresponding talk pages are dedicated to discussion and exchange among users. Every page offers direct access to its corresponding talk space. Go at the top of this page: you'll notice a tab named 'Discussion]'. This brings you directly to the talk namespace corresponding to the present namespace. Every page has a "Discussion" tab.

Whenever you meet a page whose name is prefixed with something followed by a colon it means that it is placed in a different namespace than "Main".

For example, the main help page is titled Help:Contents. The prefix "Help" defines its namespace as to "Help". A page like Events is in the main namespace. It's name doesn't have a prefix followed by a colon.

In vcor we employ a number of namespaces. Go to Special:Allpages. There you can explore the current namespace architecture of vcor.

principal namespaces in vcor
namespaces for general content: their talk namespaces:
Main generally you'll wish to put your articles here. Below 10 pages from the namespace Main:

...

Talk here you'll discuss about the articles. Below 3 pages from the namespace Main Talk:

...

User every logged in user has a personal user space, click on your user name up right to access your personal space. Here you can write some informations about yourself or your firm, if you prefer. You might also wish to write here articles that will be moved later to the main namespace, add script snippets, or whatever is proper for you. The common netiquette rules apply here. It is Your user space but still, remember, it is very public! You can also create subpages in your user space.

The "User" namespace and it's talk is not searched by default. But you can change this in your user "preferences".

We currently have 28 registered users on vcor. Go to Special:Listusers, there you'll find the actual list of all users on vcor with links to their user's spaces. If the links are not red, you will find some content into their spaces.

Below 5 pages from the namespace User:

...

User talk discussion area of your own user space.
VCOR.net for site related content, nor for general content.

...

Vcor talk discussion space of Vcor pages.
NNA special protected space for content deriving from NNA sources (copyrighted).

...

NNA talk discussion space of NNA pages.
Technical namespaces: their talk namespaces:
Template Templates are special text snippets meant to be included or transcluded in general pages. They allow extended syntax and are a way to standardize text input or structure. To some extent they can be real programs for parsing/creating text while their usage is mostly very straightforward. In short: let admins or experienced users develop or change them, but use them as you please.

Here you can view all templates.

...

Template talk discussion space of Template pages.
Help space for help. The present page belongs to this namespace.

...

Help talk discussion space of Help pages.
Category pages defining a category. For an explanation about category see Categories

Here you can view all categories.

...

Category talk discussion space of Category pages.

For an advanced introduction to namespaces visit Namespace on wikimedia.