Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

multi languages support #69

Open
jiachao2130 opened this issue Aug 17, 2021 · 10 comments
Open

multi languages support #69

jiachao2130 opened this issue Aug 17, 2021 · 10 comments

Comments

@jiachao2130
Copy link
Contributor

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

@epage
Copy link
Contributor

epage commented Aug 17, 2021

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?

@jiachao2130
Copy link
Contributor Author

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
Copy link
Contributor Author

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 中的命令行工具

@IsraelBuitronD
Copy link

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?

@jiachao2130
Copy link
Contributor Author

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

@epage
Copy link
Contributor

epage commented Sep 13, 2021

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

@adsick
Copy link

adsick commented Jan 29, 2022

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(

@epage
Copy link
Contributor

epage commented Jan 31, 2022

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.

@jiachao2130
Copy link
Contributor Author

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

@adsick
Copy link

adsick commented Feb 1, 2022

Wow, thanks, didn't know that!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

4 participants