Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Как использовать bem-lib-site? #1083

Open
ilyar opened this issue Jul 31, 2016 · 44 comments
Open

Как использовать bem-lib-site? #1083

ilyar opened this issue Jul 31, 2016 · 44 comments

Comments

@ilyar
Copy link

ilyar commented Jul 31, 2016

@tadatuta рассказал как использовать автоматическую генерацию актуальной документации для модульного фронтенда, презентация.

Осталось не понятно, как это использовать. Покажите минимальный кейс использования bem-lib-site и расскажите где читать про остальное.

UPD

git clone git@github.com:ilyar/bem-lib-site-test.git
cd bem-lib-site-test && npm install
npm test
open docs/index.html

Работает, хак внутри (может быть он уже не нужен).
Сборку можно посмотреть тут ilyar.github.io/bem-lib-site-test/.

UPD 1/1/17

Убрал один хак ilyar/bem-lib-site-test@a18e484, добавил автотест генерации доки:

*nix status
windows Status

@tavriaforever tavriaforever changed the title Как использовать bem-lib-site? Как использовать bem-lib-site? Jul 31, 2016
@tavriaforever tavriaforever changed the title Как использовать bem-lib-site? Как использовать bem-lib-site? Jul 31, 2016
@tadatuta
Copy link
Member

Привет!

Пока почитать, к сожалению, негде — документация в процессе написания.

Минимальный кейс использования предполагается такой:

  1. Поставить bem-lib-site
  2. Создать конфиг .bemrc, в котором описать собираемую библиотеку (пример).
  3. Вызвать бинарник bem-lib-site с указанием пути к собираемой библиотеке: bem-lib-site bem-core

Если ничего в процессе не взорвалось, то на выходе в папке, указанной в конфиге как outputFolder появится куча файлов, среди которых будут папки для каждого собираемого языка и в них папки с документацией по каждому блоку. Это дело должно быть можно открывать хоть с файловой системы, хоть паблишить на gh-pages.

Если что-то идет не так (а такое вполне возможно на данном этапе) — заводи issues, буду чинить.

@ilyar
Copy link
Author

ilyar commented Jul 31, 2016

npm i -g bem-lib-site
cd docstest
cat .bemrc
module.exports = {
    modules: {
        'bem-tools': {
            plugins: {}
        },
        'bem-lib-site-data': {
            tempFolder: 'tmp',
            outputFolder: 'output',
            langs: ['ru', 'en'],
            platforms: { // TODO: make it really optional
                'desktop': ['common', 'deskpad', 'desktop'],
                'touch-phone': ['common', 'touch', 'touch-phone'],
                'touch-pad': ['common', 'deskpad', 'touch', 'touch-pad']
            },
            libs: {
                'bem-components': {
                    langs: ['ru', 'en'],
                    github: {
                        url: 'github.com',
                        user: 'bem',
                        repo: 'bem-components',
                        defaultBranch: 'v3'
                    }
                }
            }
        }
    }
};
bem-lib-site .
TypeError: Cannot read property 'libs' of undefined
    at Object.<anonymous> (/home/ilyar/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/bem-lib-site-data/.enb/make.js:15:21)
    at Module._compile (module.js:413:34)
    at Object.Module._extensions..js (module.js:422:10)
    at Module.load (module.js:357:32)
    at Function.Module._load (module.js:314:12)
    at Module.require (module.js:367:17)
    at require (internal/module.js:16:19)
    at module.exports.inherit.init (/home/ilyar/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/enb/lib/make.js:90:17)
    at module.exports (/home/ilyar/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/enb-magic-platform/lib/apply.js:25:25)
    at Object.module.exports [as runTasks] (/home/ilyar/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/enb-magic-platform/lib/api/run-tasks.js:28:12)

Заводить issues или я неправильно понял?
Про .bemrc тоже еще ничего почитать?

@tadatuta
Copy link
Member

Про .bemrc см. https://github.com/bem-sdk/bem-config и, если нужны подробности, https://github.com/tadatuta/betterc

На баг посмотрю, отпишусь, если что-то выясню.

@tadatuta
Copy link
Member

tadatuta commented Sep 7, 2016

@ilyar а что лежит в этот момент в docstest? если там пусто, то ничего сгенерироваться и не может. папка, на которую натравливается bem-lib-site обязана быть «полноценной» библиотекой блоков (у нее должен быть package.json с указанием имени и в конфиге .bemrc должно что-то про эту библиотеку.

@ilyar
Copy link
Author

ilyar commented Sep 7, 2016

@tadatuta Папка действительно пуста это воспроизводится по сценарию из bem-lib-site#1. Осознав что папка должна быть полноценной получается такой кейс:

# 1. инструмент
npm i -g bem-lib-site

# 2. среда
rm -fr docstest && mkdir docstest && cd $_

# 3. проект
npm init -f

# 4. конфигурация
echo "module.exports = {
    'root': true,
    'levels': {
        'blocks': {
            'scheme': 'nested',
            'default': true
        }
    },
    modules: {
        'bem-tools': {
            plugins: {}
        },
        'bem-lib-site-data': {
            tempFolder: 'tmp',
            outputFolder: 'distr/docs',
            langs: ['ru', 'en'],
        }
    }
};" | tee .bemrc

# 5. папки
mkdir -p blocks/b1 distr/docs

# 6. файлы
echo "# Block b1" | tee blocks/b1/b1.{en,ru}.md
echo ".b1 {}" | tee blocks/b1/b1.css

# 7. проверяем
tree
.
├── blocks
│   └── b1
│       ├── b1.css
│       ├── b1.en.md
│       └── b1.ru.md
├── distr
│   └── docs
│       └── data
└── package.json

5 directories, 4 files

# 8. генерация документации
bem-lib-site .
/home/user/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/bem-lib-site-data/index.js:36
    process.env.BEM_TEMPLATE_ENGINE = libConfig.templateEngine || config.templateEngine;
                                               ^

TypeError: Cannot read property 'templateEngine' of undefined
    at module.exports (/home/user/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/bem-lib-site-data/index.js:36:48)
    at module.exports (/home/user/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/index.js:10:12)
    at Object.<anonymous> (/home/user/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/bin/bem-lib-site:3:14)
    at Module._compile (module.js:413:34)
    at Object.Module._extensions..js (module.js:422:10)
    at Module.load (module.js:357:32)
    at Function.Module._load (module.js:314:12)
    at Function.Module.runMain (module.js:447:10)
    at startup (node.js:139:18)
    at node.js:999:3

Что дорожно быть в templateEngine?

@tadatuta
Copy link
Member

tadatuta commented Sep 7, 2016

На самом деле libConfig должен быть объектом, а если templateEngine не окажется, то там сработает фоллбек. Оно сейчас падает, т.к. не намайнился конфиг для либы.

Но в такой постановке проблема понятна, я добавлю еще фоллбеков, чтобы оно могло либо что-то осмысленное в консоль писать, либо даже какой-то полезный результат генерить.

Кроме того я начал пилить тесты, так что будет что использовать в качестве примера.

@ilyar
Copy link
Author

ilyar commented Sep 8, 2016

Работает, если в конфиг добавить:

libs: {
    docstest: {},
}

в итоге:

# 4. конфигурация
echo "module.exports = {
    'root': true,
    'levels': {
        'blocks': {
            'scheme': 'nested',
            'default': true
        }
    },
    modules: {
        'bem-lib-site-data': {
            outputFolder: 'distr/docs',
            langs: ['ru', 'en'],
            libs: {
                docstest: {},
            },
        }
    }
};" | tee .bemrc

@ilyar
Copy link
Author

ilyar commented Sep 8, 2016

@tadatuta

При повторном запуске bem-lib-site . получаю ошибку:

Error: Cannot delete files/folders outside the current working directory. Can be overriden with the `force` option.
    at safeCheck (/home/user/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/del/index.js:19:9)
    at /home/user/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/del/index.js:35:5
    at Array.map (native)
    at /home/user/.nvm/versions/node/v5.5.0/lib/node_modules/bem-lib-site/node_modules/del/index.js:33:28

Вероятно надо https://github.com/bem-site/bem-lib-site-view/pull/8/files

Обходное решение:

# 8. генерация документации
rm -rf distr/docs/** && bem-lib-site .

@tadatuta
Copy link
Member

tadatuta commented Sep 8, 2016

Да, уже влили (см. bem-site/bem-lib-site-data#10), но еще нет версии с правками.

@ilyar
Copy link
Author

ilyar commented Sep 8, 2016

@tadatuta для ошибки: "TypeError: Cannot read property 'templateEngine' of undefined" уже есть решение bem-site/bem-lib-site-data@af09ab0 надо только выпустить новую версию bem-lib-site-data и bem-lib-site https://github.com/bem-site/bem-lib-site/blob/master/package.json#L19

@tadatuta
Copy link
Member

tadatuta commented Sep 8, 2016

я хочу еще несколько фиксов сделать до выпуска

@ilyar
Copy link
Author

ilyar commented Sep 8, 2016

Ясно, спасибо.

Есть еще один не понятный моменте, bem-lib-site генерирует следующие:

tree distr/docs/
distr/docs/
├── data
│   └── docstest
│       ├── bower.json
│       ├── data.json
│       └── desktop.docs
│           └── b1
│               ├── b1.bemdecl.js
│               ├── b1.data.json
│               ├── b1.en.doc.html
│               ├── b1.en.md
│               ├── b1.jsdoc.html
│               ├── b1.jsdoc.json
│               ├── b1.jsdoc.md
│               ├── b1.meta.json
│               ├── b1.ru.doc.html
│               ├── b1.ru.md
│               └── b1.source-files.json
└── docstest
    ├── en
    │   ├── desktop
    │   │   └── b1
    │   │       └── index.html
    │   ├── index.css
    │   └── index.js
    └── ru
        ├── desktop
        │   └── b1
        │       └── index.html
        ├── index.css
        └── index.js

11 directories, 19 files

Другими словами получаем страничку документации по каждому блоку.

@tadatuta Не хватает индекса, bem-lib-site это умеет или надо что-то придумывать? Пожалуйста подскажи, как это можно сделать.

@tadatuta
Copy link
Member

tadatuta commented Sep 8, 2016

По задумке индексом должен быть отрендеренный README[.lang].md из корня библиотеки, но сейчас это не реализовано.

@ilyar
Copy link
Author

ilyar commented Sep 8, 2016

Понял, спасибо.

Выражу личное мнение, думаю, будет удобно следующие поведение:

  • язык документации по умолчанию (когда в конфиге отсутствует langs) , данные для него будут браться из файла технологии без суффикса т.е. project/blocks/b1/b1.md и project/readme.md;
  • readme.md из корня библиотеки должен быть регистронезависимый;
  • индекс документации это список блоков дополненный информацией из корневого readme.md это может быть опциональным поведением.

Еще уточнение по использованию, каким образом на данный момент можно вмешаться в формирование конечного результата? Хочу добавить индекс.

@vithar
Copy link

vithar commented Sep 8, 2016

Я в процессе фикса индекса, changelog и migration для библиотеки

@tadatuta
Copy link
Member

tadatuta commented Sep 8, 2016

@ilyar можно заводить issues в соответствующих репозиториях и после обсуждения брать в работу, если есть желание/возможность. буду очень благодарен!

@ilyar
Copy link
Author

ilyar commented Sep 8, 2016

@kmadorin
Copy link

Повторил все шаги выше. Но выдается ошибка Cannot read property 'outputFolder' of undefined
at Object. (/usr/local/lib/node_modules/bem-lib-site/node_modules/bem-lib-site-view/lib/process-blocks.js:14:26).

.bemrc в корне проекта лежит, все ок. Может изменился способ задания конфига?

@kompolom
Copy link

Очень уж хочется попробовать, но за два подхода тулза не взлетела...

@ilyar
Copy link
Author

ilyar commented Nov 14, 2016

@kompolom @kmadorin

git clone git@github.com:ilyar/bem-lib-site-test.git
cd bem-lib-site-test && npm install
npm test
open docs/index.html

Работает, хак внутри (может быть он уже не нужен).

@ilyar
Copy link
Author

ilyar commented Nov 14, 2016

Сборку можно посмотреть тут ilyar.github.io/bem-lib-site-test/.

@kompolom
Copy link

@ilyar, Спасибо за демку, завелось наконец-то! У меня только jsdoc собрался. md файлы не подключились.

@kompolom
Copy link

@ilyar Попробовал снова собрать доки. Все сломалось!

@kompolom
Copy link

Data was collected at /home/jenik/myprojects/bem-lib-site-test/docs/data/.-
module.js:327
    throw err;
    ^

Error: Cannot find module '/home/jenik/myprojects/bem-lib-site-test/docs/data/data'

@Realetive
Copy link

@kompolom, у меня тоже сборка развалилась после обновления на bem-core#v4.
Сегодня @tadatuta в Телеграмме говорил, что там пока много «ненадёжностей» и грозился в ближайшее время (сегодня) «влить туда пачку фиксов и в перспективе планируют переводить на v4».

@vithar
Copy link

vithar commented Dec 12, 2016

Посмотрите внимательно на .bemrc, там изменился формат.

Сейчас так:

module.exports = {
    root: true,

    modules: {
        'bem-lib-site': {
            langs: ['uk', 'ru', 'en'],

            data: {
                tempFolder: 'tmp',
                outputFolder: '.cache/bem-lib-site-data'
            },
            view: {
                outputFolder: 'bem-lib-site-view-output'
            },
            platforms: { // TODO: make it really optional
                'desktop': ['common', 'deskpad', 'desktop', 'test'],
                'touch-phone': ['common', 'touch', 'touch-phone', 'test'],
                'touch-pad': ['common', 'deskpad', 'touch', 'touch-pad', 'test']
            },
            libs: {
                'bem-components': {
                    langs: ['uk', 'ru', 'en'],
                    github: {
                        url: 'github.com',
                        user: 'bem',
                        repo: 'bem-components',
                        defaultBranch: 'v3.0.0'
                    }
                }
            }
        }
    }
};

@vithar
Copy link

vithar commented Dec 12, 2016

Может в этом дело.

@kompolom
Copy link

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

@kompolom
Copy link

kompolom commented Dec 12, 2016

@vithar Вот сгенерировал я данные в папку
cache/bem-lib-site-data
запускаю bem-lib-site-view cache
и получаю:

module.js:327
    throw err;
    ^

Error: Cannot find module '/home/jenik/myprojects/ap-components/cache/data'
    at Function.Module._resolveFilename (module.js:325:15)
    at Function.Module._load (module.js:276:25)
    at Module.require (module.js:353:17)
    at require (internal/module.js:12:17)
    at module.exports (/home/jenik/myprojects/ap-components/node_modules/bem-lib-site-view/lib/prepare-data.js:27:19)
    at module.exports (/home/jenik/myprojects/ap-components/node_modules/bem-lib-site-view/index.js:21:16)
    at Object.<anonymous> (/home/jenik/myprojects/ap-components/node_modules/bem-lib-site-view/bin/bem-lib-site-view:3:14)
    at Module._compile (module.js:409:26)
    at Object.Module._extensions..js (module.js:416:10)
    at Module.load (module.js:343:32)

Никак не пойму что за модуль оно там найти хочет.
Вот что нагенерил bem-site-data:

20:29 jenik@baranov-pc:~/myprojects/ap-components$ tree -L 4 cache/
cache/
└── bem-lib-site-data
    └── ap-components-1.1.0
        ├── bower.json
        ├── data.json
        ├── desktop.docs
        │   ├── accordion
        │   ├── alert
        │   ├── animate
        │   ├── attach
        .... // тут еще куча папок соотв блокам
        │   ├── widget
        │   └── widget-area
        └── readme.md

52 directories, 3 files

Ну ладно, может вложенность увеличилась, пробую запускать указываю путь до библиотеки, ошибка поменялась:

 bem-lib-site-view cache/bem-lib-site-data/ap-components-1.1.0/
[TypeError: Path must be a string. Received undefined]

@vithar
Copy link

vithar commented Dec 12, 2016

Оно ищет data.json.

Так должно работать: bem-lib-site-view cache/bem-lib-site-data/ap-components-1.1.0

@ilyar
Copy link
Author

ilyar commented Dec 12, 2016

@kompolom @Realetive @vithar во всем виноват этот коммит bem-site/bem-lib-site-data@1c7f630

@kompolom
Copy link

@ilyar Виноват, но не во всем

bem-lib-site-view cache/bem-lib-site-data/ap-components-1.1.0/
[TypeError: Path must be a string. Received undefined]

@ilyar
Copy link
Author

ilyar commented Dec 12, 2016

Согласен, поторопился с выводами, проблема фиксится так: ilyar/bem-lib-site-test@c77da0d

Обновленное демо https://ilyar.github.io/bem-lib-site-test/ и о счастье маркдаун теперь рендерится!

@vithar спасибо за обновление.

@ilyar
Copy link
Author

ilyar commented Dec 12, 2016

Все таки пришлось откатить bem-site/bem-lib-site-data до 7f13647f теперь Build Status на мастере валится https://travis-ci.org/ilyar/bem-lib-site-test/jobs/183339355#L1298

Пока оставлю так.

@tadatuta
Copy link
Member

Ребята, спасибо, что вы все это терпите.
Мы сегодня в очередной раз не успели, но у нас действительно большая пачка правок лежит локально. Нужно разобрать по коммитам и запушить.
Впрочем, даже после влития считать bem-lib-site стабильным будет преждевременно.

@kompolom
Copy link

Ждем с нетерпением

@lilliputten
Copy link

Добрался до попыток привинчивания bem-lib-site. Третий день экспериментов с практически нулевым результатом.

Использовал в качестве отправной точки bem-lib-site-test. Получается, что без изменений либо кода пакетов (bem-lib-site*), либо имеющегося в репозитории конфига, ничего вообще не работает.

Старался обходиться минимальными правками и только в конфиге (хотя по началу делал всякие допроверки вроде ( libConfig && libConfig.templateEngine ) || config.templateEngine или config.libs && config.libs[lib] || {}, потом вроде научился обходиться добавлением параметров конфига. (В общем, самое безобразное, что к имеющимся модулям не прилагается внятного how-to или примера рабочего конфига.)

Прошу помочь с настройкой или ткнуть в рабочий кейс или правильный образец .bemrc для старта.

Сейчас bem-lib-size . проходит без ошибок, на выходе получаю два файла (find out -type f):

out/data/index.css
out/data/index.js

При этом в папке ~/npm/node_modules/bem-lib-site/node_modules/bem-lib-site-data/tmp/data/desktop.docs/b1/ получаю набор файлов:

b1.bemdecl.js
b1.data.json
b1.en.md
b1.en.doc.html
b1.jsdoc.html
b1.jsdoc.json
b1.jsdoc.md
b1.meta.json
b1.ru.md
b1.ru.doc.html

-- в котором все *.{html,md} файлы пустые.

Также создаётся файл ~/npm/node_modules/bem-lib-site/node_modules/bem-lib-site-data/out/data/data/readme.md с копией README из самого bem-lib-site-data.

Конфиг сейчас (в последних экспериментах) такой:

module.exports = {
    root : true,
    levels : {
        'blocks' : {
            scheme : 'nested',
            default : true,
        },
    },
    modules : {
        'bem-lib-site-data' : {
            tempFolder : 'out/temp',
            outputFolder : 'out/data',
            libs : {
                '.' : {
                    templateEngine : 'BEMHTML',
                },
            },
        },
    },
};

Вывод команды bem-lib-site .:

16:28:37.113 - build started
16:28:37.159 - [rebuild] [tmp\data\desktop.docs\b1\b1.bemdecl.js] file-provider
16:28:37.159 - [rebuild] [tmp\data\desktop.docs\b1\b1.levels] levels
16:28:37.159 - [rebuild] [tmp\data\desktop.docs\b1\b1.files] files
16:28:37.175 - [rebuild] [tmp\data\desktop.docs\b1\b1.dirs] files
16:28:37.175 - [rebuild] [tmp\data\desktop.docs\b1\b1.meta.json] meta-json
16:28:37.191 - [rebuild] [tmp\data\desktop.docs\b1\b1.ru.doc.html] doc-html-i18n
16:28:37.191 - [rebuild] [tmp\data\desktop.docs\b1\b1.en.doc.html] doc-html-i18n
16:28:37.191 - [rebuild] [tmp\data\desktop.docs\b1\b1.en.md] md-i18n
16:28:37.191 - [rebuild] [tmp\data\desktop.docs\b1\b1.ru.md] md-i18n
16:28:37.191 - [rebuild] [tmp\data\desktop.docs\b1\b1.jsdoc.json] jsdoc-json
16:28:37.206 - [rebuild] [tmp\data\desktop.docs\b1\b1.jsdoc.md] jsdoc-to-md
16:28:37.206 - [rebuild] [tmp\data\desktop.docs\b1\b1.data.json] data-json
16:28:37.222 - [rebuild] [tmp\data\desktop.docs\b1\b1.jsdoc.html] html-from-md
16:28:37.222 - build finished - 1077ms
Data was collected at {...}\out\data\data

Тестируется на Windows7, node@v6.10.0.

bem-lib-site установлен глобально:

`-- bem-lib-site@0.1.2
  +-- bem-lib-site-data@0.0.7
  `-- bem-lib-site-view@0.0.5

@ilyar
Copy link
Author

ilyar commented Mar 1, 2017

Сумбурно как то, давай по порядку, что из этого сценария не работает?

git clone git@github.com:ilyar/bem-lib-site-test.git
cd bem-lib-site-test && npm install
npm test
open docs/index.html

@lilliputten
Copy link

lilliputten commented Mar 2, 2017

@ilyar Это работает, спасибо. Раньше пробовал в основном через bem-lib-site. Это, видимо, какая-то проблема с установкой bem-lib-site-view в автоматическом режиме?

Попробую плясать от этой конфигурации.

Чуть вопросов:

  1. Реально ли запускать генерацию документации из enb make, а не через magic-platform? (UPD) Кажется, то что мне нужно, это bem-lib-site-data/.enb/make.js. Попробую вытащить конфиг оттуда.

  2. Есть ли возможность подключать свои плагины -- по аналогии с jsdoc? (Напр., для предпарсинга/модификации описаний сущностей?) В конфиге видал опцию, но не видел рабочего примера. Есть ли что-то в описаниях/кейсах?

  3. (UPD) Как можно в levels в .bemrc указать, что папка с исходным кодом блоков находится не в blocks, а, напр., в blocks/group? (UPD) Так понимаю, что надо каким-то образом объяснить enb-magic-platform, что надо искать не pathToLib/{*.blocks,blocks}, а смотреть ещё и в самой папке pathToLib? Как это можно сделать? (UPD) Глупый вопрос, вычёркиваю, буду решать через (п.1).

@ilyar
Copy link
Author

ilyar commented Mar 4, 2017

  1. Вопрос не понятен. В общем ответ: да. На вопросы вроде: "Реально ли..." в области IT ответ почти всегда: да возможно.
  2. Не знаю не следовал.

@ilyar
Copy link
Author

ilyar commented Aug 13, 2017

@tadatuta какие есть обновления по инструменту (где почитать)?

@lilliputten
Copy link

Подскажите, изменилась ли ситуаиция за прошедшее время? Или так же надо использовать бубны для запуска докогенератора?

Собственные эксперименты лежат до сих в наполовину рабочем виде, к рабочим проектам подключать так пока руки не дошли. Сейчас начинать с них? Или можно попробовать какой-то более гуманный способ? (Наск. помню, были ещё доп. сложности из-за моего не оч. стандартного способа хранения блоков в проекте...)

@qfox
Copy link

qfox commented Nov 20, 2017

Привет.

Я не знаю судьбу bem-lib-site-data, но мы сейчас пробуем с другой стороны зайти к снаряду в https://github.com/agrarium/agrarium

Это прототип, но нам нравится как идут дела.
У нас там многослойная схема с адаптерами-трансформерами, которая на выходе должна давать сводную информацию о нужных компонентах.

Пока не нравится, что нет толковых парсеров для кода и jsdoc, и много руками надо будет писать) Но это лирика.
Сейчас собираем тесткейсы для парсинга js и jsdoc, в планах придумать API для плогинов.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

10 participants