website-v2 icon indicating copy to clipboard operation
website-v2 copied to clipboard

[Translation] Guide Translation to Portuguese Brasil (pt-br)

Open felipe-heredia opened this issue 2 years ago • 8 comments

This question will be used to

a. Organize the process of translating the entire website to pt-br. b. To gather all the information about the status of the translation of the whole website to pt-br. c. Track all-volunteer translators (to know which part of the website they are translating, to avoid conflicts during the whole process).

If you would like to volunteer, you can comment below on which page you will be working on the translation, so that everyone knows.

Note: The main folder is /content/pt-br/


The docs pages translated:

  • [x] Index (including Header and Footer).
  • [x] docs/1.get-started
  • [x] docs/2.concepts
  • [ ] docs/3.features
  • [ ] docs/4.directory-structure
  • [ ] docs/5.configuration-glossary
  • [ ] docs/6.internals-glossary
  • [ ] docs/7.components-glossary

felipe-heredia avatar Jan 14 '22 14:01 felipe-heredia

You guys are doing an amazing job translating to pt-BR! Can I help somehow? 😄

trizotti avatar Feb 17 '22 13:02 trizotti

Welcome, @trizotti. I'm Actually translating the docs/3.features. Can you help me with this? This section is so big.

However, if you don't want to help me with docs/3.features, you can translate any other section, I just ask you to tell here what you are doing.

felipe-heredia avatar Feb 17 '22 22:02 felipe-heredia

Sure I can help with the 'docs' page! @felipesuri , any suggestion on how I could help with the 'docs' page? Is there any specific section you'd like to recommend for some parallel work?

trizotti avatar Feb 18 '22 17:02 trizotti

Progress of translation for 'Examples' page:

  • [x] 1.routing
  • [x] 2.data-fetching
  • [x] 3.assets-management
  • [x] 4.transitions
  • [x] 5.seo
  • [x] 6.loading
  • [x] 7.miscellaneous
  • [x] 8.middlewares
  • [x] 9.plugins
  • [x] 10.modules

trizotti avatar Feb 18 '22 18:02 trizotti

@trizotti I must recommend that you translate the docs/4.directory-structure docs section.

Here are some tips to get a better translation:

  • Add i18n config in the nuxt.config file, like this: But never commit it, because this is for better work of the site in development, we can't push this change
i18n: {
  locales: [
    ...,
    {
        code: 'pt-br',
        iso: 'pt-BR',
        file: 'pt-BR.js',
        name: 'Português (Brasil)'
    },
  ]
]
  • Disable any lint extension like markdownlint because it can break the site, I've been there and it's not cool.
  • Revise the entire page after the translation and click on every link and make sure they keep working.
  • When you open PR, mention this issue on there I will revise it before the others reviewers.
  • Use Docus and Portuguese - Code Spell Checker extensions on VSCode.

felipe-heredia avatar Feb 18 '22 19:02 felipe-heredia

Hello, @felipesuri ! I've finished the translation for the 'Examples' page, but I'm a little bit confused on how to define the replacements for the titles highlighted with green boxes: menu-titles

trizotti avatar Feb 21 '22 20:02 trizotti

@trizotti for this, you'll need to translate the title on each index.md file.

Ex.:

---
title: Rotas
navigation:
  collapse: false
  redirect: /examples/routing/hello-world
---

This code is on the examples/1.routing/index.md file.

felipe-heredia avatar Feb 21 '22 22:02 felipe-heredia

Awesome work everyone!! I would love to contribute as well! :) Is there something that I can help with? Translating some missing page/docs or helping review prs? Thanks!

MonicaFidalgo avatar Jun 06 '22 15:06 MonicaFidalgo