sassdoc
sassdoc copied to clipboard
[ERROR] Could not find any executable for "sass-convert". Operation Aborted.
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.
Hi @flesage-000,
the .sass syntax support is provided by https://github.com/SassDoc/sass-convert which:
- Is deprecated, we don't want nor have time to maintain that kind of thing.
- Is only available for Ruby Sass, not Dart Sass. (I don't think there was alternatives to Ruby Sass sass-convert provided after).
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) andnpm 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 -vandsassdoc -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.
- and receive
I don't see what i'm doing wrong :/, probably cause the project was created with sass option.
Thanks.
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.