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

nuxt / website-v2

Nuxt 2 Documentation Website

https://v2.nuxt.com

Other

2.25k stars 1.2k forks source link

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

Open felipe-heredia opened 2 years ago

felipe-heredia commented 2 years ago

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

trizotti commented 2 years ago

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

felipe-heredia commented 2 years ago

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.

trizotti commented 2 years ago

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 commented 2 years ago

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

felipe-heredia commented 2 years ago

@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.

trizotti commented 2 years ago

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

felipe-heredia commented 2 years ago

@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.

MonicaFidalgo commented 2 years ago

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!