Persian translation #671

mgeisler · 2023-05-24T12:33:14Z

Hi @mbpouri, here is an issue for you!

I don't see any translation on https://doc.rust-lang.org/book/appendix-06-translation.html, but perhaps there is a Persian Rust community somewhere where you can find translations of common words 😄

The translation is live at https://google.github.io/comprehensive-rust/fa/.

mgeisler · 2023-05-24T12:39:01Z

Let me know if/when you run into rust-lang/mdBook#1486 — then we'll have to work on adding good support for right-to-left languages in mdbook.

mbpouri · 2023-05-26T05:16:49Z

sure, on it. thanks pal @mgeisler

mgeisler · 2023-07-31T13:47:15Z

@DannyRavi, I tried out the translation in #1042 and the text looks like this out of the box:

Adding dir="rtl" to the html tag makes it look like this:

Does this look more correct to you? I cannot read it, so it's hard for me to judge how it looks 🙂

Ideally, we should fix this in the upstream mdbook project (rust-lang/mdBook#1486), but we can perhaps prototype a fix for them here and then contribute it upstream. I'm thinking we can simply use different index.hbs template depending on the writing direction.

DannyRavi · 2023-08-01T06:52:16Z

Before starting the translation of the texts. I noticed that the book has a problem with right-to-left texts according to links #1486 and #671
After translating some texts and testing the program on a local server, I realized that the right-to-left texts are not correct and the texts are difficult to understand for Persian speakers. Finally, I had no idea for right-to-left texts.

mgeisler · 2023-08-02T09:44:31Z

Hi @DannyRavi, could you test locally with mdbook serve after modifying theme/index.hbs like this:

modified   theme/index.hbs
@@ -1,5 +1,5 @@
 <!DOCTYPE HTML>
-<html lang="{{ language }}" class="sidebar-visible no-js {{ default_theme }}">
+<html lang="{{ language }}" dir="rtl" class="sidebar-visible no-js {{ default_theme }}">
     <head>
         <!-- Book generated using mdBook -->
         <meta charset="UTF-8">

This simply adds the dir="rtl" attribute to the html tag. Is this enough to make the page readable? If so, we could use this as a starting point and fix other issues down the road.

mgeisler · 2023-10-16T13:25:13Z

Hey @DannyRavi, @mbpouri, and @javad-jafari — would you be able to review each other's PRs? We have #1209 (by @DannyRavi) and #1341 (by @javad-jafari) open right now.

hamidrezakp · 2023-10-16T21:13:09Z

Hey there, i just saw this issue and the work you guys all are doing, that mean a lot to Persian community, Thank you all.

Can we use custom font for Persian translation? it's not pretty good. I'm available to change and fix it if you are okay with it.
I'm suggesting to use Vazir fonts family for Persian texts.

hamidrezakp · 2023-10-16T21:23:22Z

@DannyRavi @mbpouri
Thank you and @javad-jafari for your great work on translation.

I just checked some of translations and it seems there is a good amount of ZWNG missing in translations, let's fix them before merge to ensure a good quality text.
And I suggest we use راست for word ‍Rust because reading it is easier and it's pretty common in Persian community right now.

mgeisler · 2023-10-17T09:49:01Z

Hey there, i just saw this issue and the work you guys all are doing, that mean a lot to Persian community, Thank you all.

Hi @hamidrezakp, thanks for joining in!

Can we use custom font for Persian translation? it's not pretty good. I'm available to change and fix it if you are okay with it. I'm suggesting to use Vazir fonts family for Persian texts.

Awesome! If you can write a PR which tweaks the CSS, then I would be happy to add it!

We should ultimately add this upstream in https://github.com/rust-lang/mdBook/ since we're relying on the right-to-left support recently added there (rust-lang/mdBook#1641).

If the fix/improvement is clear, then I suggest adding it upstream directly. Otherwise we can also modify our CSS and theme as needed. Just let me know.

mgeisler · 2023-10-17T09:51:15Z

If we can find 2-3 people who are interested in reviewing, then add yourself to the CODEOWNERS file.

That way you'll be auto-added to future PRs and will thus be able to do everything yourself — @henrif75 and myself should not really be involved in the Persian translation 😄

hamidrezakp · 2023-10-17T10:22:18Z

If the fix/improvement is clear, then I suggest adding it upstream directly. Otherwise we can also modify our CSS and theme as needed. Just let me know.

So let me open an issue there and ask them if we can use custom fonts for Persian language; if not, we add it here.

hamidrezakp · 2023-10-17T10:25:47Z

That way you'll be auto-added to future PRs and will thus be able to do everything yourself — @henrif75 and myself should not really be involved in the Persian translation 😄

Yeah you are right 😄 it's just impossible for you to review or check translations, I think i can find some friends in Persian Rust community that are willing to be maintainer here.

mehrad77 · 2023-10-17T11:42:23Z

Hey folks, so existed about this.
I can help with reviewing the translations and other stuff related to fa translations.

hamidrezakp · 2023-10-17T12:04:06Z

@mehrad77 I have added your name to reviewers for Persian(#1375 ),
Which one of this PRs do you want to review?

You can assign them to yourself and we will pick others.

mehrad77 · 2023-10-17T18:26:10Z

@hamidrezakp I see there is a problem with the #1209 and I see no change in that PR.
With that said I'll assign myself to review #1341

mehrad77 · 2023-10-17T18:45:28Z

I've just made a look. I see lots of not related changes (mostly code style and text formatting, new lines, etc...).
When opening new PRs I think its very important to keep that in mind to not change parts of the document that are not related to the Farsi translation and limit the scope of changes. It'll make the reviewing a lot easier. At this moment I have no idea what to do with this much unrelated change in #1341

Besides that I see that a lot of chapters are not translated.I want to know is there a bigger plan to split chapters and assign the task of translation of each chapter to one person? I rather get involved in the translation itself and start making a bigger picture of who is translating which parts. I'll start translating the "Day 2" morning. (from chapter 12 to 17) and open a new PR.

hamidrezakp · 2023-10-17T18:54:51Z

Yeah i agree but maybe you can just check last commit (although it contains a lot of non-related things to translation and that's because of poor formatting i guess).

Anyways, That's a good idea to split the translation task into smaller chunks and more organized so contributors can easily pick 'em up and translate.

If you can open a draft PR that mentions what you are working on would be great.

DannyRavi · 2023-10-17T19:29:58Z

Hi @hamidrezakp .
Unfortunately, the word راست in Farsi, which means ‍Rust programming language, is the same as the word راست ,which means ‍Right , and this would increase the error of reading and misunderstand the translated text, and suggestions like رااست have been discussed before and have not reached a conclusion.

mehrad77 · 2023-10-18T02:53:39Z

@DannyRavi my suggestion is using رآست with the U+0622 instead of U+0627. (As afshin introduced on Mastadon). But I'm seeing that رااست has more adaption. I'm in favor of both of these.

hamidrezakp · 2023-10-18T07:27:42Z

@DannyRavi @mehrad77
I think we should do some polls in communities and social media to see what are everyone okay with.

mgeisler · 2023-10-18T07:31:53Z

Yeah i agree but maybe you can just check last commit (although it contains a lot of non-related things to translation and that's because of poor formatting i guess).

If the poor formatting is about lines being re-wrapped in strange ways, then we have a solution for that: we recently (#1359) introduced a GitHub check which requires PO files to be formatted consistently. This boils down to following the preparation section of TRANSLATIONS.md and then running

dprint fmt

Btw, I've found that using gh and bat works very well for reviewing the large diffs:

gh pr diff 1341 | bat -l patch

is very quick and shows me that changes of #1341 in a nice way.

mgeisler · 2023-10-18T08:03:36Z

@DannyRavi @mehrad77 I think we should do some polls in communities and social media to see what are everyone okay with.

Great idea! Feel free to use the discussions here or any other convenient place!

moaminsharifi · 2023-10-24T12:12:44Z

First of all, special thanks to @mgeisler for adding dir="rtl|ltr" to the html template

#671 (comment)

When you add dir="rtl" to html, the page direction will be right to left, but what about the English text (or any other LTR text) between the contents (or vice versa)?

For example,

In #1413 , I proposed a simple way to handle it with theme but not the most suitable way for doing it.

It's better to mention it here as well.

mgeisler · 2023-10-25T10:11:34Z

Thanks @moaminsharifi for looking at this. As I wrote in #1413, I think we should first understand if the right-to-left support works okayish for fully-translated pages. If it does, then the problem you point out is a temporary problem — if it doesn't, then I would need help from people here to find a good solution.

moaminsharifi · 2023-10-25T10:44:44Z

Thanks @moaminsharifi for looking at this. As I wrote in #1413, I think we should first understand if the right-to-left support works okayish for fully-translated pages. If it does, then the problem you point out is a temporary problem — if it doesn't, then I would need help from people here to find a good solution.

@mgeisler, For the time being, I think we should close that github issue #1413 until the pages are completely translated, then check it out again.

Part of #671 **Summary of changes:** - Persian version of book messages synced to original book - Translate sidebar menu * I just translate and double check until `# src/SUMMARY.md:333` part*

Part of #671 Summary of changes: - Translate Part 1,2 - Recheck `#, fuzzy` lines and synced their translations Co-authored-by: Kaveh <hamidrkp@riseup.net>

Part of #671 and #1413 In the code part of content which always is in english and must be `text-align: left` but with `<html ... dir=rtl >` cuz conflict. --------- Co-authored-by: Kaveh <hamidrkp@riseup.net>

Part of #671 - Translate Part `3` , `4` , `5` ,`6.1`, `6.2`, `6.3` --------- Co-authored-by: Hamid R. K. Pisghadam <kaveh@riseup.net> Co-authored-by: Kaveh <hamidrkp@riseup.net>

moaminsharifi · 2023-11-08T09:31:08Z

@mgeisler

Some of markdown renders to svg with ```bob , but I can not find in the translate file.
There is 10 Item like that:

but mostly 4 in each translation file like (fa.po):

Is that something we must add it manually?

mgeisler · 2023-11-08T13:43:22Z

Hi @moaminsharifi, the svgbob images disappeared from the translation pipeline with google/mdbook-i18n-helpers#75 by @dyoo: we now only translate a code block if it contains " or // since that is a very simple heuristic to recognize code with string literals or comments.

We should restore this and google/mdbook-i18n-helpers#76 is in some sense about this problem: with that feature implemented, we should be able to say "always translate svgbob code blocks".

Note that our text extraction tooling will become more fine-grained with google/mdbook-i18n-helpers#109, which will be merged later today or tomorrow after a small rebase.

Part of: #671 #1433 ## Issue: When we render SVG tags in persian ( `<html dir="rtl" ...>`) make confiliect: ![svg-rtl-issue](https://github.com/google/comprehensive-rust/assets/11869014/ce825736-4367-41fa-acd3-6e395926d7c7) originally: *[7.2 Arrays and for Loops](https://google.github.io/comprehensive-rust/exercises/day-1/for-loops.html#arrays-and-for-loops)* ![svg-rtl-issue-2](https://github.com/google/comprehensive-rust/assets/11869014/0a494392-2407-47ec-91f1-0098414b83d3) originally: *[16.2 Moved Strings in Rust](https://google.github.io/comprehensive-rust/ownership/moved-strings-rust.html)* ## Proposed method: as we talked in #1433, again in there adding ``` [dir="rtl"] svg { direction: ltr; } ``` fix issue like: ![svg-rtl-issue-fix](https://github.com/google/comprehensive-rust/assets/11869014/5d82c413-709a-42dd-b24b-1ff2c8be55ba) ![svg-rtl-issue-2-fixture](https://github.com/google/comprehensive-rust/assets/11869014/da2bf319-212e-4edd-9135-82f51e5e0381)

…1453) Part of #671 - Translate Part `6.x`, `7`, `..`, `15.x`, `16.1` , `..` , `16.5`

mgeisler added the translation label May 24, 2023

mgeisler mentioned this issue May 24, 2023

Translations #282

Open

mgeisler mentioned this issue Jul 31, 2023

fa: add Persian/Farsi language #1042

Merged

mgeisler mentioned this issue Jul 31, 2023

Continued work on "Support right-to-left languages" rust-lang/mdBook#1641

Merged

mgeisler mentioned this issue Sep 4, 2023

Test new mdbook right-to-left rendering #1164

Closed

mgeisler mentioned this issue Oct 15, 2023

fa: add more Persian #1209

Closed

mgeisler mentioned this issue Oct 16, 2023

fa: Add more Persian translations #1341

Closed

moaminsharifi mentioned this issue Oct 23, 2023

Bi-directional text rendering issues in translated version of book #1413

Closed

mgeisler mentioned this issue Oct 24, 2023

[ADD] bi-directional support with css and js #1414

Closed

moaminsharifi mentioned this issue Oct 25, 2023

fa: Adding Persian translations to side bar items #1427

Merged

moaminsharifi mentioned this issue Oct 26, 2023

fa: Add transltion of Part 1,2 of Book #1432

Merged

hamidrezakp added a commit that referenced this issue Oct 26, 2023

fa: Add transltion of Part 1,2 of Book (#1432)

77ab1ab

Part of #671 Summary of changes: - Translate Part 1,2 - Recheck `#, fuzzy` lines and synced their translations Co-authored-by: Kaveh <hamidrkp@riseup.net>

moaminsharifi mentioned this issue Oct 27, 2023

Fixture code and footer content tags in rtl content #1433

Merged

moaminsharifi mentioned this issue Oct 31, 2023

fa: Translate Part 3 , 4 , 5 ,6.1, 6.2, 6.3 #1439

Merged

This was referenced Nov 8, 2023

fa: Translate Part 6.x, 7, .., 15.x, 16.1 , .. , 16.5 #1453

Merged

Fix SVG renders in RTL contents #1454

Merged

moaminsharifi mentioned this issue Nov 11, 2023

Update translation file with v2 of book #1470

Closed

hamidrezakp pushed a commit that referenced this issue Dec 17, 2023

fa: Translate Part 6.x, 7, .., 15.x, 16.1 , .. , 16.5 (#…

9a6a16e

…1453) Part of #671 - Translate Part `6.x`, `7`, `..`, `15.x`, `16.1` , `..` , `16.5`

alix1383 mentioned this issue Apr 30, 2024

fa : [1/12] Persian translations #2038

Open

10 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Persian translation #671

Persian translation #671

mgeisler commented May 24, 2023 •

edited

mgeisler commented May 24, 2023

mbpouri commented May 26, 2023

mgeisler commented Jul 31, 2023

DannyRavi commented Aug 1, 2023

mgeisler commented Aug 2, 2023

mgeisler commented Oct 16, 2023

hamidrezakp commented Oct 16, 2023 •

edited

hamidrezakp commented Oct 16, 2023 •

edited

mgeisler commented Oct 17, 2023

mgeisler commented Oct 17, 2023

hamidrezakp commented Oct 17, 2023

hamidrezakp commented Oct 17, 2023

mehrad77 commented Oct 17, 2023

hamidrezakp commented Oct 17, 2023

mehrad77 commented Oct 17, 2023 •

edited

mehrad77 commented Oct 17, 2023 •

edited

hamidrezakp commented Oct 17, 2023

DannyRavi commented Oct 17, 2023 •

edited

mehrad77 commented Oct 18, 2023 •

edited

hamidrezakp commented Oct 18, 2023

mgeisler commented Oct 18, 2023

mgeisler commented Oct 18, 2023

moaminsharifi commented Oct 24, 2023

mgeisler commented Oct 25, 2023

moaminsharifi commented Oct 25, 2023

moaminsharifi commented Nov 8, 2023

mgeisler commented Nov 8, 2023

Persian translation #671

Persian translation #671

Comments

mgeisler commented May 24, 2023 • edited

mgeisler commented May 24, 2023

mbpouri commented May 26, 2023

mgeisler commented Jul 31, 2023

DannyRavi commented Aug 1, 2023

mgeisler commented Aug 2, 2023

mgeisler commented Oct 16, 2023

hamidrezakp commented Oct 16, 2023 • edited

hamidrezakp commented Oct 16, 2023 • edited

mgeisler commented Oct 17, 2023

mgeisler commented Oct 17, 2023

hamidrezakp commented Oct 17, 2023

hamidrezakp commented Oct 17, 2023

mehrad77 commented Oct 17, 2023

hamidrezakp commented Oct 17, 2023

mehrad77 commented Oct 17, 2023 • edited

mehrad77 commented Oct 17, 2023 • edited

hamidrezakp commented Oct 17, 2023

DannyRavi commented Oct 17, 2023 • edited

mehrad77 commented Oct 18, 2023 • edited

hamidrezakp commented Oct 18, 2023

mgeisler commented Oct 18, 2023

mgeisler commented Oct 18, 2023

moaminsharifi commented Oct 24, 2023

mgeisler commented Oct 25, 2023

moaminsharifi commented Oct 25, 2023

moaminsharifi commented Nov 8, 2023

mgeisler commented Nov 8, 2023

mgeisler commented May 24, 2023 •

edited

hamidrezakp commented Oct 16, 2023 •

edited

hamidrezakp commented Oct 16, 2023 •

edited

mehrad77 commented Oct 17, 2023 •

edited

mehrad77 commented Oct 17, 2023 •

edited

DannyRavi commented Oct 17, 2023 •

edited

mehrad77 commented Oct 18, 2023 •

edited