| |
Subweb and topic names - conflicts, view URLs, and links
If your TWiki installation has the hierarchical webs feature turned on,
you face subtle issues about subweb (web inside a web) and topic names.
If you are unfamiliar with subwebs, please read ManagingWebs#Hierarchical_Webs.
TWiki 5.1.2 has introduced measures to take care of those issues.
As such, in this topic "in the past" means 5.1.1 and earler; "now" means 5.1.2 and later.
Avoiding conflicts of subweb and topic names
If the topic AaAa.BbB exists, the subweb AaAa/BbBb must not exist.
If they co-exist, when the topic AaAa.BbBb is moved, all topics of the AaAa/BbBb subweb lose all attachments.
This is because AaAa.BbBb topic's attachments are stored in the directory
.../pub/AaAa/BbBb/ while AaAa/BbBb subweb's topics have their attachments in the directory .../pub/AaAa/BbBb/TOPIC/.
When AaAa.BbBb topic is renamed to AaAa.CcCc, .../pub/AaAa/BbBb directory is renamed to .../pub/AaAa/CcCc, which causes AaAa/BbBb subweb to lose its all attachments.
In the past there was no mechanism to avoid clash of subweb and topic names.
But now you cannot create a subweb whose name clashes with an existing topic name and vice versa.
Renaming of topics and webs have name clash detection and avoidance logics.
View URLs
Let's say there is a subweb named AaAa/DdDd.
In the past http://twiki.example.com/cgi-bin/view/AaAa/DdDd led to the "This topic does not exist" page.
But now it causes redirecttion to http://twiki.example.com/cgi-bin/view/AaAa/DdDd/WebHome.
Even now, AaAa.BbBb topic and AaAa/BbBb subweb may co-exist as a legcy from an old version.
In that case, http://twiki.example.com/cgi-bin/view/AaAa/BbBb shows AaAa.BbBb topic while http://twiki.example.com/cgi-bin/view/AaAa/BbBb/ shows the home page of the AaAa/BbBb subweb.
Links on topics
TopicName, WebName.TopicName, [[TopicName][...]], and [[WebName.TopicName][...]] become links to the specified topics.
If TopicName is actually a subweb name rather than a topic name, those links point to WebHome of the subweb.
This may sound strange to a long term TWiki user.
If a subweb AaAa/DdDd exists, on the topic AaAa.EeEe, DdDd and [[DdDd]] become links to AaAa/DdDd.WebHome.
You can link to a subweb in a relative manner.
The old behavior was to make a link to create the "missing topic" AaAa.DdDd.
This is wrong for sure.
And they have to become links - otherwise the label in [[link][label]] goes nowhere.
If so, there is no other link destination than WebHome of the subweb.
Related Topics: AdminDocumentationCategory |
