Мы пытаемся преобразовать наши файлы документации (файлы MD) в статический веб-сайт.
Мы смотрели на Hugo, Metalsmith и другие генераторы статических сайтов.
Но мы чувствуем, что все они заставляют нас добавлять настраиваемую разметку или множество дополнительных метаданных (frontmatter), которые нам не очень нравятся.
F. ex. у нас есть ссылки в файлах MD, которые относятся к другим файлам MD. Порядок выпуска Чтобы эти ссылки работали, мы должны изменить код md с помощью специального кода, такого как relrefs для Hugo и так далее. Почему мы не можем просто сохранить код ссылки как чистую уценку.
Мы полностью понимаем, что добавленный фронтматтер решает множество проблем и дает нам множество вариантов, но на самом деле они нам не нужны - мы просто хотим, чтобы это было проще.
Так есть ли какие-нибудь генераторы сайтов, которые не требуют дополнительного пользовательского кода для работы связывания и структуры? Или мы неправильно поняли что-то в генераторах, на которые мы смотрели?
Есть удобный плагин Metalsmith для загрузки значений по умолчанию в «переднюю часть», так что вы можете избежать добавления большого количества / каких-либо специальных заголовков в существующие файлы ...
https://github.com/woodyrew/metalsmith-default-values