Comments (4)
I'm not seeing that behavior. The divs create columns and the content is typically restricted to the width of each column (TOC on the left, content in the middle, and In This Article on the right). Can you provide an example that shows the behavior you are seeing?
from shfb.
Here's an example project:
https://github.com/glenncarr/shfb-toc-1047
Here's what I'm seeing:
https://github.com/glenncarr/shfb-toc-1047/blob/master/toc-example-problems.gif
from shfb.
The problem is caused by long, unbroken strings of text that cannot be word wrapped. They seem to cause a minimum column width which makes the div exceed its normal bounds and causes the overlapping. You can work around it to some extent by inserting HTML word break elements (wbr
) in the long text strings so that the browser knows were it can break the text and allow wrapping. It's not a valid MAML element but due to the way the elements are handled, it'll be recognized and passed through anyway.
<entry>
<legacyBold>XXXXXXX<wbr/>XXXXXXXXXXX_<wbr/>XXXXXXXX_<wbr/>XXXXXXXXXXX</legacyBold>
</entry>
I do that in the link text for API members, but it looks like I missed a number of places so it's not consistent and I'll have to go back through fix those up. My knowledge of HTML and CSS is marginal so I'm not sure if there's a way to prevent the overlapping and just make it scroll horizontally instead or hide it if it overlaps. For me, it would probably be easier to just provide an option to hide the In This Article div for the page on a case-by-case basis.
from shfb.
We actually generate the MAML for this particular page with another tool as a build step before finally building the .shfbproj. It would be possible to add <wbr/>
's, those specific values are symbols that would look strange if broken. I'd thought about making that into a definitionTable
, but it loses its value without the other information in the columns.
For me, it would probably be easier to just provide an option to hide the In This Article div for the page on a case-by-case basis.
That would be great and very much appreciated.
from shfb.
Related Issues (20)
- Cannot install extension on arm64 HOT 1
- Enable TOC using current presentation style HOT 4
- Building with NuGet tools with MsBuild is broken in Visual Studio HOT 4
- Numeric constant formatting for enumeration to allow searching for constant HOT 2
- Error BE0065: An error occurred while attempting to transform the reflection data to a topic. When Extensions Methods to Enum. HOT 3
- Some types excluded from documentation? HOT 3
- Documenting a `net8.0` project when using `msbuild.exe` HOT 3
- Linux/Docker builds HOT 5
- An error occurred while attempting to transform the reflection data to a topic. The error message was: System.NullReferenceException HOT 3
- Problem with installer when only VS 2022 is installed. HOT 4
- Support for Nuget Central Package Management
- CodeBlockComponent: F# closing endregion comment tag included in rendered text.
- Sandcastle is running out of memory HOT 7
- HowTo - Install current HTML Help 1 Compiler for Client, Server or Docker image HOT 1
- Add Project Error in VS2022 Community HOT 2
- Build fails with "System.Drawing.Common is not supported on this platform" error when using '<alert>' element in '.aml' conceptual doc and 'Open XML Document' output style HOT 3
- Add some text in HTML documentation HOT 3
- Comment XML not recognized HOT 4
- Linked content files in SHFB project get not resolved HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from shfb.