alan-if / alan-docs

Alan IF Documentation Project

Home Page:https://git.io/alan-docs

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Sass Themes: Fix Operators Colouring

tajmone opened this issue · comments

If you look at ALAN Manual » Creating Classes and Instances, you can see that the code template examples don't look good:

The <instance identifier> IsA <class identifier> ...

The < and > are render in a very light Cyan colour that strides with the light background. I need to check and fix all the CSS themes (default and others) to ensure they are rendered properly.

  • Add test coverage in _dev/styles-tests/ to check and fix how operators are coloured in Sass themes:
    • Highlight:
      • Default.
      • Library theme.
      • Example theme.
    • highlight.js:
      • Default.
      • Library theme.
      • Example theme.
    • Rouge:
      • Default.
      • Library theme.
      • Example theme.

Nested CSS!

It looks like the problem is due to added italic, which causes the Rouge CSS Theme classes to end up nested in a <em> tag:

<em><span class="o">&lt;</span><span class="n">instance</span>

This might be easy to fix in the Sass sources by adding an * before the span classes, to ensure they match any level of nesting.