R peralva/pythonturtle (#439)

* Translated Java: Basics

Translated to Brazilian Portuguese.

* Deleting Java Basics

* lets review python turtle

* Update _index.md

* Update activity-2.md

* Update activity-4.md

* Update activity-9.md

* Update the-basics.md

* Update using-trinket.md

---------

Co-authored-by: Henrique Eulálio <[email protected]>

content/brazilian-portuguese/python-turtle/_index.md

@@ -0,0 +1,24 @@
+---
+title: "Python: Codificando com Turtle"
+description: "Aprenda a desenhar em uma tela com Python com Turtle"
+date: 2019-07-25T13:24:17-07:00
+prereq: "Python: Fundamentos"
+difficulty: "Iniciante"
+image: ""
+draft: false
+icon: "fab fa-python"
+---
+
+## Introdução
+
+Bem-vindo à Colmeia Nuevo! Você chegou na hora certa para ajudar nosso novo bebê abelha Alex.
+
+![animação do bebê abelha Alex](https://media1.giphy.com/media/ozjz5omKqJYex8CaDV/giphy.gif)
+
+Alex mora em um país chamado Ilhas Tartarugas. Os residentes das Ilhas Tartarugas falam uma linguagem chamada Python. Usaremos Python para ensinar Alex como viver em uma colmeia. Você está pronto para o desafio? Neste tutorial, aprenderemos como usar a linguagem Python para ajudar Alex a se tornar uma abelha ocupada!
+
+## Tabela de Conteúdos
+<details>
+<summary>Seções</summary>
+{{% children /%}}
+</details>

content/brazilian-portuguese/python-turtle/activity-1.md

@@ -0,0 +1,26 @@
+---
+title: "Atividade 1 – Desenhar um quadrado"
+date: 2019-07-25T13:24:17-07:00
+weight: 3
+draft: false
+---
+
+![alt text height="600px" width="30%"](../media/bee_square.png "Abelha imaginando um quadrado")
+
+Parabéns! Você ajudou Alex a traçar um limite! Agora vamos intensificar e ajudar Alex a desenhar um quadrado. Para desenhar um quadrado, precisamos seguir estes passos:
+
+1. Avance 50 passos
+2. Vire à esquerda 90 graus
+3. Avance 50 passos
+4. Vire à esquerda 90 graus
+5. Avance 50 passos
+6. Vire à esquerda 90 graus
+7. Avance 50 passos
+
+Lembre-se de usar `turtle.forward()` para desenhar linhas. Para virar 90 graus para a esquerda, você precisa passar `90` como argumento para o método `turtle.left()`:
+
+``` python
+turtle.left(90)
+```
+
+<iframe src="https://trinket.io/embed/python/bfe791bb1e" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-10.md

@@ -0,0 +1,22 @@
+---
+title: "Atividade 10 – Randomizando a cor das pétalas da sua mandala"
+date: 2019-07-25T13:24:17-07:00
+weight: 13
+draft: false
+---
+
+![texto alternativo width="70%"](../media/mandala-color.png "flor mandala com pétalas de cores aleatórias")
+
+Definimos com sucesso a cor da flor da mandala para um valor RGB. Agora, vamos explorar a mudança da cor das pétalas individuais das flores da mandala.
+
+Faremos uso da biblioteca `random` do python. O método `random.randint()` nos permite escolher um valor aleatório para cada valor de vermelho, verde ou azul. Para escolher um valor entre 0 inclusivo e 256 exclusivo (em outras palavras, entre 0 e 255 inclusivo), precisamos usar `random.randint(0, 256)`.
+
+Use `random.randint(0, 256)` três vezes para produzir três valores aleatórios e insira-os no método `turtle.color()`. Agora você deve conseguir ver uma flor de mandala multicolorida! Esta é definitivamente uma flor da qual Alex estaria interessado em coletar néctar!
+
+<iframe src="https://trinket.io/embed/python/64ab3455ae" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>
+<br>
+<br>
+
+Parabéns! Você ajudou Alex a fazer um favo de mel e uma flor! Ele agora pode viver feliz em sua colméia e produzir muito mel! Sua imagem final deverá ficar mais ou menos assim:
+
+![texto alternativo width="70%"](../media/turtle-honeycomb-flower.png "produto final")

content/brazilian-portuguese/python-turtle/activity-11.md

@@ -0,0 +1,16 @@
+---
+title: "Atividade 11 – Agora é a sua vez!"
+date: 2019-07-25T13:24:17-07:00
+weight: 14
+draft: false
+---
+
+Se sobrar algum tempo, tente desenhar suas próprias formas e desenhos! Torne sua imagem interessante usando várias formas e cores.
+
+Clique no botão abaixo para abrir uma nova janela em branco do Trinket para iniciar sua criação.
+
+<a class="my-2 mx-4 btn btn-info" href="https://trinket.io/library/trinkets/create?lang=python3" target="_blank">Clique aqui</a>
+
+## Socorro, estou preso!
+
+Preso? Verifica o [Gabarito](../answer-key) para a atividade na qual você está preso!

content/brazilian-portuguese/python-turtle/activity-2.md

@@ -0,0 +1,42 @@
+---
+title: "Atividade 2 – Simplificando código com loops"
+date: 2019-07-25T13:24:17-07:00
+weight: 4
+draft: false
+---
+
+Ótimo! Você desenhou um quadrado. Mas observe que estamos escrevendo as mesmas linhas repetidamente! Tivemos que repetir as instruções para traçar uma linha e virar à esquerda 4 vezes. Não seria ótimo se pudéssemos dar instruções uma vez e dizer ao programa para repeti-las 4 vezes? Nós podemos!
+
+Para fazer isso, precisamos usar loops. Os loops executam um conjunto de instruções várias vezes. Para ver isso em ação, aqui está um exemplo de código que desenha um triângulo:
+
+``` python
+for i in range(3):
+  turtle.forward(50)
+  turtle.left(120)
+```
+
+Vamos entender o que esse código faz. `for i in range(3):` Esta instrução diz ao programa para executar as instruções em um loop. `range(3)` define um limite para quantas vezes o loop é executado (neste caso, 3 vezes). A letra `i` é chamada de **variável**. É usado para controlar quantas vezes executamos o conteúdo do loop.
+
+{{% notice warning %}}
+
+## Sintaxe complicada do Python - Parte 1
+
+**Sintaxe** é como escrevemos linguagens para que sejam compreensíveis. Em português, temos regras ortográficas e gramaticais para ajudar a entender uns aos outros. Da mesma forma, a linguagem Python possui regras de sintaxe para que o computador possa entender nosso código.
+
+Primeiro, observe que no final da linha com `for`, adicionamos dois pontos (`:`); isso significa que a próxima linha fará parte do loop `for`. O computador irá reclamar se você esquecer o `:`!
+
+Além disso, adicionamos uma tabulação na frente de algumas linhas de código no exemplo acima. A tabulação informa ao computador que essas instruções são consideradas parte do loop `for`.
+
+Para ver a grande diferença que isso faz, dê uma olhada no código abaixo. Como removemos a tabulação na frente de `turtle.left(120)`, o código não funcionará mais conforme esperado. Agora, repetimos `turtle.forward(50)` apenas três vezes e, em vez disso, obtemos uma linha reta!
+
+``` python
+for i in range(3):
+  turtle.forward(50)
+turtle.left(120)
+```
+
+{{% /notice %}}
+
+Agora, pegue o código de exemplo que fornecemos e modifique-o ligeiramente para que, em vez de desenhar um triângulo, desenhe um quadrado. Você pode relembrar o que fez na Atividade 1 como uma dica.
+
+<iframe src="https://trinket.io/embed/python/892913b49a" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-3.md

@@ -0,0 +1,22 @@
+---
+title: “Atividade 3 – Desenhando um hexágono”
+date: 2019-07-25T13:24:17-07:00
+weight: 5
+draft: false
+---
+
+![Tartaruga, animação hexágono](https://media.giphy.com/media/TDLqC61A5uOAO8WwnJ/giphy.gif)
+
+Bom trabalho! Você acabou de desenhar sua primeira forma em Python com Turtle! Agora vamos alterar ligeiramente o código que já escrevemos para desenhar um quadrado e, em vez disso, desenhar um hexágono. Afinal, Alex é uma abelha e precisa desenhar hexágonos para construir seu primeiro favo de mel.
+
+Para ajudá-lo a desenhar um hexágono, pense em quantos lados um hexágono tem. Quantos graus existem em cada ângulo de um hexágono?
+
+Como um lembrete útil, este é o código usado para criar um triângulo:
+
+``` python
+for i in range(3):
+  turtle.forward(50)
+  turtle.left(120)
+```
+
+<iframe src="https://trinket.io/embed/python/e82295e92f" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-4.md

@@ -0,0 +1,79 @@
+---
+title: "Atividade 4 – Simplificando código com funções"
+date: 2019-07-25T13:24:17-07:00
+weight: 6
+draft: false
+---
+
+Desenhamos um hexágono. Mas este é apenas um dos muitos hexágonos que Alex precisa para construir seu favo de mel. Mais uma vez, parece que teríamos que repetir o código muitas vezes para desenhar vários hexágonos. Felizmente, não precisamos! As funções vieram para nos resgatar!
+
+{{% notice tip %}}
+
+## Funções
+
+Uma função é uma forma de agrupar linhas de código para fazer algo. Por exemplo, `turtle.forward(50)` move a tartaruga 50 passos para frente e `turtle.left(120)` gira a tartaruga 120 graus para a esquerda. E se quisermos sempre fazer essas duas ações juntas? Podemos colocá-las em uma função chamada `draw_line()`, de modo que sempre que esta função for chamada, ambas as ações ocorram simultaneamente. Pense nisso como uma receita: compilamos todas as instruções juntas e o nome da receita é a comida que estamos preparando.
+
+{{% /notice %}}
+
+Aqui está um exemplo de **definição de função** e como a usaríamos:
+
+``` python
+def draw_line():
+  turtle.forward(50)
+  turtle.left(120)
+```
+
+A primeira linha é chamada de definição de função **cabeçalho**. A palavra-chave `def` informa ao computador que estamos definindo uma nova função. A seguir, damos um nome à função, neste caso `draw_line`. Por fim, não se esqueça do `():` no final da linha, que informa ao computador que estamos iniciando o corpo da função.
+
+{{% notice tip %}}
+
+## Material extra - parâmetros
+
+Dentro dos parênteses `()` normalmente definiríamos **parâmetros** para a função. Parâmetros são entradas que podemos fornecer à função, que a função pode usar para produzir sua saída. Por exemplo, precisamos ter dois números para somá-los e produzir um resultado - os dois números que usamos podem ser considerados **parâmetros**. Hoje não usaremos parâmetros e deixaremos como `()`.
+
+{{% /notice %}}
+
+Semelhante a um loop for, qualquer coisa que desejemos definir dentro da função precisa ser precedida por 1 tabulação.
+
+Se você pressionar **run** apenas com este código, notará que não verá nenhuma saída! Apenas criamos as funções, mas precisamos usá-las. Para usar a função que criamos, digite `draw_line()` novamente, mas sem o `def`.
+
+``` python
+def draw_line():    # Definição da função
+  turtle.forward(50)
+  turtle.left(120)
+
+draw_line()         # Chamada de função
+```
+
+Isso é chamado de **chamada de função** para a função `draw_line()`. Uma chamada de função executa o código definido na função com o mesmo nome. Com a analogia da receita, pense nisso como uma execução real da receita.
+
+{{% notice info %}}
+
+## Dicas
+
+1. Sempre certifique-se de que os nomes de suas funções sejam descritivos o suficiente para explicar o que o código da função faz.
+2. Sua chamada de função deve estar abaixo da definição da função.
+
+{{% /notice %}}
+
+{{% notice warning %}}
+
+## Sintaxe complicada do Python - Parte 2
+
+Observe que as funções usam regras de sintaxe semelhantes com loops `for` - você deve ter um `:` no final da declaração da função, e qualquer coisa no corpo da função precisa começar com uma tabulação.
+
+O que acontece quando você precisa de um loop `for` dentro de uma função? Então, você precisa combinar as regras! Aqui está um exemplo de como colocar corretamente um loop `for` dentro de uma função.
+
+``` python
+def draw_line():
+  for i in range(3):
+    turtle.forward(50)
+```
+
+Observe que `turtle.forward(50)` tem 2 tabulações na frente dele, porque está dentro de uma definição de função e dentro de um loop `for`!
+
+{{% /notice %}}
+
+Então, vamos tentar fazer nossa própria função `draw_hexagon()`! Lembre-se de incluir o cabeçalho de definição da função, o número de lados que um hexágono possui e o ângulo associado a um hexágono: 60 graus.
+
+<iframe src="https://trinket.io/embed/python/c3ef894658" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-5.md

@@ -0,0 +1,20 @@
+---
+title: "Atividade 5 – Desenhando um favo de mel"
+date: 2019-07-25T13:24:17-07:00
+weight: 7
+draft: false
+---
+
+![texto alternativo height="600px" width="30%"](../media/bee_honeycomb.png "Desenho de favo de mel")
+
+Este é o final! Vamos criar o favo de mel onde Alex viverá. Felizmente, este favo de mel tem apenas 6 hexágonos, então vamos combinar nosso conhecimento de funções e loops para fazer nosso favo de mel!
+
+Nesta atividade, crie uma nova função chamada `draw_honeycomb()`. Dentro do corpo da função, crie um loop que se repete 6 vezes. Dentro do loop temos que primeiro desenhar um hexágono usando nossa função `draw_hexagon()` que definimos anteriormente. Em seguida, mova a tartaruga para que ela desenhe o próximo hexágono. Para fazer isso, depois que a tartaruga desenhar cada hexágono, precisamos dizer à nossa tartaruga para avançar **50 pixels** e depois virar para a direita **60 graus**.
+
+Observe que o desenho do favo de mel pode demorar um pouco. Você pode alterar a rapidez com que a tartaruga desenha o favo de mel definindo a velocidade da tartaruga para um número entre `1` e `10`, sendo `1` o mais lento e `10` o mais rápido. Coloque este código perto de onde mudamos a cor da tartaruga.
+
+``` python
+turtle.speed(8)
+```
+
+<iframe src="https://trinket.io/embed/python/d83811c24a" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-6.md

@@ -0,0 +1,47 @@
+---
+title: “Atividade 6 – Movendo a tartaruga”
+date: 2019-07-25T13:24:17-07:00
+weight: 9
+draft: false
+---
+
+![texto alternativo height="600px" width="30%"](../media/bee_turtle_chat.png "Conversa entre tartaruga e abelha")
+
+Nosso primeiro passo é desenhar uma colmeia menor para que possamos desenhar tanto a colmeia quanto a flor na tela. Já fizemos isso para você - você viu o que mudamos para desenhar uma colmeia menor?
+
+``` python
+def draw_hexagon():
+  for i in range(6):
+    turtle.forward(20)
+    turtle.left(60)
+
+def draw_honeycomb():
+  for i in range(6):
+    draw_hexagon()
+    turtle.forward(20)
+    turtle.right(60)
+```
+
+Em seguida, precisamos mover a tartaruga para um novo local para desenhar a flor (não queremos desenhar a flor em cima da colmeia!). Para fazer isso, primeiro precisamos usar os seguintes métodos:
+
+``` python
+turtle.penup() 
+turtle.goto(x,y)
+turtle.pendown()
+```
+
+`turtle.penup()` diz à tartaruga para pegar sua caneta para não desenhar enquanto estiver se movendo. Então, com `turtle.goto(x,y)`, estamos dizendo à tartaruga a posição para onde ela se move. Depois disso, dizemos à tartaruga para colocar a caneta de volta no lugar usando `turtle.pendown()` para que ela possa começar a desenhar novamente.
+
+![texto alternativo height="600px" width="50%"](../media/graph.png "Gráfico")
+
+{{% notice info %}}
+
+## Dica
+
+Os `x` e `y` no método `turtle.goto()` são as coordenadas `x` e `y` da tartaruga. Queremos mudar as coordenadas `x` e `y` da tartaruga de `(0, 0)` que é o centro da imagem, para algum lugar um pouco mais distante para que a flor da mandala não cubra parte do favo de mel.
+
+{{% /notice %}}
+
+Para completar esta atividade, mova a tartaruga para a posição (100, 100) na tela. Isso o moverá para o canto superior direito.
+
+<iframe src="https://trinket.io/embed/python/dee0f642ce" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-7.md

@@ -0,0 +1,22 @@
+---
+title: "Atividade 7 - Desenhando uma figura 8"
+date: 2019-07-25T13:24:17-07:00
+weight: 10
+draft: false
+---
+
+![texto alternativo width="70%"](../media/turtle_circles.png "desenhando uma figura 8")
+
+Ótimo! Agora vamos fazer um número 8 como primeiro passo para fazer uma flor de mandala! A figura 8 são apenas dois círculos opostos um ao outro.
+Para fazer isso podemos usar o método `turtle.circle(x)`, que assume um número inteiro `x` como o raio do círculo. (Você deve se lembrar que `2 * raio` é a largura do círculo.) Ter o raio como um **argumento** significa que podemos decidir quão grande ou pequeno o círculo deve ser.
+
+``` python
+  import turtle
+  turtle.circle(20)
+```
+
+No exemplo acima, o círculo tem 40 pixels de largura e é desenhado no sentido anti-horário. Se o argumento para `turtle.circle()` for negativo, então o círculo é desenhado no sentido horário e é oposto à versão original.
+
+Usando essas informações, crie uma nova função chamada `figure_8()` que desenha uma figura 8.
+
+<iframe src="https://trinket.io/embed/python/e87cb9f3b9" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-8.md

@@ -0,0 +1,14 @@
+---
+title: "Atividade 8 – Criando uma flor mandala"
+date: 2019-07-25T13:24:17-07:00
+weight: 11
+draft: false
+---
+
+![texto alternativo height="600px" width="30%"](../media/bee_happy.png "Abelha feliz")
+
+Terminamos de criar nossa primeira figura 8! Agora podemos usar a função `figure_8()` para criar uma flor de mandala! Uma flor de mandala consiste em muitos números 8 colocados uns sobre os outros em ângulos diferentes. Então, para fazer isso precisamos usar um... você adivinhou, um loop!
+
+Crie uma nova função chamada `mandala_flower()`. No loop, chamaremos a função `figure_8()` que escrevemos anteriormente para criar uma figura 8. Em seguida, gire a tartaruga para a esquerda ou para a direita em um certo número de graus (por exemplo, 10 graus). Repita essas etapas várias vezes para fazer uma flor de mandala; é uma boa ideia criar um loop que se repita pelo menos 25 vezes.
+
+<iframe src="https://trinket.io/embed/python/b82ce0c14f" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>

content/brazilian-portuguese/python-turtle/activity-9.md

@@ -0,0 +1,23 @@
+---
+title: "Atividade 9 – Colorindo sua flor mandala"
+date: 2019-07-25T13:24:17-07:00
+weight: 12
+draft: false
+---
+
+![texto alternativo width="70%"](../media/mandala-blue.png "flor mandala com pétalas azuis")
+
+Agora que temos o formato de uma flor de mandala, é hora de colori-la! Ainda usaremos o método `turtle.color()`; entretanto, desta vez usaremos um valor RGB em vez de um valor string para representar a cor, para que dessa forma possamos produzir uma variedade maior de cores.
+{{% notice tip %}}
+
+## Cores RGB (vermelho-verde-azul)
+
+Na escola primária, você deve se lembrar que, ao misturar cores, você pode produzir novas cores. Por exemplo, combinar vermelho e azul resulta em roxo. Também podemos alterar a quantidade de vermelho e azul misturados para criar diferentes tons de roxo. O computador faz algo semelhante para produzir cores. Combinando várias intensidades de vermelho, verde e azul, podemos criar diferentes cores, como azul claro, amarelo dourado e rosa salmão. Clique [aqui](https://htmlcolorcodes.com/color-names/) para ver as cores e sua forma hexadecimal correspondente.
+
+No método `turtle.color()`, podemos especificar três argumentos inteiros correspondentes à quantidade de vermelho, verde e azul a serem misturados. Cada número inteiro deve estar entre `0` e `255` inclusive. Um exemplo pode ser `turtle.color(30, 100, 238)`, que produz um tom escuro de azul.
+
+{{% /notice %}}
+
+Atualize sua flor de mandala para usar uma cor de sua preferência. Sinta-se à vontade para experimentar cores diferentes!
+
+<iframe src="https://trinket.io/embed/python/1f9c80fffe" width="100%" height="600" frameborder="0" marginwidth="0" marginheight="0" allowfullscreen></iframe>