> ~ biozz / Blogs

Ansible для начинающих

Новый проект про обучение Ansible для начинающих.

Иван Елфимов, 2023-07-02, 1 мин (слов: 143)

Уменьшенное фото Stadsbiblioteket (Stockholm, Sweden), сделанное Susan Q Yin с Unsplash.com Уменьшенное фото 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 – использовать цитаты.

Переводы: en