Уменьшенное фото Stadsbiblioteket (Stockholm, Sweden), сделанное Susan Q Yin с Unsplash.com
Внезапный тренд mdBook стал поводом для релиза моего старого незавршенного проекта про обучение Ansible - Ansible для начинающих.
На полпути переноса из заметок в mdBook, как обычно, стал думать, а есть ли альтернативы лучше. Идеальным вариантом для меня был бы Hugo, потому что biozz.dev на нем и он вполне всем устраивает. Но не для написания онлайн-книг. Как оказалось, нормальной темы, кроме hugo-book попросту нет. А в hugo-book нет прикольных фичей, которые меня сразили в mdBook: “перелистывание” страниц и нумерация глав. Под “перелистыванием” я понимаю ссылки на следующую страницу.
Еще я был готов посмотреть в сторону Zola, но там я тоже нормальных тем не нашел.
Другие варианты, типа mkDocs с mkdocs-material или starlight показались слишком навороченными для простой цели поделиться материалом.
Единственное, чего мне не хватило в mdBook прямо сейчас – это admonitions. Но им есть неплохая альтернатива, подсказанная Rust book – использовать цитаты.