question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Add ZERO WIDTH SPACE to TOC yml

See original GitHub issue

I’m using DocFX to generate our API documentation. I’m currently working on styling our own theme. The problem is our namespace are quite long so they disappear from the menu. When I was looking at the Microsoft .NET Core API documentation I saw they added the ZERO WIDTH SPACE character to the a href. Trying to do something like this for our documentation ended up in editing the toc.yml in the /api directory. But since this file is generated in a build on VSTS this will not work.

Now I’m figuring out how I can add this ZERO WIDTH SPACE before the dots in our namespace. Together with adding word-wrap: break-word; to the CSS will result in nice word breaking in the menu.

Curious if it’s a useful edit to docfx or if it should be in a plugin.

Related to: https://github.com/dotnet/docfx/issues/234#issuecomment-274363106 https://github.com/dotnet/docfx/issues/1222#issuecomment-274362558

Issue Analytics

  • State:closed
  • Created 6 years ago
  • Comments:6 (5 by maintainers)

github_iconTop GitHub Comments

1reaction
vwxyzhcommented, Mar 30, 2017

@qinezh , what about search?

0reactions
hellosnowcommented, Mar 31, 2017

@vicancy sounds a good approach. 👍

Read more comments on GitHub >

github_iconTop Results From Across the Web

Zero-width space
The zero-width space (​), abbreviated ZWSP, is a non-printing character used in computerized typesetting to indicate word boundaries to text-processing ...
Read more >
Zero-Width Space
The ZWS or ZWSP has width of zero (totally invisible) and allows line break similar to regular space. Then there exists ZWJ or...
Read more >
Setting up navigation - Material for MkDocs
Hiding the sidebars¶. The navigation and/or table of contents sidebars can be hidden for a document with the front matter hide property. Add...
Read more >
AsciiDoc Syntax Quick Reference
The text is shown in a fixed-width (typically monospace) font. The lines are preformatted (i.e., as formatted in the source). Spaces and newlines,...
Read more >
Zero-width non-joiners and and zero-width space inserted in ...
A workaround is to insert spaces in the comment wherever possible, so that there are no long runs (>80 characters?) without spaces. – ......
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found