Merge pull request #94 from ResidenciaTICBrisa/translate-fix-typos-docs

Tradução das documentações do NAO4, NAO6, ROS1 e ROS2

docs/ros1/compiling-for-amd64-based-systems-en.md

@@ -0,0 +1 @@
+../../scripts/ros1/compiling-for-amd64-based-systems-en.md

docs/ros1/compiling-for-amd64-based-systems-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros1/compiling-for-amd64-based-systems-ptbr.md

docs/ros1/compiling-for-arm-based-systems-en.md

@@ -0,0 +1 @@
+../../scripts/ros1/compiling-for-arm-based-systems-en.md

docs/ros1/compiling-for-arm-based-systems-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros1/compiling-for-arm-based-systems-ptbr.md

docs/ros1/general-instructions-en.md

@@ -0,0 +1 @@
+../../scripts/ros1/general-instructions-en.md

docs/ros1/general-instructions-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros1/general-instructions-ptbr.md

docs/ros1/installing-native-packages-en.md

@@ -0,0 +1 @@
+../../scripts/ros1/installing-native-packages-en.md

docs/ros1/installing-native-packages-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros1/installing-native-packages-ptbr.md

docs/ros1/installing-precompiled-packages-en.md

@@ -0,0 +1 @@
+../../scripts/ros1/installing-precompiled-packages-en.md

docs/ros1/installing-precompiled-packages-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros1/installing-precompiled-packages-ptbr.md

docs/ros2/compiling-for-amd64-based-systems-en.md

@@ -0,0 +1 @@
+../../scripts/ros2/compiling-for-amd64-based-systems-en.md

docs/ros2/compiling-for-amd64-based-systems-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros2/compiling-for-amd64-based-systems-ptbr.md

docs/ros2/compiling-for-arm-based-systems-en.md

@@ -0,0 +1 @@
+../../scripts/ros2/compiling-for-arm-based-systems-en.md

docs/ros2/compiling-for-arm-based-systems-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros2/compiling-for-arm-based-systems-ptbr.md

docs/ros2/general-instructions-en.md

@@ -0,0 +1 @@
+../../scripts/ros2/general-instructions-en.md

docs/ros2/general-instructions-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros2/general-instructions-ptbr.md

docs/ros2/installing-precompiled-packages-en.md

@@ -0,0 +1 @@
+../../scripts/ros2/installing-precompiled-packages-en.md

docs/ros2/installing-precompiled-packages-ptbr.md

@@ -0,0 +1 @@
+../../scripts/ros2/installing-precompiled-packages-ptbr.md

docs/vms/ubuntu-16/how-to-use-en.md

@@ -0,0 +1 @@
+../../../scripts/vms/ubuntu-16/how-to-use-en.md

docs/vms/ubuntu-16/how-to-use-ptbr.md

@@ -0,0 +1 @@
+../../../scripts/vms/ubuntu-16/how-to-use-ptbr.md

mkdocs.yml

@@ -77,7 +77,7 @@ markdown_extensions:
 
 nav:
   - Home: index.md
-  - Primeiros Passos: 
+  - Primeiros Passos:
     - Conceitos fundamentais: Instruções/Conceitos_Gerais.md
     - Trabalhando com máquinas virtuais: Instruções/Maquina_Virtual.md
     - Introdução à programação orientada a objetos com C++: Instruções/Guia_POO.md
@@ -96,17 +96,17 @@ nav:
     - Choregraphe: Instruções/Choregraphe_v6.md
   - Extra:
     - ROS1:
-      - Instructions: Instruções/ROS_1.md
-      - General: ros1/general-instructions.md
-      - Precompiled: ros1/installing-precompiled-packages.md
-      - Compiling: ros1/compiling-for-amd64-based-systems.md
-      - Compiling for SBCs: ros1/compiling-for-arm-based-systems.md
-      - Native packages: ros1/installing-native-packages.md
+      - Instruções: Instruções/ROS_1.md
+      - Geral: ros1/general-instructions.md
+      - Pré-compilados: ros1/installing-precompiled-packages.md
+      - Compilando: ros1/compiling-for-amd64-based-systems.md
+      - Compilando para SBCs: ros1/compiling-for-arm-based-systems.md
+      - Pacotes nativos: ros1/installing-native-packages.md
     - ROS2:
-      - General: ros2/general-instructions.md
-      - Precompiled: ros2/installing-precompiled-packages.md
-      - Compiling: ros2/compiling-for-amd64-based-systems.md
-      - Compiling for SBCs: ros2/compiling-for-arm-based-systems.md
+      - Geral: ros2/general-instructions.md
+      - Pré-compilados: ros2/installing-precompiled-packages.md
+      - Compilando: ros2/compiling-for-amd64-based-systems.md
+      - Compilando para SBCs: ros2/compiling-for-arm-based-systems.md
   - Marcos: release/index.md
   - Equipe: sobre/equipe.md
   - Sobre: sobre/sobre.md

scripts/navegando.md

@@ -0,0 +1,24 @@
+# Navegando pelo diretório de scripts
+
+O diretório de scripts contém a maior parte do projeto. Ele é composto pelos
+scripts usados para gerar as máquinas virtuais (VMs) do NAOv4 e do NAOv6, e
+pelos scripts usados para compilar o ROS1 e ROS2, bem como a documentação do
+projeto, que é copiada para o diretório `docs` através de *links* simbólicos
+gerados pelo script localizado em `03_Robotica/docs/mkdocs-kludge.sh`.
+
+## O conteúdo dos diretórios
+
+Segue abaixo o conteúdo de cada um dos diretórios e uma breve explicação sobre
+cada um deles. Os níveis dos tópicos indicam os subdiretórios dentro de um
+diretório.
+
+- `ros1`: contém os scripts e a documentação que lidam com a compilação ou
+instalação do ROS1 Noetic.
+- `ros2`: contém os scripts e a documentação que se referem a compilação ou
+instalação do ROS2 Humble.
+- `vms`: contém os diretórios referentes às máquinas virtuais do NAOv4 e do
+NAOv6:
+    - `ubuntu-14`: contém os scripts e a documentação da máquina virtual do
+    NAOv4.
+    - `ubuntu-16`: contém os scripts e a documentação da máquina virtual do
+    NAOv6.

scripts/ros1/compiling-for-amd64-based-systems-en.md

@@ -0,0 +1,13 @@
+# Compile ROS for Ubuntu 20.04 Focal AMD64-based machines
+
+## Instructions
+
+### Compiling and installing on Ubuntu-based Systems
+
+Please be aware that this will add ROS repositories and add many dependencies on
+your machine.
+
+1. Run the script `ubuntu-compile-install-ros1-noetic.sh`
+2. Authorise the administrative-level operations using your password
+3. ROS will be installed on the `ros1_noetic` directory in the directory which
+the script was run.

scripts/ros1/compiling-for-amd64-based-systems-ptbr.md

@@ -0,0 +1,13 @@
+# Compilar o ROS para o Ubuntu 20.04 Focal em máquinas AMD64
+
+## Instruções
+
+### Compilando e instalando em sistemas baseados em Ubuntu
+
+Esteja atento ao fato de que o procedimento abaixo irá adicionar os repositórios
+do ROS1 e várias dependências em sua máquina.
+
+1. Execute o script `ubuntu-compile-install-ros1-noetic.sh`
+2. Autorize as operações de nível administrativo usando a sua senha
+3. O ROS1 será instalado no diretório `ros1_noetic` dentro do diretório em que o
+script foi executado

scripts/ros1/compiling-for-amd64-based-systems.md

@@ -1,13 +1,7 @@
 # Compile ROS for Ubuntu 20.04 Focal AMD64-based machines
 
-## Instructions
+- [English](./compiling-for-amd64-based-systems-en.md)
 
-### Compiling and installing on Ubuntu-based Systems
+# Compilar o ROS para o Ubuntu 20.04 Focal em máquinas AMD64
 
-Please be aware that this will add ROS repositories and add many dependencies on
-your machine.
-
-1. Run the script `ubuntu-compile-install-ros1-noetic.sh`
-2. Authorise the administrative-level operations using your password
-3. ROS will be installed on the `ros2_humble` directory in the directory which the
-script was run.
+- [Português](./compiling-for-amd64-based-systems-ptbr.md)

scripts/ros1/compiling-for-arm-based-systems-en.md

@@ -0,0 +1,73 @@
+# Compile ROS1 for a ARM-based SBC (Raspberry Pi and similar devices) on your computer
+
+## Packages to install
+
+```
+qemu-system-arm
+qemu-utils
+qemu-user-static
+binfmt-support
+devscripts
+libguestfs-tools
+```
+
+## Instructions
+
+The scripts are configured by default to compile and create *chroots* based on
+ROS1's expected Ubuntu installation: a Ubuntu 20.04 LTS system up-to-date with
+its security repository.
+
+There are variables that enable the modification to compile and generate
+*chroots* for all GNU/Linux distributions supported by `debootstrap`.
+
+### Bootstraping a chroot
+
+This step is required if you wish to compile and install ROS1 on a ARM-based
+SBC.
+
+1. Run, with administrator priviledges,the script `bootstrap-chroot-32.sh` or
+`bootstrap-chroot-64.sh`, depending on the Operating System installed on your
+Single Board Computer. This step will be successfull if Git can be successfully
+installed after authorising uts installation.
+
+### Compiling and installing on Ubuntu-based Systems
+
+After setting the `chroot` up, you must run one of the compilation and
+installation scripts. The version will depend on the architecture and the
+operating system on your SBC.
+
+1. Run, with administrator priviledges,the script
+`ubuntu-compile-install-ros1-32.sh` or `ubuntu-compile-install-ros1-64.sh`,
+depending on the Operating System installed on your Single Board Computer.
+2. Authorise the operations inside the *chrooted* environment using the
+`CHROOTED_USER`'s password defined in the `chroot-env-vars.sh` script.
+3. ROS will be installed on the `CHROOTED_USER`'s home directory. Depending on
+your operating system, you may need to install `ros-dev-tools` or a similar
+package.
+
+### Installing ROS1 Dependencies after compiling it
+
+1. Copy the directory with the compiled results and the dependency scripts to
+the target system.
+2. Install the basic dependencies. This step depends on the operating system.
+3. Run the dependency script `ros1-noetic-packages.sh` to install the full list
+of dependencies.
+
+#### Installing the basic dependencies on Ubuntu 20.04 LTS (Focal)
+
+The following script will install the basic dependencies and run the dependency
+script.
+
+```bash
+sudo apt install --yes git wget software-properties-common
+sudo add-apt-repository --yes universe
+
+sudo wget https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -O /usr/share/keyrings/ros-archive-keyring.gpg
+
+echo "deb [signed-by=/usr/share/keyrings/ros-archive-keyring.gpg arch=$(dpkg --print-architecture)] http://packages.ros.org/ros/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/ros1.list > /dev/null
+sudo apt update
+
+sudo apt install --yes ros-dev-tools
+
+sudo ./ros1-noetic-packages.sh
+```

scripts/ros1/compiling-for-arm-based-systems-ptbr.md

@@ -0,0 +1,73 @@
+# Compilar ROS1 para um SBC ARM (Raspberry Pi e similares) em seu computador
+
+## Pacotes a instalar
+
+```
+qemu-system-arm
+qemu-utils
+qemu-user-static
+binfmt-support
+devscripts
+libguestfs-tools
+```
+
+## Instruções
+
+Os scripts são configurados por padrão para compilarem e criarem *chroots*
+baseados na instalação do Ubuntu assumida pelo ROS1: um sistema Ubuntu 20.04 LTS
+que esteja atualizado em relação ao seu repositório de segurança.
+
+Há variáveis que habilitam a modificação para compilação e geração de *chroots*
+para todas as distribuições GNU/Linux suportadas pelo `debootstrap`.
+
+### Inicializando um chroot
+
+Este passo é requerido caso queira compilar e instalar o ROS1 em um SBC baseado
+na arquitetura ARM.
+
+1. Execute, com privilégios de administrador, o script `bootstrap-chroot-32.sh`
+ou `bootstrap-chroot-64.sh`, dependendo do sistema operacional instalado em seu
+*Single Board Computer*. Este passo terá sido executado com sucesso caso o Git
+consiga ser instalado corretamente após autorizar a sua instalação.
+
+### Compilando e instalando em sistemas baseados em Ubuntu
+
+Depois de configurar o `chroot`, deverá executar um dos scripts de compilação e
+instalação. A versão deles dependerá da arquitetura e do sistema operacional do
+seu SBC.
+
+1. Execute, com privilégios de administrador, o script
+`ubuntu-compile-install-ros1-32.sh` ou `ubuntu-compile-install-ros1-64.sh`,
+dependendo do sistema operacional instalado no SBC.
+2. Autorize as operações dentro do ambiente *chroot* usando a senha do usuário
+`CHROOTED_USER` definida no script `chroot-env-vars.sh`.
+3. O ROS1 será instalado no diretório *home* do `CHROOTED_USER`. Dependendo de
+seu sistema operacional, poderá ter que instalar o pacote `ros-dev-tools` ou o
+seu equivalente.
+
+### Instalando as dependências do ROS1 após compilá-lo
+
+1. Copiar o diretório com os resultados compilados e os scripts de dependência
+para o sistema alvo.
+2. Instalar as dependências básicas. Este passo depende do sistema operacional.
+3. Execute o script de dependência `ros1-noetic-packages.sh` para instalar a
+lista completa de dependências.
+
+#### Instalando as dependências básicas no Ubuntu 20.04 (Focal)
+
+O seguinte script instalará as dependências básicas e executará o script de
+dependências.
+
+```bash
+sudo apt install --yes git wget software-properties-common
+sudo add-apt-repository --yes universe
+
+sudo wget https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -O /usr/share/keyrings/ros-archive-keyring.gpg
+
+echo "deb [signed-by=/usr/share/keyrings/ros-archive-keyring.gpg arch=$(dpkg --print-architecture)] http://packages.ros.org/ros/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/ros1.list > /dev/null
+sudo apt update
+
+sudo apt install --yes ros-dev-tools
+
+sudo ./ros1-noetic-packages.sh
+```

scripts/ros1/compiling-for-arm-based-systems.md

@@ -1,73 +1,7 @@
 # Compile ROS1 for a ARM-based SBC (Raspberry Pi and similar devices) on your computer
 
-## Packages to install
+- [English](./compiling-for-arm-based-systems-en.md)
 
-```
-qemu-system-arm
-qemu-utils
-qemu-user-static
-binfmt-support
-devscripts
-libguestfs-tools
-```
+# Compilar ROS1 para um SBC ARM (Raspberry Pi e similares) em seu computador
 
-## Instructions
-
-The scripts are configured by default to compile and create *chroots* based on
-ROS1's expected Ubuntu installation: a Ubuntu 20.04 LTS system up-to-date with
-its security repository.
-
-There are variables that enable the modification to compile and generate
-*chroots* for all GNU/Linux distributions supported by `debootstrap`.
-
-### Bootstraping a chroot
-
-This step is required if you wish to compile and install ROS1 on a ARM-based
-SBC.
-
-1. Run, with administrator priviledges,the script `bootstrap-chroot-32.sh` or
-`bootstrap-chroot-64.sh`, depending on the Operating System installed on your
-Single Board Computer. This step will be successfull if Git can be successfully
-installed after authorising uts installation.
-
-### Compiling and installing on Ubuntu-based Systems
-
-After setting the `chroot` up, you must run one of the compilation and
-installation scripts. The version will depend on the architecture and the
-operating system on your SBC.
-
-1. Run, with administrator priviledges,the script
-`ubuntu-compile-install-ros1-32.sh` or `ubuntu-compile-install-ros1-64.sh`,
-depending on the Operating System installed on your Single Board Computer.
-2. Authorise the operations inside the *chrooted* environment using the
-`CHROOTED_USER`'s password defined in the `chroot-env-vars.sh` script.
-3. ROS will be installed on the `CHROOTED_USER`'s home directory. Depending on
-your operating system, you may need to install `ros-dev-tools` or a similar
-package.
-
-### Installing ROS1 Dependencies after compiling it
-
-1. Copy the directory with the compiled results and the dependency scripts to
-the target system.
-2. Install the basic dependencies. This step depends on the operating system.
-3. Run the dependency script `ros1-noetic-packages.sh` to install the full list
-of dependencies.
-
-#### Installing the basic dependencies on Ubuntu 20.04 LTS (Focal)
-
-The following script will install the basic dependencies and run the dependency
-script.
-
-```bash
-sudo apt install --yes git wget software-properties-common
-sudo add-apt-repository --yes universe
-
-sudo wget https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -O /usr/share/keyrings/ros-archive-keyring.gpg
-
-echo "deb [signed-by=/usr/share/keyrings/ros-archive-keyring.gpg arch=$(dpkg --print-architecture)] http://packages.ros.org/ros/ubuntu focal main" | sudo tee /etc/apt/sources.list.d/ros1.list > /dev/null
-sudo apt update
-
-sudo apt install --yes ros-dev-tools
-
-sudo ./ros1-noetic-packages.sh
-```
+- [Português](./compiling-for-arm-based-systems-ptbr.md)