Чистые файлы уценки к генератору HTML - PullRequest
0 голосов
/ 07 ноября 2018

Мы пытаемся преобразовать наши файлы документации (md-файлы) в статический веб-сайт.

Мы искали Хьюго, Металсмита и другие генераторы статических сайтов.

Но мы чувствуем, что все они заставляют нас добавлять пользовательскую разметку или множество дополнительных метаданных (frontmatter), которые нам не очень нужны.

F. ех. у нас есть ссылки в файлах md, которые ссылаются на другие файлы md. Процедура выпуска Чтобы эти ссылки работали, мы должны изменить код md с помощью специального кода, такого как relrefs для Hugo и так далее. Почему мы не можем просто сохранить код ссылки как чистую уценку.

Мы полностью понимаем, что добавленный frontmatter решает множество проблем и дает нам много вариантов - но они нам на самом деле не нужны - мы просто хотим сделать это простым.

Так есть ли генераторы сайтов, которые не требуют дополнительного пользовательского кода для работы ссылок и структуры? Или мы что-то неправильно поняли в генераторах, на которые мы смотрели?

1 Ответ

0 голосов
/ 11 ноября 2018

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

https://github.com/woodyrew/metalsmith-default-values

...