search

SassDoc / sassdoc

Release the docs!
http://sassdoc.com
MIT License
1.41k stars 56 forks source link

Unable to document @font-face #509

Open Snugug opened 7 years ago

Snugug commented 7 years ago

I'm distributing font declerations and I'd like them documented. I would like to see SassDoc document the following:

/// Basic Font Family
@font-face {
  font-family: 'My Font';
  src: ulr('font/path.woff2') format('woff2');
  font-weight: 400;
  font-style: normal;
}

Instead of pulling it out and documenting it like everything else, it simply is ignored entirely.

pascalduez commented 7 years ago

Hi,

this used to be somehow intended, as for quite some time we didn't wanted to support CSS documenting. But we now allows documenting css selector, or in other terms anything not Sass should fallback to the css type. Sadly css at-rules are wrongly catched and then ignored, that needs to be fixed. Same applies for @keyframes or any other css at-rules.

Will try to look at it over the weekend.

steffenpedersen commented 5 years ago

Hi @pascalduez, is this still an issue?

pascalduez commented 5 years ago

Hey @steffenpedersen, yes I think so. We should really allow this.

blackfalcon commented 5 years ago

Wow ... 2019 and this is still an issue?

pascalduez commented 5 years ago

@blackfalcon No doubt your PR will fill this antediluvian blank :wink: