01/02/2023 10:54 Instalação · HonKit

Se você estiver fazendo o tutorial em

casa
Se você estiver fazendo o tutorial em casa e não em um dos eventos Django Girls
(https://djangogirls.org/events/), pode pular este capítulo e ir direto para o capítulo
Como a internet funciona (../how_the_internet_works/).

Isso porque nós cobrimos a instalação dos itens a medida que eles são
necessários no tutorial -- Essa é apenas uma página adicional que reúne todas as
instruções de instalação em um só lugar (que é útil para alguns formatos de
oficinas). Você pode escolher instalar tudo que está nessa página nesse momento
se você quiser. Mas se você quer começar a aprender coisas antes de instalar um
monte de coisas no seu computador, pule este capítulo e nós explicaremos os
componentes de instalação para você mais tarde, a medida que são necessários.

Boa sorte!

Se você está participando de uma

oficina
Se você está participando de uma oficina de um Evento Django Girls
(https://djangogirls.org/events/):

Sua oficina pode ter um "grupo de instalação" antes da oficina principal. Se

você está com um grupo de instalação, essa página é para você! Siga as
instruções aqui contidas para ter tudo que precisa para a oficina instalada,
com a ajuda de instrutores, se necessário. Então, no workshop principal,
poderás saltar as intruções de instalação que encontrares no tutorial principal,
quando aparecerem.
A organização do workshop poderá ter-te perguntado se tentaste reslizar a
instalação no computador, em casa antes de vires para o workshop. Se te
oriposeram a isso, esta página é para ti! Siga as instruções. Então, no
workshop principal, quando chegar à etapa de instalação, se você ainda for
capaz de prosseguir você poderá pedir ajuda para a sua monitora.
https://tutorial.djangogirls.org/pt/installation/ 1/12
01/02/2023 10:54 Instalação · HonKit

Se o seu workshop não tem uma seção de instalação (ou você não a
consegue localizar) e os organizadores não lhe pedirem para tentar instalar
tudo antes que você chegue, pule esta página e vá direto para Como a
internet funciona (../how_the_internet_works/). Você irá instalar tudo o que
precisa no seguimento do tutorial.

Instalação
Neste tutorial, você irá criar um blog. Para fazer isso, ao longo do tutorial você
receberá instruções de como instalar diversos programas no seu computador e
configurar algumas contas online conforme necessário. Esta página reune as
instruções de instalação e registro em um só lugar (o que vai ser útil para a alguns
formatos de workshop).

Chromebook setup (if you're using one) 

Breve introdução à linha de comando

Vários dos passos abaixos referenciam o "console", "terminal", "janela de
comandos", ou "linha de comandos" - todos significam a mesma coisa: uma janela
no seu computador onde você pode inserir comandos. Quando você chegar ao
tutorial principal, você irá aprender mais sobre a linha de comandos. Por agora, a
coisa principal que você precisará saber é como abrir uma janela de comandos e
como ela se parece:

Opening: Windows 

Opening: OS X 

Opening: Linux 

https://tutorial.djangogirls.org/pt/installation/ 2/12
01/02/2023 10:54 Instalação · HonKit

Instale o Python
Para leitoras em casa: esse capítulo é abordado no vídeo Instalando Python
& Editor de Código (https://www.youtube.com/watch?v=pVTaqzKZCdA).

Esta seção baseia-se em tutoriais das Geek Girls Carrots

(https://github.com/ggcarrots/django-carrots
(https://github.com/ggcarrots/django-carrots))

Django é escrito em Python. Precisamos de Python para fazer qualquer coisa no

Django. Vamos começar por instalá-lo! Queremos que você instale a versão mais
recente do Python 3, então, se você tiver uma versão anterior, precisará atualizá-
la. Se você já tem versão 3.4 ou superior, deve estar bem.

Por favor, instale o Python normal da seguinte maneira, mesmo tenha o Anaconda
instalado no seu computador.

Install Python: Windows 

Install Python: OS X 

Install Python: Linux 

Install Python: Debian or Ubuntu 

Install Python: Fedora 

Install Python: openSUSE 

Verifique se a instalação foi bem sucedida abrindo o terminal e digitando o

comando python3 :

command-line
https://tutorial.djangogirls.org/pt/installation/ 3/12
01/02/2023 10:54 Instalação · HonKit

$ python3 --version
Python 3.6.1

A versão mostrada pode ser diferente da versão 3.6.1 -- deve corresponder à

versão que você instalou.

Observação: Se você estiver no Windows e receber uma mensagem de erro

dizendo que o python3 não foi encontrado, tente utilizar python (sem o 3 ) e
verifique se ela corresponde à versão Python 3.4.

Se você tem alguma dúvida ou se alguma coisa deu errado e você não tem a
menor ideia do que fazer, pergunte à sua monitora! Nem sempre tudo sai
conforme o esperado e é melhor pedir ajuda a alguém mais experiente.

Instale um editor de código

Existem muitos editores de código diferentes e escolher um trata-se
essencialmente de preferência pessoal. A maioria dos programadores de Python
usa os complexos, mas extremamente poderosos IDEs (Integrated Development
Environments, ou, em português, Ambientes de Desenvolvimento Integrado), tais
como o PyCharm. Para um iniciante, entretanto, estas IDEs não são muito
adequadas; nossas recomendações são igualmente poderosas, mas bem mais
simples.

Nossas sugestões estão logo abaixo, mas sinta-se livre para perguntar à sua
monitora quais são suas preferências - será mais fácil escolher com a ajuda dela.

Visual Studio Code

O Visual Studio Code é um editor de código desenvolvido pela Microsoft para
Windows, Linux e macOS. Inclui suporte para depuração, controle Git incorporado,
destaque de sintaxe, conclusão de código inteligente, snippets e reação de
código.
https://tutorial.djangogirls.org/pt/installation/ 4/12
01/02/2023 10:54 Instalação · HonKit

Baixe-o aqui (https://code.visualstudio.com/download)

Gedit
Gedit é um editor open-source, gratuito, disponível para todos os sistemas
operacionais.

Baixe-o aqui (https://wiki.gnome.org/Apps/Gedit#Download)

Sublime Text
O Sublime Text é um editor muito popular. Ele tem um período de avaliação
gratuito e está disponível para vários sistemas operacionais.

Baixe-o aqui (https://www.sublimetext.com/)

Atom
Atom é outro editor popular. É gratuito, aberto e disponível para Windows, OS X e
Linux. Atom é desenvolvido por GitHub (https://github.com/).

Baixe-o aqui (https://atom.io/)

Por que estamos instalando um editor de

código?
Você deve estar se perguntando porque estamos instalando esse software editor
de código específico ao invés de usar algo como Word ou Bloco de Notas.

A primeira razão é que o código precisa estar em texto puro, sem formatação, e
programas como o Word e o Textedit não produzem texto puro de fato. Eles
produzem texto rico (com fontes e formatação), usando formatos personalizados,
como RTF (https://en.wikipedia.org/wiki/Rich_Text_Format) (Rich Text Format, ou
Formato de Texto Rico, em português).

https://tutorial.djangogirls.org/pt/installation/ 5/12
01/02/2023 10:54 Instalação · HonKit

A segunda razão é que editores de código são especializados em edição de

código, então eles possuem funcionalidades úteis, como destacar o código com
cores de acordo com seu significado ou fechar aspas automaticamente.

Veremos tudo isso em ação mais pra frente. Logo, logo, seu bom e velho editor de
código será uma de suas ferramentas preferidas. :)

Configure o virtualenv e instale o

Django
Esta seção baseia-se em tutoriais da Geek Girls Carrots
(https://github.com/ggcarrots/django-carrots
(https://github.com/ggcarrots/django-carrots)).

Parte deste capítulo é baseada em tutorial django-marcador (http://django-

marcador.keimlink.de/) licenciado sob Creative Commons Attribution-
ShareAlike 4.0 International License. O tutorial do django-marcador é
protegido por direitos autorais por Markus Zapke-Gründemann et al.

Ambiente virtual
Antes de instalar o Django, vamos instalar uma ferramenta muito útil para ajudar a
manter o ambiente de trabalho no nosso computador organizado. Você pode pular
esse passo, mas ele é altamente recomendado. Começar com a melhor instalação
possível poupará você de muito trabalho no futuro!

Vamos criar um ambiente virtual (também chamado um virtualenv). O virtualenv

isolará seu código Python/Django em um ambiente organizado por projetos. Isso
significa que as alterações que você fizer em um website não afetarão os outros
projetos que você estiver desenvolvendo ao mesmo tempo. Legal, né?

Tudo o que você precisa fazer é encontrar o diretório em que você quer criar o
virtualenv ; seu diretório Home, por exemplo. No Windows, pode aparecer como
C:\Users\Name (onde Nome é seu usuário de login).

https://tutorial.djangogirls.org/pt/installation/ 6/12
01/02/2023 10:54 Instalação · HonKit

Observação: No Windows, certifique-se de que esse diretório não contém

palavras acentuadas ou caracteres especias; se o seu usuário contém
caracteres acentuados, use um diretório diferente, por exemplo:
C:\djangogirls .

Para este tutorial, usaremos um novo diretório djangogirls no seu diretório

home:

command-line

$ mkdir djangogirls
$ cd djangogirls

Vamos fazer um virtualenv chamado meuenv . O formato geral desse comando é:

command-line

$ python3 -m venv myvenv

Virtual environment: Windows 

Virtual environment: Linux and OS X 

Trabalhando com o virtualenv

O comando acima criará um diretório chamado myvenv (ou qualquer que seja o
nome que você escolheu) que contém o nosso ambiente virtual (basicamente um
conjunto de diretórios e arquivos).

Working with virtualenv: Windows 

Working with virtualenv: Linux and OS X 

https://tutorial.djangogirls.org/pt/installation/ 7/12
01/02/2023 10:54 Instalação · HonKit

Você vai saber que tem um virtualenv funcionando quando vir que a linha de
comando no seu console tem o prefixo (myvenv) .

Ao trabalhar em de um ambiente virtual, o comando python irá automaticamente

se referir à versão correta para que você possa digitar python em vez de
python3 .

Pronto, já temos todas as dependências importantes no lugar. Finalmente

podemos instalar o Django!

Instalando o Django
Agora que você tem seu virtualenv ativo, pode instalar o Django.

Antes de fazer isto, devemos garantir que temos instalada a última versão do
pip , que é o software que usamos para instalar o Django:

command-line

(myvenv) ~$ python -m pip install --upgrade pip

Instalando pacotes com requisitos

O arquivo "requirements.txt" guarda as depenências que serão instaladas
utilizando o pip install :

Primeiro, crie um arquivo requirements.txt dentro da sua pasta djangogirls/

usando o editor de código que você instalou mais cedo. Para fazer isso, abra um
novo arquivo no editor e salve-o como requirements.txt na pasta djangogirls .
O seu diretório vai parecer com isso:

djangogirls
└───requirements.txt

E adicione o seguinte texto ao arquivo djangogirls/requirements.txt :

djangogirls/requirements.txt

https://tutorial.djangogirls.org/pt/installation/ 8/12
01/02/2023 10:54 Instalação · HonKit

Django~=3.2.10

Agora, execute pip install -r requirements.txt para instalar o Django.

command-line

(myvenv) ~$ pip install -r requirements.txt

Collecting Django~=3.2.10 (from -r requirements.txt (line 1))
Downloading Django-3.2.10-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-3.2.10

Installing Django: Windows 

Installing Django: Windows 8 and Windows 10 

Installing Django: Linux 

É isto! Você agora (finalmente) está pronta para criar uma aplicação Django!

Instale o Git
O Git é um "sistema de controle de versão" usado por muitos programadores. Este
software pode acompanhar mudanças em arquivos ao longo do tempo para que
você possa recuperar versões específicas mais tarde. É parecido com o recurso
"Controlar Alterações" dos processadores de texto (e.x Microsoft Word ou Libre
Writer), mas muito mais poderoso.

Instalando o Git

Installing Git: Windows 

https://tutorial.djangogirls.org/pt/installation/ 9/12
01/02/2023 10:54 Instalação · HonKit

Installing Git: OS X 

Installing Git: Debian or Ubuntu 

Installing Git: Fedora 

Installing Git: openSUSE 

Crie uma conta no GitHub

Vá para GitHub.com (https://www.github.com) e registre uma nova conta, de
graça. Assegure-se de lembrar a sua senha (e a adicione ao seu gerenciador de
senhas, caso você tenha um).

Crie uma conta no PythonAnywhere

PythonAnywhere é um serviço para execução de código Python em servidores "na
nuvem". Nós vamos utilizá-lo para hospedar nosso site e deixá-lo no ar na
internet.

Vamos hospedar o blog que estamos construindo no PythonAnywhere. Cadastre

uma conta "Begginer" (de iniciante) no PythonAnywhere (o pacote gratuito é
suficiente, você não precisa de um cartão de crédito).

www.pythonanywhere.com (https://www.pythonanywhere.com/)

Página do PythonAnywhere mostrando o botão para criar a conta "Beginner"

(iniciante)

https://tutorial.djangogirls.org/pt/installation/ 10/12
01/02/2023 10:54 Instalação · HonKit

Observação Quando escolher seu nome de usuário no PythonAnywhere,

lembre que a URL do blog será seunomedeusuário.pythonanywhere.com , então
use algo como o seu apelido ou um nome que descreva o assunto do blog.
Além disso, certifique-se de lembrar sua senha (adicione-a ao seu
gerenciador de senhas, se você usar um).

Criando um token de API do

PythonAnywhere
Você só precisará fazer isso uma vez. Depois de se registrar no PythonAnywhere,
você será levada ao seu painel de controle. Encontre o link para a página de
"Account" (conta, em português) próximo ao topo no lado direito:

Link para a conta no topo direito na página

em seguida, selecione a guia chamada "API Token" e aperte o botão que diz
"Create new API token" (criar novo token API").

Comece a ler
Parabéns, você tem tudo configurado e pronto para começar! Se você ainda tem
algum tempo antes do workshop, seria útil começar a ler alguns dos capítulos de
início:

https://tutorial.djangogirls.org/pt/installation/ 11/12
01/02/2023 10:54 Instalação · HonKit

Como a internet funciona (../how_the_internet_works/)

Introdução à linha de comando (../intro_to_command_line/)

Introdução ao Python (../python_introduction/)

O que é Django? (../django/)

Aproveite o workshop!
Quando você começar a oficina, já será capaz de ir direto para o seu primeiro
projeto Django! (../django_start_project/) porque já vai ter visto todo o material dos
capítulos anteriores.

https://tutorial.djangogirls.org/pt/installation/ 12/12