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, pode pular este capítulo e ir direto para o capítulo Como a internet funciona.

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 :

• 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.
• 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. 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).

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:

Instale o Python

Para leitoras em casa: esse capítulo é abordado no vídeo Instalando Python & Editor de Código.

Esta seção baseia-se em tutoriais das Geek Girls 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.

$ python3 --version
Python 3.6.1

$ grep ^NAME= /etc/os-release

$ sudo apt install python3

$ sudo dnf install python3

$ sudo zypper install python3

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

command-line

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

Baixe-o aqui

Gedit

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

Baixe-o aqui

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

Atom

Atom é outro editor popular. É gratuito, aberto e disponível para Windows, OS X e Linux. Atom é desenvolvido por GitHub.

Baixe-o aqui

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 (Rich Text Format, ou Formato de Texto Rico, em português).

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

Parte deste capítulo é baseada em tutorial django-marcador 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).

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

C:\Users\Name\djangogirls> python -m venv myvenv

$ python3 -m venv myvenv

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

C:\Users\Name\djangogirls> myvenv\Scripts\activate

$ source myvenv/bin/activate

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

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

É 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

$ sudo apt install git

$ sudo dnf install git

$ sudo zypper install git

Crie uma conta no GitHub

Vá para 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

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:

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:

• Como a internet funciona

• Introdução à linha de comando

• Introdução ao Python

• O que é Django?

Aproveite o workshop!

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