book icon indicating copy to clipboard operation
book copied to clipboard

multi languages support

Open jiachao2130 opened this issue 4 years ago • 10 comments

I wonder if the book intends to support multi languages? I've translated it into chinese, and want to share with others.

jiachao2130 avatar Aug 17 '21 15:08 jiachao2130

I think bringing in more of an audience is a great idea!

Personally, I'm unfamiliar with how this works out in terms of future edits. What kind of process generally works for that?

epage avatar Aug 17 '21 15:08 epage

Actually, I'm confused by this problem too. Maybe create a new language branch? Everytime the master is ready to release, merge from the master first, then create a translate issue, wait for someone to adopt it?

Or just show the translated version books' url in the readme and the Getting started page?(should contains when, from which master branch commit)

jiachao2130 avatar Aug 18 '21 07:08 jiachao2130

Actually, I'm confused by this problem too. Maybe create a new language branch? Everytime the master is ready to release, merge from the master first, then create a translate issue, wait for someone to adopt it?

Or just show the translated version books' url in the readme and the Getting started page?(should contains when, from which master branch commit)

zh_CN: Rust 中的命令行工具

jiachao2130 avatar Aug 18 '21 07:08 jiachao2130

I have cloned this repository and I have started to translate this book to spanish (es_MX). How can I merge my translation with this official repository in order to contribute a multi-language book?

IsraelBuitronD avatar Sep 12 '21 00:09 IsraelBuitronD

I have cloned this repository and I have started to translate this book to spanish (es_MX). How can I merge my translation with this official repository in order to contribute a multi-language book?

I did this #82

jiachao2130 avatar Sep 13 '21 01:09 jiachao2130

Thanks for the work on translations! Good idea in starting small with links to unofficial repos.

epage avatar Sep 13 '21 14:09 epage

Hi, I'm thinking on translating this book into russian but I don't want to bother hosting the page myself, so how do I do that using mdbook? upd: just looked at their repo and seems like there is no support for multilang books(

adsick avatar Jan 29 '22 13:01 adsick

Hosting isn't too bad if you use github. You can create a new github org, fork this project into it, and then you can use the existing CI process to push the generated pages to github's static file server.

epage avatar Jan 31 '22 22:01 epage

yeah, the simplest way is that, just do your translate on your forked master branch, it will automatic create the book and push it to your github pages by SUMMARY.md, when your work is done, fork it again, just edit README.md, add your github pages links into the mutli language support

jiachao2130 avatar Feb 01 '22 01:02 jiachao2130

Wow, thanks, didn't know that!

adsick avatar Feb 01 '22 02:02 adsick