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

[flesage-000]

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:

• Sass: 1.39.2 compiled with dart2js 2.14.1
• SassDoc: 2.7.3
• Visual Studio Code:
• • Version : 1.62.3 (user setup)
• • Commit : ccbaa2d27e38e5afa3e5c21c1c7bef4657064247
• • Date : 2021-11-17T08:11:14.551Z
• • Electron : 13.5.2
• • Chrome : 91.0.4472.164
• • Node.js : 14.16.0
• • V8 : 9.1.269.39-electron.0
• • OS : Windows_NT x64 10.0.19043
• Angular:
  Angular CLI: 12.2.13
  Node: 16.9.1 (Unsupported)
  Package Manager: npm 7.21.1
  OS: win32 x64
  Angular: 12.2.13
  ... animations, cli, common, compiler, compiler-cli, core, forms
  ... platform-browser, platform-browser-dynamic, router
  @angular-devkit/architect 0.1202.13
  @angular-devkit/build-angular 12.2.13
  @angular-devkit/core 12.2.13
  @angular-devkit/schematics 12.2.13
  @schematics/angular 12.2.13
  rxjs 6.6.7
  typescript 4.3.5

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]

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]

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

• npm uninstall sass -g (sass folder stay in 'node_modules folder oO) and npm uninstall sassdoc -g (sassdoc folder removed from 'node-modules' folder)
• Launch my project with ng serve -o, and surprise it worls oO (but ok let' continue)
  • My styles works fine, class are combines as well...
  • Is it cause when i create project i used 'sass' option ??
• Check version of sass -v and sassdoc -v,
  • Commands not exists.
• I reinstall globally sass (node js cli part) and sassdoc (using this)
• run sassdoc ./src/assets/styles/ --config ./src/sassdoc_config.json
  • and receive » [ERROR] Could not find any executable for "sass-convert". Operation Aborted.

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

Thanks.

[pascalduez]

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.

[rastislavcore]

Why the project is built on deprecated Ruby Sass (unmaintained) library? Any plans to change it?