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

Isto porque cobrimos estas coisas no tutorial de qualquer maneira, e esta é apenas uma página adicional que reúne todas as instruções de instalação em um só lugar. O evento Django Girls inclui uma "noite de instalação" quando instalamos tudo que vamos precisar durante o workshop, então essa seção é útil para nós.

Se você achar útil, pode continuar lendo este capítulo também. Mas se quiser começar a aprender antes de instalar um monte de coisas no seu computador, pule este capítulo e explicaremos a parte de instalação para você mais tarde.

Boa sorte!

Instalação

No workshop, você construirá um blog. No tutorial, aprecem certas tarefas de configuração que você deve fazer antes para estar pronta para escrever códigos no dia do evento.

Chromebook setup (if you're using one)
Você pode [pular este capítulo](http://tutorial.djangogirls.org/en/installation/#install-python) se não estiver usando um Chromebook. Caso esteja, sua experiência de instalação será um pouco diferente. Você pode ignorar o restante das instruções de instalação. ### Cloud 9 Cloud 9 é uma ferramenta que te dá um editor de código e acesso a um computador conectado à Internet onde você pode instalar, escrever e executar software. Durante o tutorial, o Cloud 9 atuará como sua *máquina local*. Você ainda estará executando comandos em uma interface de terminal, como seus colegas de classe no OS X, Ubuntu ou Windows, mas seu terminal estará conectado a um computador que está em algum outro lugar que o Cloud 9 configurou para você. 1. Instale o Cloud 9 através da [Chrome Web Store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp) 2. Acesse o site [c9.io](https://c9.io) 3. Cadastre-se para criar uma conta 4. Clique em *Create a New Workspace* 5. Dê o nome de *django-girls* 6. Selecione *Blank* (segundo a partir da direita na linha inferior com logotipo laranja) Agora a sua tela deve exibir uma interface com uma barra lateral, uma grande janela principal com algum texto e uma pequena janela na parte inferior, semelhante a isto:

Cloud 9

seunomedeusuário:~/workspace $ Esta área inferior é seu *terminal*, onde você vai dar as instruções para o computador que o Cloud 9 preparou para você. Você pode redimensionar a janela para torná-la um pouco maior. ### Ambiente Virtual Um ambiente virtual (também chamado de virtualenv) é como se fosse uma caixa privada onde nós podemos colocar código de computador útil para um projeto que estejamos trabalhando. Nós os utilizamos para manter os vários pedaços de código que queremos para nossos vários projetos separados, para que as coisas não se misturem entre os projetos. No seu terminal, na parte de baixo da interface do Cloud 9, execute o seguinte:

Cloud 9

sudo apt update sudo apt install python3.6-venv Se isso ainda não funcionar, peça ajuda ao seu treinador. Em seguida, execute:

Cloud 9

mkdir djangogirls cd djangogirls python3.6 -mvenv myvenv source myvenv/bin/activate pip install django~=2.0.6 (note que na última linha nós utilizamos um til seguido de um sinal de igual: ~=). ### GitHub Crie uma conta no [GitHub](https://github.com). ### PythonAnywhere O tutorial do Django Girls inclui uma seção que chamamos de Deployment (algo como "implantação", em Português), que é o processo de pegar o código que alimenta a sua nova aplicação web e movê-lo para um computador de acesso público (chamado de servidor), então outras pessoas serão capazes de ver seu trabalho. Esta parte é um pouco esquisita quando o tutorial é feito num Chromebook, dado que já estamos usando um computador que está na Internet (ao contrário de, digamos, um laptop). Porém, ainda útil, já que podemos pensar no ambiente do Cloud 9 como um lugar pra nosso trabalho "em andamento" e Python Anywhere como um lugar para mostrar nosso trabalho conforme ele vai ficando mais completo. Assim, crie uma nova conta Python Anywhere em [www.pythonanywhere.com](https://www.pythonanywhere.com).

Instale o Python

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

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

Django é escrito em Python. Precisamos dele para fazer qualquer coisa no Django. Por isso, vamos começar instalando o Python! Nós precisamos que você instale o Python 3.6. Se você tiver alguma versão mais antiga, é preciso atualizá-la.

Install Python: Windows

Primeiro, verifique se o computador está executando a versão 32-bit ou a versão 64-bit do Windows. Faça isso pressionando a tecla do windows no seu teclado (aquela com a janela do windows) + a tecla Pause/Break. Feito isso, uma tela abrirá com as informações do seu windows. Nessa tela, verifique a seção "Tipo de sistema" e confira que versão está sendo executada. Você pode baixar o Python para Windows no website https://www.python.org/downloads/windows/. Clique no link: "Versão Mais Recente Python 3 - Python x.x.x". Se seu computador está executando a versão 64-bit do windows, baixe o instalador executável do Windows x86-64. Caso contrário, baixe o instalador executável x86 do Windows. Depois de baixar o instalador, você precisa executá-lo (dando um duplo-clique nele) e seguir as instruções.

Existe uma coisa com a qual você precisa ter cuidado: durante a instalação, você verá uma janela marcada como "Setup". Certifique-se de selecionar a caixa "Adicionar Python 3.6 ao CAMINHO" e clique em "Instalar agora", conforme mostrado aqui:

Não se esqueça de adicionar o Python ao Path

Nas próximas etapas, você usará a linha de comando do Windows (vamos te explicar tudo sobre isso também). Por enquanto, se você precisa digitar alguns comandos, vá ao menu iniciar e digite "Command Prompt" no campo de busca. (Em versões mais antigas do Windows, é possível iniciar a linha de comando com Start menu → Sistema do Windows → Prompt de comando.) Você também pode segurar a tecla windows + "R" até aparecer a janela "Executar". Para abrir a Linha de Comando, digite "cmd" e pressione enter na janela "Executar".

Digite "cmd" na janela "Run"

<0>Observação: se você estiver usando uma versão antiga do Windows (7, Vista, ou qualquer outra mais antiga) e o instalador do 3.6. x Python falhar com um erro, você pode tentar:

  1. instalar todas as atualizações do Windows e tentar instalar o Python 3.6 novamente; ou
  2. instalar uma versão mais antiga do Python, por exemplo, 3.4.6.

Se você instalar uma versão mais antiga do Python, a tela de instalação pode parecer um pouco diferente da mostrada acima. Certifique-se de rolar até ver a opção "Add python.exe to Path", então clique no botão à esquerda e escolha "Will be installed on local hard drive":

Adicionar o Python ao PATH, versões mais antigas

Install Python: OS X

Observação: Antes de instalar o Python no Mac OS X, você deve garantir que suas configurações permitam a instalação de pacotes que não estejam na App Store. Vá para preferências do sistema (dentro da pasta Aplicativos), clique em "Segurança & Privacidade" e depois na guia "Geral". Se a configuração "Permitir que apps baixados:" estiver definida como "Mac App Store," mude para "Mac App Store e desenvolvedores identificados."

Você precisa visitar https://www.python.org/downloads/release/python-361/ e baixar o instalador do Python:

  • Faça o download do arquivo Mac OS X 64-bit/32-bit installer,
  • Dê um duplo clique no arquivo python-3.6.1-macosx10.6.pkg para executar o instalador.
Install Python: Linux

É muito provável que você já tenha o Python instalado e configurado. Para ter certeza se ele está instalado (e qual a sua versão), abra o terminal e digite o seguinte comando:

command-line

$ python3 --version
Python 3.6.1

Se você tem instalada uma outra "versão micro" do Python, por exemplo, 3.6.0, você não precisa atualizá-la. Se você não tiver o Python instalado ou quiser uma versão diferente, faça assim:

Install Python: Debian or Ubuntu

Digite o seguinte comando no terminal:

command-line

$ sudo apt install python3.6
Install Python: Fedora

Use o seguinte comando no terminal:

command-line

$ sudo dnf install python3

Se você estiver em versões mais antigas do Fedora, pode receber um erro dizendo que o comando dnf não foi encontrado. Nesse caso, você precisa usar o yum em vez disso.

Install Python: openSUSE

Use o seguinte comando no terminal:

command-line

$ 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

Observação: Se você estiver no Windows e receber uma mensagem de erro dizendo queo python3 não foi encontrado, tente utilizar python (sem o 3) e verifique se ela corresponde à versão Python 3.6.


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.

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
Virtual environment: Windows

Para criar um novo virtualenv, você deve abrir o terminal e executar python -m venv myvenv. Deve ficar assim:

command-line

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

Onde myvenv é o nome do seu virtualenv. Você pode usar qualquer outro nome, mas sempre use minúsculas e não use espaços, acentos ou caracteres especiais. Também é uma boa ideia manter o nome curto - você irá referenciá-lo muitas vezes!

Virtual environment: Linux and OS X

Podemos criar um virtualenv no Linux ou no OS X executando python3 -m venv myvenv. Deve ficar assim:

command-line

$ python3 -m venv myvenv

myvenv é o nome do seu virtualenv. Você pode usar qualquer outro nome, mas use sempre letras minúsculas e não use espaços entre as palavras. Também é uma boa ideia manter o nome curto pois você vai escrevê-lo muitas vezes!

Observação: Em algumas versões do Debian/Ubuntu, você pode receber o seguinte erro:

command-line

The virtual environment was not created successfully because ensurepip is not available.  On Debian/Ubuntu systems, you need to install the python3-venv package using the following command.
   apt install python3-venv
You may need to use sudo with that command.  After installing the python3-venv package, recreate your virtual environment.

Caso você receba esse erro, siga as instruções acima e instale o pacote python3-venv:

command-line

$ sudo apt install python3-venv

Observação: Em algumas versões do Debian/Ubuntu, iniciar o ambiente virtual com este comando gera o seguinte erro:

command-line

Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1

Para contornar esse problema, use o comando virtualenv.

command-line

$ sudo apt install python-virtualenv
$ virtualenv --python=python3.6 myvenv

Oservação: Se você obtiver um erro como

command-line

E: Unable to locate package python3-venv

no lugar do comando mostrado acima, execute esse:

command-line

sudo apt install python3.6-venv

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

Inicie o seu ambiente virtual executando:

command-line

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

Observação: no Windows 10, você pode obter um erro no Windows PowerShell que diz execution of scripts is disabled on this system. Neste caso, abra uma outra janela do Windows PowerShell com a opção de "Executar como Administrador". Assim, execute o comando abaixo antes de iniciar o seu ambiente virtual:

command-line

C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
    Execution Policy Change
    The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A
Working with virtualenv: Linux and OS X

Inicie o seu ambiente virtual executando:

command-line

$ source myvenv/bin/activate

Lembre-se de substituir myvenv pelo nome que você escolheu para o virtualenv!

Observação: às vezes source pode não estar disponível. Nesses casos, tente fazer isso:

command-line

$ . 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) ~$ python3 -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:

Primeiramente, crie um arquivo requirements.txt dentro da pasta djangogirls/:

djangogirls
└───requirements.txt

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

djangogirls/requirements.txt

Django~=2.0.6

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

command-line

(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=2.0.6 (from -r requirements.txt (line 1))
  Downloading Django-2.0.6-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-2.0.6
Installing Django: Windows

Se você receber um erro ao chamar o pip na plataforma Windows, verifique se o caminho do projeto contém espaços, acentos ou caracteres especiais (exemplo, C:\Users\User Name\djangogirls). Se sim, considere movê-lo para outro lugar sem espaços, acentos ou caracteres especiais (sugestão: C:\djangogirls). Crie um novo virtualenv no diretório recém-criado, exclua o mais velho e tente novamente executar o comando acima. (Mover o diretório de virtualenv não vai funcionar pois o virtualenv usa caminhos absolutos.)

Installing Django: Windows 8 and Windows 10

Sua linha de comando pode congelar depois de você tentar instalar o Django. Neste caso, ao invés do comando acima, use:

command-line

C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
Installing Django: Linux

Se você receber um erro ao chamar o pip no Ubuntu 12.04, execute python -m pip install -U --force-reinstall pip para corrigir a instalação do pip no virtualenv.

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

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.

Gedit

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

Baixe-o aqui

Sublime Text 3

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

O Atom é um editor de código recente criado pelo GitHub. Ele é gratuito, tem código aberto e está disponível para Windows, OS X e Linux.

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 o problema com programas como o Word e o Textedit é que eles 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 podem fornecer funcionalidades úteis, como destacar o código com cores de acordo com seu significado ou fechar aspas automaticamente para você.

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

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. Um pouco parecido com o recurso "controlar alterações" do Microsoft Word, mas muito mais poderoso.

Instalando o Git

Installing Git: Windows

Você pode baixar o Git em git-scm.com. Clique em "next" em todos os passos, exceto em um: no passo intitulado "Ajustando o PATH do seu ambiente" (em inglês "Adjusting your PATH environment"), escolha "Use Git e ferramentas Unix opcionais do Prompt de Comando do Windows" (em inglês "Use Git and optional Unix tools from the Windows Command Prompt"), que é a opção mais abaixo. Fora isso, as configurações padrão estão ótimas. "Checkout Windows-style, commit Unix-style line endings" está bom.

Não se esqueça de reiniciar o prompt de comando ou o powershell depois que a instalação terminar com sucesso.

Installing Git: OS X

Baixe o Git em git-scm.com e siga as instruções.

Observação: Se estiver rodando o OS X 10.6, 10.7, ou 10.8, você precisará instalar essa versão do git: Instalado Git para o OS X Snow Leopard

Installing Git: Debian or Ubuntu

command-line

$ sudo apt install git
Installing Git: Fedora

command-line

$ sudo dnf install git
Installing Git: openSUSE

command-line

$ sudo zypper install git

Crie uma conta no GitHub

Vá para GitHub.com e cadastre uma conta de usuário.

Crie uma conta no PythonAnywhere

Cadastre uma conta gratuita de "Beginner" (Iniciante) no PythonAnywhere:

Observação: Quando escolher seu nome de usuário, lembre-se de que a URL do seu blog vai ter o formato nomedeusuario.pythonanywhere.com, então escolha seu próprio apelido ou um nome que represente o tema do seu blog.

Criando um token de API do PythonAnywhere

Você só precisa fazer isso uma vez. Quando estiver inscrita no PythonAnywhere, você será levada ao seu dashboard. Encontre o link no lado direito superior da página "Accounts", e então selecione a aba "API token" e clique no botão que diz "Create new API token".

O token de API na página Accounts

Comece a ler

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

Aproveite o workshop!

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

results matching ""

    No results matching ""