Namespace Tutorial

[mangus580]

Ok... I have tried to figure out how this all interacts...

Since there isnt a demo to mess with, maybe you could provide a step by step image tutorial on how to set up Namespaces? With 'real' examples as to their purpose?


I am really confused!

[pegasus]

It's unlikely that you will ever need to set up Namespaces aside from during initial installation or installing an addon that tells you to create a new one. Most namespaces have different functions.

However, should you ever want to create a separate namespace for other reasons, or if your just confused about the additional settings, read on. Actually, all of the settings are described in depth if you click on the question mark icon in the AdminCP. This would open the Admin Help article relating to that particular option.

1. First you need to create a forum. Go to AdminCP -> Forums & Moderators -> Add New Forum. When creating the forum, make sure that "Parent Forum" is set to "No One." Also make sure that "Enable Wiki in this Forum?" is set to "Disabled."

It must be possible to post in this forum, so it cannot be a Forum Category. This might break some styles. In that case, set the "Display Order" to 0, if you are going to use "Display in Forum" in step 4, DO NOT set the Display Order to 0.

2. You still may want the forum to appear inside an existing category, or you can create another forum to act as a Forum Category now. If you do, leave the "Parent Forum" set to "No One" for now.

3. Go to AdminCP -> CES VaultWiki -> Namespace Manager -> Add New Namespace.

4. Fill out the "Title" and "BB-Code Tag" fields. They should be similar to make it easy for your users to remember. "Display Title" can be left blank. "Display in Forum" can be left set to "No One."

5. For "Top-Level Forum," select the name of the forum you created in Step 1. If you wanted to make the forum appear in a Forum Category's forum list, set "Display in Forum" to the name of that Category. Do not set "Display in Forum" to the forum you want to actually post articles in. If you use Display in Forum, make sure the Top-Level Forum's "Display Order" is NOT 0.

6. Click save. Go to AdminCP -> Forums & Moderators -> Forum Manager. Select the forum you set to "Top-Level Forum" in Step 5, and click Edit.

7. Where it asks "Enable Wiki in this Forum?" change it to "Wiki." Click save.

8. You can now create subforums to the forum. As long as "Enable Wiki in this Forum?" is set to "Wiki" in each of them, they will also be considered a part of the namespace, so any articles contained in them will count towards that namespace.

9. You can visit any of these forums in the forum list now and click "New Thread" to start making articles.

[mangus580]

Ok... so Lets call my namespace WIKI

so I make a top level forum called WIKI, make my namespace called WIKI. Set the settings as stated above.

Now...

If I create say a couple subforums in WIKI... for lets say Car, Truck, SUV.

I can only have one article total titled Tires.... correct?

[pegasus]

You can only have one article called Tires in WIKI's hierarchy.

[mangus580]

So would it be best to create a book for each vehicle? Then each book could have a chapter?

(very new to wiki....)

[mangus580]

or would I create a new namespace for each 'vehicle' and work from there?

[pegasus]

On our site we wouldn't mind having an article called "Tires (Vehicle X)." This is usually better because it keeps the number of namespaces to a minimum. Books are also an option, but they don't correct the title issue. They are simply a way of presenting related information, so you could have a book for each vehicle, and "Tires (Vehicle X)" is a chapter so users don't have to remember the "(Vehicle X)" part if they are simply clicking the table of contents link.

[beduino]

Hello,
tks for tutorial - few hours later I create my first wiki ....

But how we can create a category to avoid crash our styles?
tks a lot
joao barroca
aka beduino

[NickyPhils]

Set the forum's Display Order to 0. This will make it disappear completely. To make it display again in another forum/category, in the Namespace Manager, use the Display in Forum feature.

[Will.Spencer]

So, during the initial installation process, we absolutely need to create a minimum of five new forums and assign a namespace to each of these new forums:

1. Template
2. Help
3. Header
4. Book
5. Default

Am I reading you correctly?

If we want to create a "book" for our members, which of these forums do we need to make publicly visible?

[pegasus]

You don't ABSOLUTELY need to, but each of those forums enables specific functionality, which if they are missing, the wiki will not be able to perform. It is highly recommended that you DO create all of them. If you ever run into bugs later, having all the namespaces set up will make the troubleshooting process much smoother.

And I'm a bit unclear what you want to do regarding "Books"... If you want members to be able to access the namespace and create pages, then you should make it publicly visible.

[Will.Spencer]

I want to create an online book. Only a few members will have write access. Everyone else will have read-only access.

If I create all of those forums, can I hide them so that "the public" can only see the "Book" forum?

Right now, I only have the "Book" forum and it seems to be working. I'm not sure what I am missing by not having the other forums.

The "Book" forum is hidden, because it's not ready for public viewing yet.

[pegasus]

I'm surprised that you're not receiving that very unfriendly error message -- or did you set up a Default forum too?

[Will.Spencer]

I have not set up a Default forum yet and I'm not seeing an error message.

If I set up all of these forums, which ones do I have to make visible to people who I want to read the book?

I'd prefer to hide the "guts" of the wiki engine from casual readers.

[tommythejoat]

I just installed Vault Wiki. I have not done any of the add ons. This is a fresh install. There is no previous anything except vBulletin and a bunch of unrelated mods.

I do not see any contents for the Wiki FAQ. Indeed there is no FAQ that I can find.

I don't know what arguments the tags require. i.e. I presumed that the [help]tag[/help] would look up tag in the help namespace and return the article when the item was clicked. It asked for a parametere and I don't know what it wants.

Is there documentation with the produce, or do I need to find it here in the discussions and build my own FAQ?

While I was writing this another of the users tried to look at the incomplete article (how could he see that?) and I got a database error. I haven't had a chance to ask what he was doing yet.

Database error in vBulletin 3.8.1:

Invalid SQL:
;

MySQL Error   : Query was empty
Error Number  : 1065
Request Date  : Friday, March 20th 2009 @ 10:26:16 PM
Error Date    : Friday, March 20th 2009 @ 10:26:17 PM
Script        : http://mb.nawcc.org/showwiki.php?title=Help:Wiki&do=talk
Referrer      : http://mb.nawcc.org/showwiki.php?title=Help:Wiki
IP Address    : 72.161.186.78
Username      : kirxklox
Classname     : vB_Database
MySQL Version :

I am sure I will be back with a lot more comments and questions. I installed 2.2.0, the latest stable release.