SassDoc / sassdoc

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

[ERROR] Could not find any executable for "sass-convert". Operation Aborted. #563

Open flesage-000 opened 2 years ago

flesage-000 commented 2 years ago

Hello,

I'm new to sass, so sorry if question is simple.

When i run sassDoc using CLI: sassdoc ./src/assets/styles/ --config ./src/sassdoc_config.json The response is:

[ERROR] Could not find any executable for "sass-convert". Operation Aborted.

I'm surprise by this cause, sass already work in my project. I just want to generate doc.

I use:

Note: if i simply run sassdoc ./src/sassdoc_config.json its works. Doc is empty and not in right directory, But it works oO.

What can i do?

Thx.

pascalduez commented 2 years ago

Hi @flesage-000,

the .sass syntax support is provided by https://github.com/SassDoc/sass-convert which:

  1. Is deprecated, we don't want nor have time to maintain that kind of thing.
  2. Is only available for Ruby Sass, not Dart Sass. (I don't think there was alternatives to Ruby Sass sass-convert provided after).
flesage-000 commented 2 years ago

Hi @pascalduez ,

Thanks for the answer.

I don't really undertsand, I saw sass-convert was unmaintained. i tried to install it, i don't remember what happened, just i uninstall it fastly cause it don't work (as expected).

I tried to uninstall to reinstall using

I don't see what i'm doing wrong :/, probably cause the project was created with sass option.

Thanks.

pascalduez commented 2 years ago

You shouldn't have to install sass-convert (npm package) independently, it's already a dependency of sassdoc.
What you really need for it to work, is the Ruby Sass (unmaintained) sass-convert executable in your path, installed with the various Ruby install methods, bundler or else.

The sass package on npm is the Dart version of Sass, and don't provide a sass-convert binary, so won't work.