yard icon indicating copy to clipboard operation
yard copied to clipboard

Mismatching name/link for spaces in extra files’ names

Open ParadoxV5 opened this issue 2 years ago • 1 comments

Extra files with space(s) (and possibly other non-alphanumerics too) in their names have over-sanitized name in file_list.html and consequently sidebars on all pages.

Steps to reproduce

$ touch 'Extra File.txt'
$ yardoc - 'Extra File.txt'
Files:           0
Modules:         0 (    0 undocumented)
Classes:         0 (    0 undocumented)
Constants:       0 (    0 undocumented)
Attributes:      0 (    0 undocumented)
Methods:         0 (    0 undocumented)
 100.00% documented
$ ls doc/file.*
'doc/file.Extra File.html'
$ grep 'file\.' doc/file_list.html
    <div class="item"><span class="object_link"><a href="file.Extra_20File.html" title="Extra File">Extra File</a></span></div>

Actual Output

file.Extra File.html in file system, file.Extra_20File.html in href

Expected Output

Either:

  • file.Extra File.html in file system, file.Extra%20File.html in href
  • file.Extra_20File.html in file system, file.Extra_20File.html in href

Environment details

  • OS: Ubuntu 23.04 (does this matter for software errors?…)
  • Ruby: ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-linux]
  • YARD: yard 0.9.34 (v1.0 when)

I have glanced over the Contributing Guide and CoC.

ParadoxV5 avatar Aug 24 '23 21:08 ParadoxV5

P.S.

Workarounds

Don’t use spaces in file names. Command lines will also thank me. But I like descriptive file names…

Relates to

#1289

ParadoxV5 avatar Aug 24 '23 22:08 ParadoxV5