Skip to content

Latest commit

 

History

History
134 lines (107 loc) · 5.77 KB

CONTRIBUTING.md

File metadata and controls

134 lines (107 loc) · 5.77 KB

Contributing to translate

Guidelines

Translation terms

We need to coordinate us with the main English terms translations.

In this purpose, please refer to the file /FRENCH/src/translation-terms.md when you need to translate a technicial term.

(PS : see the next process Add a translation term on this same page)

Translation of Rust code

In rust code, we should translate :

  • comment
  • string text
  • variable name
  • struct name (which is custom, that means it not come from standard library or external crate)
  • enum name (which is custom, that means it not come from standard library or external crate)

All the standard code (and terminal outputs) should stay in English.

Files

The name of all the files should not be translated, so just keep them unchanged, in English.

Please limit each line of Markdown file to 80 characters (including spaces). You can write your file as you want, but it would be nice to use a tool like https://www.dcode.fr/text-splitter on your translated paragraphs before commiting.

Punctuation

Please use a non-breaking space instead of space on punctuation who need this space before (like :, !, ?, ...).

Processes

Translate flow

NB : the following term main translate repository refers to https://github.com/Jimskapt/rust-wasm-book-fr

  1. Open or edit an GitHub issue in the main translate repository to report to other that you are working on ch01-00-introduction.
    • if someone has reported to work on the same page you want to translate :
      • if its works is active : you should work on another page.
      • else : you can fork his/her repo in the following step 02 (instead of the main translate repository), and please mention this in the existing issue.
    • else : just follow the next instructions.
  2. Fork the main translate repository in GitHub (on your account)
  3. git clone https://github.com/<your_fork>.git (copy your fork on your hard-disk). You should be on the french-release branch by default.
  4. cd <your_fork> (go inside your fork folder your previously downloaded)
  5. git checkout -b <your_new_working_branch_name> (create your new working branch)
  6. Copy the file you want to translate : /src/introduction.md into /FRENCH/src/introduction.md. Tip : you can use a tool like Castor Whispers in order to copy and mass-comment each paragraphs of this file.
  7. Add the text for the link to this file in the /FRENCH/src/SUMMARY.md.
  8. Comment each English paragraphs of this file. The goal is to keep an invisible version of the English book, in order to easily reflect the changes of the English source (english-book) when they occur later, and to easily translate them.
  9. Write each of your translated paragraph under each commented English paragraph.
    • Please quickly read following Guidelines currently on this page.
    • A little tip : the deepl.com translator.
  10. (optionnal) Limit each line of your translation to 80 characters, thank to a tool like https://www.dcode.fr/text-splitter.
  11. (optionnal) cd FRENCH && mdbook build && cd .. (build the book in /FRENCH/book). Open its index.html file in your browser, and check its correctness. It also should help you for next task.
  12. (optionnal) self-proofreading your work thank to services like bonpatron.fr.
  13. git add -A && git commit -m "<Description of your work>" (committing your work)
  14. (optionnal) git rebase -i HEAD~<the number of commits you need to merge> (squash all your commits into one commit)
  15. git push origin (pushing your work on your fork)
  16. In GitHub, create a new pull request from your fork to the main translation repository, in order to mark your work ready for a proofreading.
  17. After someone proofreading it (and eventualy some edits), it would be merged on french-release branch.

Update your fork with another fork

  1. git remote add english-book https://github.com/rustwasm/book.git (Add source of the English main repository)
  2. git fetch english-book (fetching the latest changes from the English main repository)
  3. git merge english-book/master (merging latest changes from English main repository on current branch)

It is also the same to update your fork with the main translate repository.

Add a translation term

(PS : see previous Guideline Translation terms on this same page)

  1. Check if you are one your working branch, or create it (see Translate flow process)
  2. Edit the /FRENCH/src/translation-terms.md file with your new technical term translation. Write it in singular and if necessary, specify the gender of the translation in Remarques column.

Translate figures

Let's suppose you want to translate Figure 42-69. You need to have the dot installed, for instance after typing sudo apt install graphviz.

  1. Copy the DOT figure you want to translate (for instance, trpl42-69.dot) from /dot/ to /FRENCH/dot/.
  2. Edit /FRENCH/dot/trpl42-69.dot and translate the text into French. You should not translate the names and values of attributes.
  3. Run dot FRENCH/dot/trpl42-69.dot -Tsvg > FRENCH/src/img/trpl42-69.svg
  4. Edit the new file FRENCH/src/img/trpl42-69.svg:
    • Within the <svg> tag, remove the width and height attributes, and set the viewBox attribute to 0.00 0.00 1000.00 1000.00 or other values that don't cut off the image.
    • Replace every instance of font-family="Times,serif" with font-family="Times,Liberation Serif,serif".