Как использовать SassDoc в качестве парсера для одного файла без генерации полных файлов документации

Вопрос касается пакета http://sassdoc.com/

Я хотел бы проанализировать каждый файл *.scss в папке./source, но вместо создания папки sassdoc я хотел бы создать частичный html для каждого проанализированного файла. Например:

parse: variables.scss и получить variables.html без заголовка страницы, боковая панель - чистый контент, даже без тегов html и body.

Мой текущий код:

var gulp = require('gulp'),
    sassdoc = require('sassdoc');

var paths = {
  scss: [
    'source/**/*.scss'
  ]
};

gulp.task('sassdoc', function () {
  console.log("sassdoc task finished");
  return gulp.src(paths.scss)
    .pipe(sassdoc());
});

1 ответ

Это невозможно с темой по умолчанию SassDoc. Таким образом, вам нужно создать свою собственную тему, чтобы добиться этого. http://sassdoc.com/using-your-own-theme

Каждому предмету дается file ключ в результирующих данных, так что я бы использовать это и сделать некоторые слияния.

Это может в конечном итоге в sassdoc-extra пользовательский фильтр. http://sassdoc.com/extra-tools

РЕДАКТИРОВАТЬ:
На самом деле ваш вопрос вводит в заблуждение, вы хотите variable.html файл, но без html...

Если вам нужны только необработанные данные JSON из SassDoc без какой-либо обработки тем, parse метод это то, что вы ищете.

Но опять же, если вы не вызовете SassDoc для каждого файла в отдельности, вы соберете все файлы вместе, то есть постобработка данных, чтобы разделить их, поэтому пользовательская тема (даже без вывода html) - это путь.

Другие вопросы по тегам