Asciidoctor :: Discussion

html5 TOC disappears with default 0.1.4 styles

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

2 messages Options

rwinch

Oct 23, 2013; 9:46pm

html5 TOC disappears with default 0.1.4 styles

27 posts

I noticed that when using the default styling from 0.1.4 with the html5 backend, the TOC can partially disappear under some instances. One way to reproduce it is to scroll the Spring LDAP reference [1] TOC down and then back up most the way, I then click on the "Preface" link. Part of the TOC disappears. If I use Chrome 30.0.1599.101 on OSX the issue occurs. I have attached a screenshot below.

I am unable to reproduce on Firefox for OSX, Chrome 30.0.1599.114 for Ubuntu, or Firefox for Ubuntu. I am also unable to reproduce this with the Spring Security reference which uses the default styling from 0.1.3. I wonder if the issue is partially due to the fact the style is embedded into the document with 0.1.4 and externalized in 0.1.3?

Is this something that is known? Am I doing something wrong? If not, is this something that should be addressed?

[1] http://docs.spring.io/spring-ldap/docs/current-SNAPSHOT/reference/
[2] http://docs.spring.io/spring-security/site/docs/current-SNAPSHOT/reference/html5/

Thanks!
Rob

mojavelinux

Oct 25, 2013; 9:59pm

Re: html5 TOC disappears with default 0.1.4 styles

Administrator

2681 posts

Rob,

That sounds a lot like a browser rendering bug. I don't think you are doing anything wrong. You might be right that it depends on whether the stylesheet is embedded or linked, or that's just a complete coincidence.

The way in which we make the sidebar is a bit, well, klugy. I did my best to avoid adding any extra HTML to the output. From a recent issue report, I'm now seeing that we have problems on IE 10 as well. We could attempt to debug the problems, or we could switch to a more well-tested approach. Cardinal CSS [1], for instance, has a nice sidebar implementation that we could adopt knowing that they've worked out the kinks.

If you want to chase down the issue with the current sidebar, I would suggest hitting up the Chrome issue tracker as it could indicate a wider issue that they have.

-Dan

[1] http://cardinalcss.com/

On Wed, Oct 23, 2013 at 3:46 PM, rwinch [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I noticed that when using the default styling from 0.1.4 with the html5 backend, the TOC can partially disappear under some instances. One way to reproduce it is to scroll the Spring LDAP reference [1] TOC down and then back up most the way, I then click on the "Preface" link. Part of the TOC disappears. If I use Chrome 30.0.1599.101 on OSX the issue occurs. I have attached a screenshot below.

I am unable to reproduce on Firefox for OSX, Chrome 30.0.1599.114 for Ubuntu, or Firefox for Ubuntu. I am also unable to reproduce this with the Spring Security reference which uses the default styling from 0.1.3. I wonder if the issue is partially due to the fact the style is embedded into the document with 0.1.4 and externalized in 0.1.3?

Is this something that is known? Am I doing something wrong? If not, is this something that should be addressed?

[1] http://docs.spring.io/spring-ldap/docs/current-SNAPSHOT/reference/
[2] http://docs.spring.io/spring-security/site/docs/current-SNAPSHOT/reference/html5/

Thanks!
Rob

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/html5-TOC-disappears-with-default-0-1-4-styles-tp856.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

Dan Allen | http://google.com/profiles/dan.j.allen