Discussion#

Q&A -- Suggestions on v1 of plugin#

- instead of creating a very formalized index (list of letters, etc), there could be an option to just do a simple list. For instance if the name space is Zoo, we would get a list with a title Zoo and then the animals: Zoo

• Birds
  • Flamingo
  • Pelican
• Mamals
  • Cow
  • Cat

--Adler

That's an excellent suggestion. Indeed, it make sense for hierarchical namespaces to be able to generate this tree like structure. Would you see this as a mixture then, of an alphabetic tree and a hierarchical tree ? (this is not clear from your example where I would expect cow and cat in the opposite order) --DF

indeed, sure! IMO, it should be alphabetic order. In my example I was just concerned with the organization and forgot about the order, I'm sorry. (the other items were just luckly in order :) --Adler

- or, especially when you have a quite small number of pages, this could be enough (and saves a lot of space in your page)

• Birds: Flamingo, Pelican,...
• Mamals: Cat, Cow,...

See update of Sep 06 for an improved formatting of the output.

Problems#

I don't understand what does this plugin do. Can you give a clearer example?

--Adler, 27-Apr-2006

Hmm, well, the plugin assumes the name of your pages follows a kind of namespace format; i.e. a name consisting of different parts, separated by a delimiter. The plugin interpretes the page name, and generates wiki-links to each part of the namespace. Hope this helps a bit--DF

thank you for the reply, but I need an example :) Does this mean that is I call a page Zoo.Birds.page1 then somehow I'll be able to generate a list of all pages that belong to Zoo.Birds?--Adler

I just tried to install the plugin, but I couldn't figure out how to use it. I create a page with a name like "Zoo.Birds"? Should I then write [{Namespace }] on this new page? what is the link to that page? [Zoo.Birds] --Adler

Create the page [Zoo], [Zoo.Birds] and [Zoo.Birds.Flamingo]. Start each page with a call to the Namespace Plugin, no parameters needed. You will see now on the top of each page a set of links walking you back to the higher level pages of the namespace. When you want to generate a list of pages belonging the e.g. [Zoo.Birds], use the Index Plugin with the include parameter. Thus, on the same page you can use the Index Plugin and the Namespace Plugin generating links backwards and forwards in the namespace tree. Does this makes sense for you? --DF

Q: I get this message: "Plugin insertion failed: Plugin failed"

A:

Make sure there are no blanks at the end of the properties line! Or try this:

  [{brushed.jspwiki.namespaceplugin.Namespace }]

The plugin throws an NPE with the latest JSPWiki versions. I uploaded a fix so plse tryout the latest jar attachment --DF

Thanks DirkFrederickx!!! It works now :) what a nice way to start the morning! --Adler

Q: It looks like the parameter itemsPerLine='5' in "NamespacePlugin" is not working as expected. What do I need to to?
Q: How can I get rid of the bold font for the index?
Q: How can I add the output of [{Namespace }] to a different part of the page, than the content. I would like to have the Namespace navigation similar to the 'last visited' section. Thanks for your effort.

--totalz,20080604
It seems like a nice plugin to try. But it would be great if the taglib classes are included in Namespace.jar.

--alexxismachine, 20080909
The moving to apache (and less time than projects :-)) stopped me developing for jsp-wiki. As the first incubator release is at hand, I'm thinking about joining again. For the 2.4 version I developed the namespaces allowing to rename a namespace (as I am used to at work in confluence).