User Tools

Site Tools


namespace

This article is under development. It is only a draft how to deal with the namespace-problem. The discussion about this is not finished!
!!! Don't follow the instructions, while the discussion is on !!!
See RocRail Forum for more information.

The namespace problem

The DokuWiki offers the possibility to use so called Namespaces to structure the wiki content. For instance to separate the "sandbox" form the rest of wiki this is very helpful.
FIXME [For what reason was the namespace 1.3 created.]
FIXME [Why don't we want to use this any more]

The challenge

At the moment (2009-11-22) there are several 1.3 namespace articles which have to be moved to the no namespace wiki structure. This sounds no so complicated at all, but there are serveral problems:

  • linkage: If you move an article, you have to check the links form and to this article, too. Finding a link to an moved article is quite tricky. We need to find this links in order to keep the wiki working. A wiki of dead links would not be helpful.
  • In some cases there are more then one article to the same matter. This is product of not easy to use internal linkage. So we have to identify parallel articles and reunited them the no namespace article.

How to identify a 1.3 namespace article

A the namespace is part of the article URL. The URL has the follwing syntax:

http://wiki.rocrail.net/doku.php?id=<namespace>:<article id>

So if your browser shows you the follwing URL:

http://wiki.rocrail.net/doku.php?id=1.3:turntable-int-en

you see the english turntable interface article, which is in "1.3" namespace.

How to search for 1.3. namespace articles

Go to special pages. At the bottom left of every wiki page you found the toolbox and in it the special pages. This page shows a list of all wiki articles sorted by namespace, browse the 1.3 namespace by clicking "1.3". All articles and subnamespaces will be shown indented.

How To Move Articles

  • Mark all 1.3 namespace articles with a annotation, in order to advise other wiki writers to this process. See annotation template no. 1
  • Move article content to the no namespace article. Doing this make the article up to date, correct links and mark links to other 1.3 namespace articles with a FIXME. ATTENTION: a link with out leading ":" is relative. If it copied form a 1.3 namespace article it originally leads to the 1.3 namespace article "1.3:dummy". To learn more about linking in namespaces see DokuWiki documentation.
  • If the no namespace article is up to date, delete the 1.3 namespace article content and ad an annotion. See annotation template no. 2:
  • Search for links to the 1.3 namespace article (so called backlinks) and redirect them to the no namespace article. You can use the backlink function to search them. Although you can search links with the normal search function of the wiki. The search string is the whole article id (including namespace) in quotation marks, e.g.
    "1.3:dummy-en"
  • If a 1.3 namespace article becomes an orphan and it's content was moved already, you can delete it, by deleting the whole content (annotations included).

Annotation templates:

No. Annotation Code
1 FIXME This article is part of 1.3 namespace! If your are a wiki writer, inform yourself about the namespace problem before editing. FIXME
FIXME This article is part of //1.3 namespace//! If your are a wiki writer, inform yourself about the [[:namespace|namespace problem]] before editing. FIXME
2 :!: Article moved to <insert link to no namespace article>. If you got here by a link, correct the link, please. If don't know how, give the wiki writers a feedback where to find the incorrect link using the rocrail forum.:!:
:!:Article moved to <insert link to no namespace article>. If you got here by a link, correct the link, please. If don't know how, give the wiki writers a feedback where to find the incorrect link using the rocrail forum.:!:
namespace.txt · Last modified: 2018/11/12 08:56 (external edit)