Кто нибудь пользовался?
Имеется большое количество html страниц (не md, не rst, а именно чистый html). Я их редактирую своим редактором.
Хочу сделать на github.io из них книгу, и нужно всего-то добавить оглавление, которое было бы на каждой странице.
По каким-то причинам везде пишут, что фреймы (как на rsdn) это плохо, что у каждой страницы должен быть свой уникальный url для закладок и т.п.
Ну наверное они правы.
Само оглавление я буду генерировать программно на своем компе своей программой (той же, которой редактирую html-ки) из специальных метаданных. Это может быть тоже html файл и вообще что угодно.
Вопрос — как встроить его в каждую страницу на гитхабе, т.е. как из набора нескольких тысяч страниц и этого оглавоения сделать несколько тысяч страниц с оглавлением? Например как здесь
https://doc.rust-lang.org/stable/book/
Понятно что поскольку у меня своя программа-редактор, то как-бы можно на своем компе все и сгенерировать, но это идеологически неправильно, т.к. смысл в хранении исходных данных под контролем версий, а Jekyll генерирует папочку _site со страницами, которые видит пользователь; и регенерирует ее после каждого коммита.
Я от Jekyll отказался в пользу Nikola лет пять назад. Поскольку Nikola не поддерживается на стороне сервера, у меня два репозитория: один содержит сорсы в md и настройками; другой, привязанный к github.io и с одним-единственным коммитом -- рендер всех HTML страниц и других ресурсов. Плюс, в корневой директории есть .nojekyll, присутствие которого GitHub Pages трактует как указание отключить Jekyll и работать со всеми файлами без обработки на сервере.
Таким образом, если разбираться в Jekyll нет никакого желания, можно запилить рендер оглавления прямо в своём генераторе и создать .nojekyll в корне. Или же разбираться с Jekyll-шаблонами самому, или искать аналог mdBook под Jekyll и как-то связать его со своими HTML.
Здравствуйте, x-code, Вы писали:
XC>Кто нибудь пользовался?
Я тоже от Jekyll отказался, ну его в пень, какой-то он сильно перегруженный.
Сейчас пользуюсь
MkDocs, там вроде все элементарно.
Перешел увидев что Microsoft юзает, оказалось довольно неплохо. Пример сгенерированного сайта (MkDocs + Material for MkDocs)
https://pnp.github.io/pnpjs/