• Do not register here on develop.twiki.org, login with your twiki.org account.
• Use View topic Item7848 for generic doc work for TWiki-6.1.1. Use View topic Item7851 for doc work on extensions that are not part of a release. More... Close
• Anything you create or change in standard webs (Main, TWiki, Sandbox etc) will be automatically reverted on every SVN update.
Does this site look broken?. Use the LitterTray web for test cases.

Item4081: Broken Links to Topics and Subwebs

Item Form Data

AppliesTo: Component: Priority: CurrentState: WaitingFor: TargetRelease ReleasedIn
Engine Documentation Urgent Closed   minor 4.2.0

Edit Form Data

Reported By:
Applies To:
Current State:
Waiting For:
Target Release:
Released In:


I just upgraded from 4.0.3 to 4.1.2 had some links stop working. There are two categories of links.

First, links to subweb stopped working.

    * [[Foo/Bar][Foo Bar]]
Second, links with certain characters stop working:
---++[[Foo Bar (a.k.a., Fubar)]]
Used to link the topic: FooBar(aka,Fubar).txt, but now the links shows with the little question mark (same as above). -- TWiki:Main/EricHanson - 16 May 2007

This is the result of a compatibility issue. I had defined the rules in 4.0 to link subwebs the way you describe, but was beaten up corrected, and the behaviour reverted to the way Cairo worked, which breaks the type of link you describe.

The second type of link is a different kettle of fish. You used dots in the link name, which are parsed as subwebs. Arguably this should still work the old way if subwebs are disabled, but the code complexity and user confusion this would engender makes me think we shouldn't do it.

It would be straightforward to write a script to convert both types of link in existing topics; but that's the only solution I can suggest, I'm afraid.

No action in the code, but i checked the documentation and it's extremely weak on e rules for square brackets, so confirming this report.


Linking to a sub web [[Foo.Bar]] prevented the creation of a topic [[Foo.Bar]].

-- TWiki:Main.MichaelDaum - 02 Jun 2007

This is currently a release blocker, any details of what parts of the doc need to be touched? TextFormattingRules? TWiki/WikiWord? The "Managing Webs" section of TWikiPreferences?

-- TWiki:Main.SteffenPoulsen - 03 Jun 2007

Yes, to all the above. Anywhere square bracket links are explained.

-- TWiki:Main.CrawfordCurrie - 02 Jul 2007

[23:35] <Lavr> I guess he wanted input on "which docs"
[23:36] <PeterThoeny> textformattingrules is one
[23:36] <PeterThoeny> wikiword another
[23:36] <PeterThoeny> i am not aware of any other doc that describes linking
[23:37] <Lavr> Let us stick to those two to close the bug
-- TWiki:Main.KennethLavrsen - 02 Jul 2007

Doc improved. Believe this should be enough. Waiting for release.

-- TWiki:Main.KennethLavrsen - 02 Sep 2007

Summary Broken Links to Topics and Subwebs
ReportedBy TWiki:Main.EricHanson
Codebase 4.1.2, ~twiki4
SVN Range TWiki-4.1.2, Sun, 13 May 2007, build 13714
AppliesTo Engine
Component Documentation
Priority Urgent
CurrentState Closed

Checkins TWikirev:14687
TargetRelease minor
ReleasedIn 4.2.0
Edit | Attach | Watch | Print version | History: r12 < r11 < r10 < r9 < r8 | Backlinks | Raw View |  Raw edit | More topic actions
Topic revision: r12 - 2008-01-22 - KennethLavrsen
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback