Item13813: / not always equivalent to . in References
Priority: Normal
Current State: Duplicate
Released In: n/a
Target Release: n/a
Applies To: Engine
Component: INCLUDE
Branches:
My
WebLeftBar
INCLUDEs content from other topics. One of those topics is
Main/Shared/WebLeftBarTools
which contains this bit of code
* Tools
* [[%SYSTEMWEB%.UserToolsCategory][User Tools]]
* [[%SYSTEMWEB%.AdminToolsCategory][%ICON{"wrench"}% Admin Tools]]
* [[%SYSTEMWEB%.ManagingWebs][Manage Webs]]
This works as expected.
However, prior to a few minutes ago, the last line of that code looked like this:
* [[%SYSTEMWEB%/ManagingWebs][Manage Webs]]
When I used a
/
instead of a
.
, my left bar rendered like this:
Instead of linking to the
ManagingWebs
topic in
%SYSTEMWEB%
, it tried to link to a topic in a
System
subweb of
Main/Shared/
.
--
VickiBrown - 12 Oct 2015
In Web and Topic addressing, the slash is specifically a "web / subweb" separator. The
INCLUDE macro has to parse apart the web from the topic. Using the URL form Web/Topic is confusing the macro processing. The safest practice is always use dot as the Web.Topic separator and only use slash as a Web/Subweb separator.
Unfortunately the documentation about Subwebs is a bit confusing. See also
Item12930. This whole area needs some review and cleanup. Setting to confirmed.
--
GeorgeClark - 27 Oct 2015
Changing this task to Duplicate.
Item12930 addresses the same issue but in general. For this specific task, it's working as intended. In TML, slash only separates webs. dot separates webs from topics.
--
GeorgeClark - 19 Dec 2015