我在使用 Herman for sassDocs 的 json 导出功能构建色样时遇到问题

Question

问题：我有一个 sass-to-json.css，其中唯一认为打印的是从 @include herman-export; 导出的评论。我是否需要手动取消注释 JSON and/or 重命名文件以具有 json 扩展名？

我的 .sassdocrc 文件：

dest: public/docs
theme: node_modules/sassdoc-theme-herman
verbose: true

herman:
  sass:
    sass.jsonfile: public/json/sass-to-json.css

然后我的 sass-to-json.scss 文件只有两个存在 herman 代码的导入和导出 mixin。（我不确定是否所有这些都是必要的，但 json 编译正确）

@import "utilities";
@import "base/colors";
@include herman-export;

编译为 sass-to-json.css。我已尝试删除评论以使其有效 json 并将文件重命名为 .json。但我得到了相同的结果，即 herman 编译了没有样本的页面，并且没有错误：

/*! json-encode: {"colors": {"theme": {"shade": "#16161e", "tint": "#f0f0fb", "dark-grey": "#393946", "grey": "#7d8c9c", "white": "#fff", "black": "#000", "blue": "#0c55b7", "green": "#3fbb26", "yellow": "#e7b60a", "red": "#e71b46"}}} */

我的 colors.scss 文件的相关位：

/// @group color
/// @colors theme
$theme: (
  'shade': #16161e,
  'tint': #f0f0fb,
  'dark-grey': #393946
);

@include herman-add('colors', 'theme', $theme);

Answer 1

您的 Sass（以及 herman-add 和 herman-export 的用法）看起来很棒！无需弄乱生成的 sass-to-json.scss 文件的内容；它应该是一个有效的 Sass 评论，Herman 自己会负责将其解析为有效的 JSON.

文档有点不清楚，但这里的相关选项是 jsonfile 嵌套在 sass 选项下，而不是 sass.jsonfile。例如：

dest: public/docs
theme: herman
verbose: true

herman:
  sass:
    jsonfile: public/json/sass-to-json.css

（注意你也可以只指定herman作为主题，SassDoc会自动寻找node_modules/sassdoc-theme-herman。）

我在使用 Herman for sassDocs 的 json 导出功能构建色样时遇到问题

I'm having trouble building color swatches using the json export feature of Herman for sassDocs

sass

gulp-sass

herman