sassdoc icon indicating copy to clipboard operation
sassdoc copied to clipboard

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

Open flesage-000 opened this issue 3 years ago • 4 comments
trafficstars

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.

flesage-000 avatar Nov 24 '21 18:11 flesage-000

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).

pascalduez avatar Nov 26 '21 08:11 pascalduez

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.

flesage-000 avatar Nov 26 '21 16:11 flesage-000

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.

pascalduez avatar Dec 02 '21 09:12 pascalduez