Merge pull request #72 from AfroPython/Sourcelair

[WIP] CodeAnywhere -> SourceLair

Author: pedrro

SUMMARY.md

@@ -41,8 +41,6 @@
 * [Django, o que é?](django/o_que_e.md)
   * [Por que você precisa de um framework?](django/porque_um_framework.md)
   * [O que acontece quando alguém solicita um site do seu servidor?](django/solicitando_o_site.md)
-* [Instalação do Django](django/instalacao_introducao.md)
-  * [Instalando...](django/instalacao.md)
 * [Seu primeiro projeto Django](django/primeiro_projeto.md)
     * [Configurando](django/configurando.md)
     * [Instalando o banco de dados](django/instalando_banco_de_dados.md)
@@ -56,7 +54,6 @@
 * [URLs](urls/urls.md)
   * [O que é uma URL?](urls/o_que_e_uma_url.md)
   * [Como funcionam as URLs no Django?](urls/como_funcionam_as_urls_em_django.md)
-  * [Regex](urls/regex.md)
   * [Sua primeira URL Django](urls/sua_primeira_url_django.md)
   * [blog.urls](urls/blog_urls.md)
 * [Views](views/views.md)

administracao.md

@@ -6,23 +6,28 @@ from django.contrib import admin
 from .models import Post
 
 admin.site.register(Post)
+
 ```
+Após alterar, salve o arquivo (“Save file”)!
 
 Como você pode ver, nós importamos (incluímos) o modelo Post definido no capítulo anterior. Para tornar nosso modelo visível na página de administração, nós precisamos registrá-lo com: `admin.site.register(Post)`.
 
-OK, hora de olhar para o nosso modelo de Post. Lembre-se de executar `python3 manage.py runserver 0.0.0.0:8080` no console para executar o servidor web. Vá para o navegador e digite o endereço do seu site seguido de `/admin` (`http://<<sua_url>>.codeanyapp.com:8080/admin/`). Você verá uma página de login assim:
+OK, hora de olhar para o nosso modelo de Post. Lembre-se de acessar o ícone na lateral esquerda da tela de novo. Vá no navegador e adicione na URL o /admin. No nosso exemplo vai ficar https://b6sdo2j4.apps.lair.io/admin
+
+Você verá uma página de login assim:
 
 ![Página de login](administracao/admin-login.png)
 
 Para fazer login você precisa criar um superuser - um usuário que possui controle sobre tudo do site. Volte para o terminal e digite `python3 manage.py createsuperuser`, pressione enter e digite seu nome de usuário (caixa baixa, sem espaço), endereço de e-mail e password quando eles forem requisitados. Não se preocupe que você não pode ver a senha que você está digitando - é assim que deve ser. Só digitá-la e pressione 'Enter' para continuar. A saída deve parecer com essa (onde Username e Email devem ser os seus):
 
 ```
-~/afropython$ python3 manage.py createsuperuser
-Username: admin
+…@AfroPython:/mnt/project$ python3 manage.py createsuperuser
+Username (leave blank to use 'www-data'): admin
 Email address: [email protected]
-Password:
-Password (again):
+Password: Afropython123
+Password (again): Afropython123
 Superuser created successfully.
+
 ```
 
 Volte para a o navegador e faça login com as credenciais de superuser que você escolheu, você deve visualizar o painel de controle do Django admin.

django/configurando.md

@@ -1,6 +1,6 @@
 # Configurando
 
-Vamos fazer algumas alterações no `mysite/settings.py`. Abra o arquivo usando o editor de código que usamos anteriormente.
+Vamos fazer algumas alterações no `AfroPython/settings.py`. Abra o arquivo usando o editor de código que usamos anteriormente.
 
 Seria bom ter a hora correta no nosso site. Vá para a [wikipedia timezones list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) e copie seu fuso horário. (no nosso caso, `America/Sao_Paulo`)
 
@@ -9,10 +9,17 @@ No arquivo `settings.py`, localize a linha que contém `TIME_ZONE` e modifique p
 TIME_ZONE = 'America/Sao_Paulo'
 ```
 
+No mesmo arquivo, precisamos permitir o nosso acesso ao site. Para isso, localize a linha `ALLOWED_HOST` e modifique para:
+```
+ALLOWED_HOSTS = ['*']
+```
+
 Nós também precisaremos adicionar um caminho para arquivos estáticos (nós vamos descobrir tudo sobre arquivos estáticos e CSS mais tarde no tutorial). Desça até o final do arquivo e logo abaixo da entrada `STATIC_URL`, adicione um novo um chamado `STATIC_ROOT`:
 ```
 STATIC_URL = '/static/'
 STATIC_ROOT = os.path.join(BASE_DIR, 'static')
 ```
 
+Lembre-se de clicar em "Save File" após incluir o conteúdo acima.
+
 Por enquanto isso, vamos para a próxima parte?

django/django/abrir_site.png

@@ -2,7 +2,7 @@
 
 Há vários softwares de banco de dados diferentes que pode armazenar dados para o seu site. Nós vamos usar o padrão, `sqlite3`.
 
-Isto já está configurado nesta parte do seu arquivo `mysite/settings.py`:
+Isto já está configurado nesta parte do seu arquivo `AfroPython/settings.py`:
 
 ```
 
@@ -24,7 +24,7 @@ Precisamos estar no diretório que contém o arquivo `manage.py` dentro da pasta
 Se isso der certo, você deve ver algo como isto:
 
 ```
-~/afropython$ python3 manage.py migrate
+...@AfroPython:/mnt/project$ python3 manage.py migrate
 Operations to perform:
   Apply all migrations: admin, contenttypes, auth, sessions
 Running migrations:
@@ -36,21 +36,9 @@ Running migrations:
 
 E está pronto! Hora de iniciar o servidor web e ver se nosso site está funcionando!
 
-Você precisa estar no diretório que contém o arquivo `manage.py` (no diretório afropython). No console, nós podemos iniciar o servidor web executando:
-```
-~/afropython$ python3 manage.py runserver 0.0.0.0:8080
-```
-
-Para acessar o site no navegador, utilize a primeira url que o codeanywhere mostra na página de informação, adicionando a porta 8080 no final da url:
-
-![URL servidor](django/url_server.png)
-
-Então, no exemplo, a url fica:
-```
-http://treinamento-carolinemoers694501.codeanyapp.com:8080
-```
+Acesse o ícone na lateral esquerda da tela. Uma nova guia/aba vai abrir no seu navegador.
 
-O servidor web vai assumir seu prompt de comando até você pará-lo: pode abrir uma nova janela do terminal, ou parar o servidor de web, alternando de volta para a janela na qual está executando e pressionando CTRL + C - botões de controle e C juntos.
+![Abrir o projeto](django/abrir_site.png)
 
 Parabéns! Você criou seu primeiro site e o executou usando um servidor de web! Não é impressionante?
 

django/django/estrutura.png

@@ -1,34 +1,16 @@
 # Criando uma aplicação
 
-Para manter tudo arrumado vamos criar um aplicativo separado dentro do nosso projeto. É muito bom ter tudo organizado desde o início. Para criar uma aplicação precisamos executar o seguinte comando no console (a partir do diretório afropython onde está o arquivo manage.py):
+Para manter tudo arrumado vamos criar um aplicativo separado dentro do nosso projeto. É muito bom ter tudo organizado desde o início. Para criar um aplicativo precisamos executar o seguinte comando no console:
 
-```
-~/afropython$ python3 manage.py startapp blog
-```
+…@AfroPython:/mnt/project$python3 manage.py startapp blog
 
 Você vai notar que um novo diretório blog é criado e que ele agora contém um número de arquivos. Nossos diretórios e arquivos no nosso projeto devem se parecer com este:
 
-```
-afropython
-├── mysite
-|       __init__.py
-|       settings.py
-|       urls.py
-|       wsgi.py
-├── manage.py
-└── blog
-    ├── migrations
-    |       __init__.py
-    ├── __init__.py
-    ├── admin.py
-    ├── models.py
-    ├── tests.py
-    └── views.py
-```
+![Estrutura do projeto](django/estrutura.png)
 
-Depois de criar um aplicativo também precisamos dizer ao Django que deve usá-lo. Fazemos isso no arquivo `mysite/settings.py`.
+Depois de criar um aplicativo também precisamos dizer ao Django que deve usá-lo. Fazemos isso no arquivo `AfroPython/settings.py`.
 
-Precisamos encontrar o `INSTALLED_APPS` e adicionar uma linha com `'blog'`, logo acima do `)`. É assim que a configuração deve ficar:
+Precisamos encontrar o `INSTALLED_APPS` e adicionar uma linha com `'blog'`, logo acima do `]`. É assim que a configuração deve ficar:
 
 ```
 INSTALLED_APPS = (

django/django/servidor_rodando.png

@@ -7,22 +7,25 @@ Vamos abrir `blog/models.py`, remova tudo dele e escreva o código como este:
 ```
 from django.db import models
 from django.utils import timezone
+from django.contrib.auth import get_user_model
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User')
+    author = models.ForeignKey(
+        get_user_model(), on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(
-            default=timezone.now)
+        default=timezone.now)
     published_date = models.DateTimeField(
-            blank=True, null=True)
+        blank=True, null=True)
 
     def publish(self):
-        self.published_date = timezone.now()
+        self.published_date=timezone.now()
         self.save()
 
     def __str__(self):
         return self.title
+
 ```
 > Certifique-se de ter usado dois caracteres `(_)` em cada lado do str. Aqueles caracteres são usados freqüentemente em Python e às vezes os chamamos de `"dunder"` (abreviação de "double-underscore" ou "duplo sublinhado").
 >

django/django/url_server.png

@@ -8,7 +8,7 @@ python3 manage.py makemigrations blog
 Algo parecido com isto deve aparecer para você:
 
 ```
-~/afropython$ python3 manage.py makemigrations blog
+…@AfroPython:/mnt/project$ python3 manage.py makemigrations blog
 Migrations for 'blog':
   0001_initial.py:
   - Create model Post
@@ -21,7 +21,7 @@ python3 manage.py migrate blog
 
 A saída deve ser:
 ```
-~/afropython$ python3 manage.py migrate blog
+…@AfroPython:/mnt/project$ python3 manage.py migrate blog
 Operations to perform:
   Apply all migrations: blog
 Running migrations:

django/instalacao.md

@@ -5,30 +5,10 @@ Parte deste capítulo é baseado no django-marcador tutorial licenciado sobre Cr
 
 Nós vamos criar um blog simples!
 
-O primeiro passo para criá-lo é começar um novo projeto de Django. Basicamente, isto significa que vamos executar alguns scripts fornecidos pelo Django que irá criar o esqueleto de um projeto Django para nós: um bando de diretórios e arquivos que usaremos mais tarde.
+O primeiro passo para criá-lo é começar um novo projeto de Django. Você já fez isso quando iniciou esse projeto, e todo o esqueleto de um projeto Django foi criado para nós: um bando de diretórios e arquivos que usaremos mais tarde.
 
 Os nomes de alguns arquivos e diretórios são muito importantes para o Django. Não renomeie os arquivos que estamos prestes a criar. Mover para um lugar diferente também não é uma boa idéia. Django precisa manter uma determinada estrutura para ser capaz de encontrar coisas importantes.
 
-> **Nota:** Verifique que você incluiu o ponto (.) no final do comando, é importante porque diz ao script para instalar o Django em seu diretório atual.
-
-No console, você deve executar (lembre-se de não digitar ``~/afropython$``  , OK?):
-
-```
-~/afropython$ django-admin startproject mysite .
-```
-
-`Django-admin` é um script que irá criar os diretórios e arquivos para você. Agora, você deve ter um diretório estrutura que se parece com isso:
-
-```
-afropython
-├───manage.py
-└───mysite
-        settings.py
-        urls.py
-        wsgi.py
-        __init__.py
-```
-
 `manage.py` é um script que ajuda com a gestão do site. Com isso seremos capazes de iniciar um servidor de web no nosso computador sem instalar nada, entre outras coisas.
 
 O arquivo `settings.py` contém a configuração do seu site.

django/instalacao_introducao.md

@@ -2,12 +2,12 @@
 
 Você está prestes a escrever sua primeira linha de código, então precisamos de um editor de código!
 
-Existem muitos editores diferentes e em grande parte se resume a preferência pessoal. A maioria das pessoas que programam em Python usa as complexas, mas extremamente poderosas IDEs (Integrated Development Environments, ou em português, Ambiente de desenvolvimento Integrado), tais como PyCharm.
+Existem muitos editores diferentes e em grande parte se resume a preferência pessoal. A maioria das pessoas que programam em Python usam as complexas, mas extremamente poderosas IDEs (Integrated Development Environments, ou em português, Ambiente de desenvolvimento Integrado), tais como PyCharm.
 
-Para o tutorial, usaremos o editor do Codeanywhere. Para isso, basta criar um novo arquivo, clicando com o botão direito no container e escolhendo a opção “Create File”:
+Para o tutorial, usaremos o editor do Sourcelair. Para isso, basta criar um novo arquivo, clicando no primeiro botão do menu horizontal “Create New File”:
 
 ![Criando novo arquivo](editor_de_codigo/novo_arquivo.png)
 
-Vai abrir uma janela. Coloque o nome do arquivo e clique em OK:
+Uma nova linha será criada. Coloque o nome do arquivo como 'teste' e aperte Enter:
 
 ![Criando novo arquivo](editor_de_codigo/arquivo.png)

django/instalando_banco_de_dados.md

@@ -13,9 +13,9 @@ Os templates são salvos no diretório `blog/templates/blog`. Então, crie um di
 
 E agora crie o arquivo `post_list.html` (deixe-o em branco por agora) dentro do diretório `blog/templates/blog`.
 
-Veja como o nosso site está se parecendo agora: http://0.0.0.0:8080/
+Veja como o nosso site está se parecendo agora:
 
-> Se ocorrer um erro de `TemplateDoesNotExists` tente reiniciar o seu servidor. Entre na linha de comando, pare o servidor pressionando Ctrl+C (Control seguido da tecla C, juntas) e reinicie-o rodando `python3 manage.py runserver`.
+> Se ocorrer um erro de `TemplateDoesNotExists` tente reiniciar o seu servidor. Abra a Command Pallete pelo ícone no menu lateral, procure por `Restart Server` e aperte Enter.
 
 ![Passo 1](introducao_html/step1.png)
 
@@ -30,7 +30,7 @@ blog/templates/blog/post_list.html
 </html>
 ```
 
-Como nosso site se parece agora? Entre no site ou clique para descobrir: http://0.0.0.0:8080/
+Como nosso site se parece agora? Entre no site para descobrir.
 
 ![Passo 2](introducao_html/step2.png)
 

django/modelos_criando_aplicacao.md

@@ -1,17 +1,15 @@
 # Conhecendo a linha de comando
 
-Para começar alguns experimentos, precisamos abrir a nossa interface de linha de comando primeiro.
+Para começar alguns experimentos, precisamos acessar a linha de comando primeiro.
 
-#### Codeanywhere
-Clique com o botão direito em cima de seu container, depois em SSH Terminal:
-
-![SSH Terminal](linha_de_comando/01_ssh_terminal.png)
+#### Sourcelair
+No Sourcelair, a linha de comando já está aberta para você, na parte inferior da tua tela. 
+![SSH Terminal](linha_de_comando/terminal.png)
 
 #### Prompt
-Agora você deve ver uma janela preta que está à espera de seus comandos.
+Esta janela preta está à espera de seus comandos.
 
 ![Prompt](linha_de_comando/prompt.png)
 
 Cada comando será antecedido pelo sinal **$** e um espaço, mas você não precisa digitá-lo. Seu computador fará isso por você :)
 
-**Apenas uma pequena nota:** no seu caso, talvez exista algo como _cabox@box-codeanywhere:~workspace/afropython$_  antes do sinal do prompt e isto estará 100% correto. Neste tutorial nós apenas simplificaremos ele para o mínimo.

django/modelos_criando_modelo.md

@@ -10,7 +10,7 @@ Veja se realmente entramos na pasta:
 
 ```
 $ pwd
-/home/cabox/workspace/minhapasta
+/mnt/project/minhapasta
 ```
 Aqui está!
 

django/modelos_criando_tabela.md

@@ -1,13 +1,12 @@
 # Exercite-se
 
-Um pequeno desafio para você: na sua mais nova pasta criada *minhapasta* crie uma outra pasta chamada *teste*.
+Um pequeno desafio para você: na sua mais nova pasta *minhapasta* crie uma outra pasta chamada *teste*.
 
-Use os comandos cd e mkdir.
+Use o comando mkdir.
 
 **Solução**
 
 ```
-$ cd minhapasta
 $ mkdir teste
 $ ls
 teste

django/primeiro_projeto.md

@@ -14,7 +14,7 @@ Veja onde você está:
 
 ```
 $ pwd
-/home/cabox/workspace
+/mnt/project
 ```
 
 Agora é hora de excluir o diretório **minhapasta**.

editor_de_codigo/editor_de_codigo/arquivo.png

@@ -4,7 +4,7 @@ Digite o seguinte comando:
 
 ```
 $ ls
-afropython
+minhapasta
 ```
 
 Ali está a pasta criada! Vamos entrar nela?

editor_de_codigo/editor_de_codigo/novo_arquivo.png

@@ -4,7 +4,7 @@ Seria legal saber em que pasta estamos agora, certo? Vamos ver. Digite o seguint
 
 ```
 $ pwd
-/home/cabox/workspace
+/mnt/project
 ```
 
 Provavelmente você vai ver algo parecido na sua máquina. Um vez que você abre a linha de comando você já começa na pasta workspace.