Replace mdBook with Typst - #416
Conversation
|
Hello @burrbull, Thank you for tagging me in this draft PR. First of all, if you are asking for my opinion on this PR, I'm not entirely in favor of this change. Since you tagged me, I assume you've likely seen the rust-embedded-book-l10n project I announced in #401. Therefore, if rust-embedded/book migrates from mdBook to another documentation generator, this l10n project will no longer be able to function (unless the new tool also supports gettext-based internationalization). Additionally, I noticed you mentioned the German translation in #415. If you are interested in translating The Embedded Rust Book, you are more than welcome to join the rust-embedded-book-l10n project! If German is not available yet, feel free to open an issue to request adding a new language. Once the requested language is added, you can start translating right away! |
|
I've found that my Synchronized with new version. Also headings are fixed. https://github.com/burrbull/book/blob/dae311b1d04524026f9f0943895a4f9d73eb6515/typ/intro/index.typ |
|
CI caching does not work. What I did wrong? All works as expected except one thing with sidebar in localized book. P.S. It would be nice to add some |
This is my answer to multi-language book. cc @hwhsu1231
We can keep translations in same file if use Typst instead. See
typ/intro/index.typfor example.This is a draft yet, but it is already looks and works very similar to mdBook version as it reuses original CSS and scripts.
How to compile:
For
html(Ukrainian language):and then copy
html-assetscontent intobook-html-ukFor PDF (German language): cc @braunharald
P.S. See rendered PDF https://github.com/burrbull/book/blob/d3105e73c217e17dd5ac42ca0e7f53d4fcac7fd7/book-en.pdf