search

rust-lang-ru / rust_book_ru

The Rust Programming Language на русском языке
http://rurust.github.io/rust_book_ru/
184 stars 22 forks source link

Прикрутить mdbook #19

Open mkpankov opened 8 years ago

mkpankov commented 8 years ago

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

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

Gordon-F commented 7 years ago

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

mkpankov commented 7 years ago

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

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

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

Gordon-F commented 7 years ago

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

mkpankov commented 7 years ago

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

Gordon-F commented 7 years ago

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