rust_book_ru icon indicating copy to clipboard operation
rust_book_ru copied to clipboard

Published 20 hours ago • verified publisher icon rust-lang-ru

Прикрутить mdbook

Open mkpankov opened this issue 8 years ago • 5 comments

Старая задача и комментарии: https://github.com/kgv/rust_book_ru/issues/331

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

mkpankov avatar Jan 23 '16 17:01 mkpankov

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

Gordon-F avatar Oct 14 '16 09:10 Gordon-F

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

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

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

mkpankov avatar Oct 14 '16 09:10 mkpankov

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

Gordon-F avatar Oct 14 '16 10:10 Gordon-F

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

mkpankov avatar Oct 14 '16 11:10 mkpankov

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

Gordon-F avatar Nov 25 '16 04:11 Gordon-F