jbt / docker

Documentation generator
http://jbt.github.com/docker
MIT License
233 stars 56 forks source link

presence of "UTF-8" string in SCSS causes parsing issue #27

Closed sndrs closed 11 years ago

sndrs commented 11 years ago

simply including that string (e.g. in @charset "UTF-8";) seems to result in a parsing error, with output like

"//----{DIVIDER}----"

in the docs...

sndrs commented 11 years ago

hmm, no sorry, it's not that. will try and pin it down...

jbt commented 11 years ago

might it be something like #14 where it gets confused by inconsistent indentation? Thinking about it, SASS/SCSS might get confused if you have a comment in the middle of a rule at different indentation. It's been on my todo list for a while but I haven't had a chance to look at it properly yet.

sndrs commented 11 years ago

it's SCSS, so should indenting shouldn't be a problem?

it appears be any string beginning with @ that isn't part of sass/scss. e.g. @import is fine. @; doesn't cause problems, but @x; does, for instance. Screen Shot 2013-02-28 at 14 36 58 Screen Shot 2013-02-28 at 14 36 48

could that be a jsDoc thing?

jbt commented 11 years ago

It doesn't looks like a jsDoc thing, but that is very weird. Looks like pygments doesn't interpret the divider thing as a comment (even though as far as I know that's valid SCSS comment syntax). I'll try and figure a workaround.

jbt commented 11 years ago

Ok I'm 99% sure that's fixed it now. Weird one, that. Feel free to reopen if I've missed something

sndrs commented 11 years ago

bingo! thanks so much. docker is so good...