Прикрутить mdbook

[mkpankov]

Старая задача и комментарии: kgv/rust_book_ru#331

Заменить rustbook на mdbook

[Gordon-F]

А чем mdbook лучше текущего инструмента ?

[mkpankov]

Хороший вопрос. Изначально на него собирались перейти upstream, и в соображениях совместимости с ними стоило бы использовать его. Однако прошёл уже год, а upstream всё ещё на него не перешли (насколько я знаю).

Помимо этого, он должен сам обрабатывать создание книги в не-html форматах (epub, mobi, pdf). Сейчас это делается через хитрые заморочки с Calibre, которые ещё и ведут к проблемам (#8, #9).

Когда-то я пробовал альтернативный конвейер для PDF через pandoc и он мне гораздо больше понравился - и красивее, и проблем никаких не заметил. Результаты здесь. Вот в mdbook похожую схему собирались использовать.

[Gordon-F]

@mkpankov так может pandoc и использовать?

[mkpankov]

Это разного уровня инструменты. pandoc - это замена Calibre, но не замена rustbook или mdbook.

[Gordon-F]

Я думаю нет смысла переводить эту книгу на mdbook. Сейчас активно пишут новую книгу, которая уже на mdbook https://github.com/rust-lang/book