From 0a5e31e1c7f3a48ec206ca07bb1ffb1cd0fb39c0 Mon Sep 17 00:00:00 2001
From: Luis Felipe Santos do Nascimento <luisfelipesdn12@gmail.com>
Date: Thu, 6 May 2021 13:38:43 -0300
Subject: [PATCH] [, arduino-builder, arduino, bash, clear: add pt-BR
 translation (#5874)

---
 pages.pt_BR/common/[.md               | 25 ++++++++++++++++++++
 pages.pt_BR/common/arduino-builder.md | 25 ++++++++++++++++++++
 pages.pt_BR/common/arduino.md         | 28 +++++++++++++++++++++++
 pages.pt_BR/common/bash.md            | 33 +++++++++++++++++++++++++++
 pages.pt_BR/common/clear.md           | 20 ++++++++++++++++
 5 files changed, 131 insertions(+)
 create mode 100644 pages.pt_BR/common/[.md
 create mode 100644 pages.pt_BR/common/arduino-builder.md
 create mode 100644 pages.pt_BR/common/arduino.md
 create mode 100644 pages.pt_BR/common/bash.md
 create mode 100644 pages.pt_BR/common/clear.md

diff --git a/pages.pt_BR/common/[.md b/pages.pt_BR/common/[.md
new file mode 100644
index 000000000..52343a512
--- /dev/null
+++ b/pages.pt_BR/common/[.md
@@ -0,0 +1,25 @@
+# [
+
+> Avalia condição.
+> Retorna 0 se a condição for verdadeira, 1 se for falsa.
+> Mais informações: <https://www.gnu.org/software/coreutils/test>.
+
+- Testa se uma determinada variável é igual a uma determinada string:
+
+`[ "{{$VARIAVEL}}" == "{{/bin/zsh}}" ]`
+
+- Testa se uma determinada variável é vazia:
+
+`[ -z "{{$GIT_BRANCH}}" ]`
+
+- Testa se um arquivo existe:
+
+`[ -f "{{caminho/para/arquivo}}" ]`
+
+- Testa se um diretório não existe:
+
+`[ ! -d "{{caminho/para/diretorio}}" ]`
+
+- Declaração de if-else:
+
+`[ {{condicao}} ] && {{echo "verdadeiro"}} || {{echo "falso"}}`
diff --git a/pages.pt_BR/common/arduino-builder.md b/pages.pt_BR/common/arduino-builder.md
new file mode 100644
index 000000000..8b7393644
--- /dev/null
+++ b/pages.pt_BR/common/arduino-builder.md
@@ -0,0 +1,25 @@
+# arduino-builder
+
+> Uma ferramenta de linha de comando para compilar sketches do arduino.
+> AVIDO DE OBSOLESCÊNCIA: Esta ferramenta está sendo descontinuada e substituida pelo `arduino`.
+> Mais informações: <https://github.com/arduino/arduino-builder>.
+
+- Compilar um sketch:
+
+`arduino-builder -compile {{caminho/para/sketch.ino}}`
+
+- Definir o nível de debug (1 a 10, o padrão é 5):
+
+`arduino-builder -debug-level {{nivel}}`
+
+- Definir um diretório de compilação customizado:
+
+`arduino-builder -build-path {{caminho/para/diretorio}}`
+
+- Usar um arquivo com as opções de compilação, em vez de especificar `--hardware`, `--tools`, etc. manualmente toda hora:
+
+`arduino-builder -build-options-file {{caminho/para/build.options.json}}`
+
+- Habilitar o modo verboso:
+
+`arduino-builder -verbose {{true}}`
diff --git a/pages.pt_BR/common/arduino.md b/pages.pt_BR/common/arduino.md
new file mode 100644
index 000000000..3a54c0d1f
--- /dev/null
+++ b/pages.pt_BR/common/arduino.md
@@ -0,0 +1,28 @@
+# arduino
+
+> Arduino Studio - Ambiente de Desenvolvimento Integrado para a plataforma Arduino.
+> Mais informações: <https://github.com/arduino/Arduino/blob/master/build/shared/manpage.adoc>.
+
+- Compilar um sketch:
+
+`arduino --verify {{caminho/para/arquivo.ino}}`
+
+- Compilar e enviar sketch:
+
+`arduino --upload {{caminho/para/arquivo.ino}}`
+
+- Compilar e enviar sketch para um Arduino Nano com uma CPU Atmega328p, conectada na porta `/dev/ttyACM0`:
+
+`arduino --board {{arduino:avr:nano:cpu=atmega328p}} --port {{/dev/ttyACM0}} --upload {{caminho/para/arquivo.ino}}`
+
+- Definir a preferência `nome` para um determinado `valor`:
+
+`arduino --pref {{nome}}={{valor}}`
+
+- Compilar um sketch, colocar o resultado da compilação no diretório de compilação, e reutilizar qualquer resultado pre-existente neste diretório:
+
+`arduino --pref build.path={{caminho/para/diretório}} --verify {{caminho/para/arquivo.ino}}`
+
+- Salvar todas as preferências (alteradas) para `preferences.txt`:
+
+`arduino --save-prefs`
diff --git a/pages.pt_BR/common/bash.md b/pages.pt_BR/common/bash.md
new file mode 100644
index 000000000..c7372fa60
--- /dev/null
+++ b/pages.pt_BR/common/bash.md
@@ -0,0 +1,33 @@
+# bash
+
+> Bourne-Again SHell, um interpretador de linha de comando compatível com `sh`.
+> Veja também `histexpand` para a expansão do histórico.
+> Mais informações: <https://gnu.org/software/bash/>.
+
+- Iniciar uma seção interativa do shell:
+
+`bash`
+
+- Executar um comando e sair:
+
+`bash -c "{{comando}}"`
+
+- Executar um script:
+
+`bash {{caminho/para/script.sh}}`
+
+- Executar um script, exibindo cada comando antes de executá-lo:
+
+`bash -x {{caminho/para/script.sh}}`
+
+- Executar os comandos de um script, parando de executar no primeiro erro:
+
+`bash -e {{caminho/para/script.sh}}`
+
+- Ler e executar comandos do stdin (entrada padrão):
+
+`bash -s`
+
+- Exibir a versão do Bash (`$BASH_VERSION` abrange apenas a versão sem informações da licença):
+
+`bash --version`
diff --git a/pages.pt_BR/common/clear.md b/pages.pt_BR/common/clear.md
new file mode 100644
index 000000000..07930baaf
--- /dev/null
+++ b/pages.pt_BR/common/clear.md
@@ -0,0 +1,20 @@
+# clear
+
+> Limpa a tela do terminal.
+> Mais informações: <https://manned.org/clear>.
+
+- Limpar a tela (equivalente a apertar Control-L no terminal Bash):
+
+`clear`
+
+- Limpar a tela mantendo o buffer de rolagem do terminal:
+
+`clear -x`
+
+- Especificar o tipo de terminal a ser limpado (por padrão é o valor da variável de ambiente `TERM`):
+
+`clear -T {{tipo_do_terminal}}`
+
+- Mostra a versão do `ncurses` usado pelo `clear`:
+
+`clear -V`