You are here: Foswiki>Tasks Web>Item12050 (05 Jul 2015, GeorgeClark)Edit Attach

Item12050: UNC Links are corrupted by render when they contain embedded spaces

Priority: Normal
Current State: Closed
Released In: 2.0.0
Target Release: major
Applies To: Engine
Component: FoswikiRender, WysiwygPlugin
Branches: master
Reported By: GeorgeClark
Waiting For:
Last Change By: GeorgeClark
Reported on IRC by an anonymous user. (see,Thu&sel=257#l253 )

  • 1 - Link with embedded spaces pasted into a squab link. The space is interpreted as the deprecated space delimited [[link title]] format. Wikiwords in the title part are rendered, and generally it's completely corrupted. We should probably encode the spaces automatically when rendering as a link, and not apply the deprecated space delimited format to file: style links.

[[file:///\\somesite.local\data\somesite\Shared Docs\Software Projects\Soft AAbBC\system_design\imaging\AAbBC Imaging Glossary.doc]]

  • 2 - Manually encoding spaces as %20 in the UNC, the link is rendered correctly.


  • 3 - Link with embedded spaces pasted into a href link. Even though contained within the quoted string, the rendering is corrupted. However WysiwygPlugin correctly converts this link into case 2. resulting in an encoded link in the squab. So after an edit/save cycle with wysiwyg, the link renders correctly. We should not break the quoted string on the space, and should auto-encode the spaces so the user doesn't have to.

<a href="file:///\\somesite.local\data\somesite\Shared Docs\Software Projects\Soft AAbBC\system_design\imaging\AAbBC Imaging Glossary.doc"> some doc</a>

  • 4 - Correctly encoded link renders correctly

<a href="file:///\\somesite.local\data\somesite\Shared%20Docs\Software%20Projects\Soft%20AAbBC\system_design\imaging\AAbBC%20Imaging%20Glossary.doc"> another doc</a>

Confirmed identical behavior on trunk and release11 branches.

-- GeorgeClark - 24 Aug 2012

See Support.Faq72 for more details.

-- GeorgeClark - 24 Aug 2012

Defering to 1.2.

-- GeorgeClark - 02 Nov 2012

The embedded space issue is because there is an old deprecated link format where space delimits between the url and the text. I suspect that the only way to support embedded spaces in links is to eliminate the legacy format. From a comment in

# Legacy case of '[[URL anchor display text]]' link

-- GeorgeClark - 19 Jun 2014

Well I thought that this format was deprecated, but it it's not documented as such. See TextFormattingRules
You can also write [[ Yahoo home page]] as an easier way of doing external links with descriptive text for the link, such as Yahoo home page.

I've got a patch available that disables the legacy format so that spaces can be used in links. Unfortunately this probably needs a proposal.

-- GeorgeClark - 20 Jun 2014

Another option would be to test for a file:// style link and disable the space delimiter. This is also done for any link containing a ? indicating that there might be url parameters. That would let the legacy format remain. See the rejected proposal: DeprecateUndocumentedSqBracketLinkFormat

-- GeorgeClark - 20 Jun 2014

Testing for file:// does make sense ... as does all the other tests for special cases. And tomorrow we will add even more tests for more special cases where the behavior should diverge.

I've got the feeling that now we are at a point to hold on and stop this. A deprecation process finally has to follow up on removing a feature at some point. Even more so when it hinders further advance.

So instead of adding YASC (yet another special case), I'd rather prefer to simplify things by removing long deprecated non-documented features. Only then will any further modifications on parsing square bracket links make sense.

We should make it a habit to remove deprecated features on dot oh releases.

I am afraid there are so many deprecated features that long should be executed upon. We really should list them all including dates they were created and planned releases their referring feature is about to be removed, maybe a patch contrib to bring it back for the real desperate cases.

-- MichaelDaum - 20 Jun 2014

So resolution of this will be to strip out the space delimited square bracket format: [[ Yahoo home page]].
  • Remove from
  • Remove from documentation
  • Remove from WysiwygPlugin

-- GeorgeClark - 02 Aug 2014

Also fixes Item12824

ItemTemplate edit

Summary UNC Links are corrupted by render when they contain embedded spaces
ReportedBy GeorgeClark
Codebase 1.1.5, trunk
SVN Range
AppliesTo Engine
Component FoswikiRender, WysiwygPlugin
Priority Normal
CurrentState Closed
Checkins distro:6231fd0d26d3 distro:b8543d4cacbf
TargetRelease major
ReleasedIn 2.0.0
CheckinsOnBranches master
masterCheckins distro:6231fd0d26d3 distro:b8543d4cacbf
Topic revision: r9 - 05 Jul 2015, GeorgeClark
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy