diff --git a/SUMMARY.md b/SUMMARY.md index ec196f4..c9c17f5 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -43,12 +43,14 @@ - [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) - [Seu primeiro projeto Django](django/primeiro_projeto.md) + - [Instalando o Django](django/instalando_django/instalando.md) + - [Iniciando o projeto](django/iniciando_um_projeto/iniciando_projeto.md) - [Configurando](django/configurando.md) - [Instalando o banco de dados](django/instalando_banco_de_dados.md) - [Modelos do Django](django/modelos_introducao.md) - [Objetos](django/objetos.md) - [Modelo do Django](django/modelos.md) - - [Criando uma aplicação](django/modelos_criando_aplicacao.md) + - [Criando uma aplicação](django/criando_uma_aplicacao/criando_uma_aplicacao.md) - [Criando um modelo](django/modelos_criando_modelo.md) - [Criando tabelas](django/modelos_criando_tabela.md) - [Administração](administracao.md) diff --git a/administracao.md b/administracao.md index e6d577a..2932a41 100644 --- a/administracao.md +++ b/administracao.md @@ -1,4 +1,5 @@ # Administração + Para adicionar, editar e remover postagens que nós criamos usaremos o Django admin. Vamos abrir o arquivo blog/admin.py e substituir seu conteúdo por: ``` @@ -8,12 +9,11 @@ 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 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) diff --git a/codenvy/dashboard.md b/codenvy/dashboard.md index f5b6c5e..2e52494 100644 --- a/codenvy/dashboard.md +++ b/codenvy/dashboard.md @@ -10,6 +10,8 @@ Na tela que se abriu, identifique a secção _**SELECT STACK**_ e selecione a op ![selecionando_python](selecionando_python.png) +Para este tutorial, iremos usar a versão mais atualizada do Python. + No final da página ou, no cabeçalho, do lado superior direito, clique na opção _**CREATE**"_ para confirmar a criação do ambiente. Uma nova janela com o processamento da criação do ambiente irá surgir e, ao final, aparecerá uma tela parecida com essa abaixo. diff --git a/codenvy/selecionando_python.png b/codenvy/selecionando_python.png index e24d547..ac1711a 100644 Binary files a/codenvy/selecionando_python.png and b/codenvy/selecionando_python.png differ diff --git a/django/configurando.md b/django/configurando.md index 82091ef..14c6353 100644 --- a/django/configurando.md +++ b/django/configurando.md @@ -1,25 +1,28 @@ # Configurando -Vamos fazer algumas alterações no `AfroPython/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`) -No arquivo `settings.py`, localize a linha que contém `TIME_ZONE` e modifique para escolher seu próprio fuso horário: +No arquivo `settings.py`, localize a linha que contém `TIME_ZONE` (linha 108) e modifique para escolher seu próprio fuso horário: + ``` 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. +Lembre-se que o Codenvy salva as modificações automaticamente. Por enquanto isso, vamos para a próxima parte? diff --git a/django/criando_uma_aplicacao/criando_uma_aplicacao.md b/django/criando_uma_aplicacao/criando_uma_aplicacao.md new file mode 100644 index 0000000..6bab381 --- /dev/null +++ b/django/criando_uma_aplicacao/criando_uma_aplicacao.md @@ -0,0 +1,29 @@ +# 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 um aplicativo precisamos executar o seguinte comando no console: + +``` +$ python 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: + +![Estrutura projeto atualizada](estrutura_projeto_atualizada.png) + +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: + +``` +INSTALLED_APPS = ( + 'django.contrib.admin', + 'django.contrib.auth', + 'django.contrib.contenttypes', + 'django.contrib.sessions', + 'django.contrib.messages', + 'django.contrib.staticfiles', + 'blog', +) +``` diff --git a/django/criando_uma_aplicacao/estrutura_projeto_atualizada.png b/django/criando_uma_aplicacao/estrutura_projeto_atualizada.png new file mode 100644 index 0000000..7568563 Binary files /dev/null and b/django/criando_uma_aplicacao/estrutura_projeto_atualizada.png differ diff --git a/django/iniciando_um_projeto/estrutura_projeto.png b/django/iniciando_um_projeto/estrutura_projeto.png new file mode 100644 index 0000000..b134de7 Binary files /dev/null and b/django/iniciando_um_projeto/estrutura_projeto.png differ diff --git a/django/iniciando_um_projeto/iniciando_projeto.md b/django/iniciando_um_projeto/iniciando_projeto.md new file mode 100644 index 0000000..0d27ae6 --- /dev/null +++ b/django/iniciando_um_projeto/iniciando_projeto.md @@ -0,0 +1,23 @@ +# Inciando o projeto + +Pronto, agora que temos o django, podemos inciar o nosso projeto. No terminal digite o comando: + +``` +$ django-admin startproject afropython +``` + +Isso irá criar uma pasta no Project Explorer que tem a seguinte estrutura: + +![Estrutura projeto](estrutura_projeto.png) + +Bacana, agora 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. + +`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. + +Lembra quando falamos sobre um carteiro verificando onde entregar uma carta? arquivo `urls.py` contém uma lista dos padrões usados por `urlresolver`. + +Vamos ignorar os outros arquivos por agora - nós não vamos mudá-los. A única coisa a lembrar é não excluí-los por acidente! \ No newline at end of file diff --git a/django/instalando_banco_de_dados.md b/django/instalando_banco_de_dados.md index 6ea1801..c61dbaa 100644 --- a/django/instalando_banco_de_dados.md +++ b/django/instalando_banco_de_dados.md @@ -24,21 +24,32 @@ 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:/mnt/project$ python3 manage.py migrate +(django) user@b3592ed04e17:/projects/afropython$ python3 manage.py migrate Operations to perform: - Apply all migrations: admin, contenttypes, auth, sessions + Apply all migrations: admin, auth, contenttypes, sessions Running migrations: Applying contenttypes.0001_initial... OK Applying auth.0001_initial... OK Applying admin.0001_initial... OK + Applying admin.0002_logentry_remove_auto_add... OK + Applying admin.0003_logentry_add_action_flag_choices... OK + Applying contenttypes.0002_remove_content_type_name... OK + Applying auth.0002_alter_permission_name_max_length... OK + Applying auth.0003_alter_user_email_max_length... OK + Applying auth.0004_alter_user_username_opts... OK + Applying auth.0005_alter_user_last_login_null... OK + Applying auth.0006_require_contenttypes_0002... OK + Applying auth.0007_alter_validators_add_error_messages... OK + Applying auth.0008_alter_user_username_max_length... OK + Applying auth.0009_alter_user_last_name_max_length... OK + Applying auth.0010_alter_group_name_max_length... OK + Applying auth.0011_update_proxy_permissions... OK Applying sessions.0001_initial... OK ``` E está pronto! Hora de iniciar o servidor web e ver se nosso site está funcionando! -Acesse o ícone na lateral esquerda da tela. Uma nova guia/aba vai abrir no seu navegador. - -![Abrir o projeto](django/abrir_site.png) +// TO-DO Parabéns! Você criou seu primeiro site e o executou usando um servidor de web! Não é impressionante? diff --git a/django/instalando_django/instalando.md b/django/instalando_django/instalando.md new file mode 100644 index 0000000..ecd3a99 --- /dev/null +++ b/django/instalando_django/instalando.md @@ -0,0 +1,31 @@ +# Instalando Django + +> Se você tiver na dentro da pasta ** codigo-python ** (ou, alguma outra), saia dela executando no terminal o comando `cd ..` + +Precisamos executar os comandos abaixos na ordem que aparecem para instalar o django. Os dois primeiros comandos são para ativar o virtual env do python, mas você não precisa se preocupar com isso agora. + +``` +$ python3 -m venv django +``` + +> Imorpante: Precisamos usar o comando `python3` porque a versão do django que estamos usando é compatível apenas com a versão Python 3 ou maior + +Esse comando irá criar uma pasta chamada ** django ** contendo alguns arquivos dentro dela, mas esse é o resultado esperado + +``` +$ source django/bin/activate +``` + +O comando acoma ativa o virtaul env no ambiente de deselvimento. Após a execução do comando acima, o teu terminal deverá aparecer o prefixo ** (django) ** a frente da linha de comando: + +![Virtal env](virtual_env.png) + +> Infelizmente, o Codenvy ficar inativo depois de algumperíodo de tempo ocioso e perde-se a sessão. Se isso acontecer, precisaremos atualizar o site precionando as teclas CRTL+F5 ou no botão de recarregar o navegador. Se você precisar fazer isso, você terá que ativar o virtual env novamente. É importante você exeutar esse comando sempre que tiver fazendo alguma operação no projeto. + +Agora, vamos instalar o django. Execute o comando abaixo: + +``` +pip install Django +``` + +> Quando você executar esse comando, ou seja, quando você precionar a tecla ENTER, registros do que o pip está fazendo irão aparecer na tela. Se acontecer algum erro, execute de novo. Se o problema persistir, chama alguém pra te ajudar. diff --git a/django/instalando_django/virtual_env.png b/django/instalando_django/virtual_env.png new file mode 100644 index 0000000..c6e1c27 Binary files /dev/null and b/django/instalando_django/virtual_env.png differ diff --git a/django/modelos_criando_tabela.md b/django/modelos_criando_tabela.md index 0ecd795..db86ea0 100644 --- a/django/modelos_criando_tabela.md +++ b/django/modelos_criando_tabela.md @@ -1,6 +1,7 @@ # Criando tabelas para nossos modelos no banco de dados O último passo é adicionar nosso novo modelo para nosso banco de dados. Primeiro temos que fazer o Django saber que nós temos algumas mudanças em nosso modelo (só criamos isso), digite: + ``` python3 manage.py makemigrations blog ``` @@ -8,20 +9,22 @@ python3 manage.py makemigrations blog Algo parecido com isto deve aparecer para você: ``` -…@AfroPython:/mnt/project$ python3 manage.py makemigrations blog +(django) user@b3592ed04e17:/projects/afropython$ python3 manage.py makemigrations blog Migrations for 'blog': - 0001_initial.py: - - Create model Post + blog/migrations/0001_initial.py + - Create model Post ``` Django prepara um arquivo de migração que temos de aplicar agora para nosso banco de dados. Digite: + ``` python3 manage.py migrate blog ``` A saída deve ser: + ``` -…@AfroPython:/mnt/project$ python3 manage.py migrate blog +(django) user@b3592ed04e17:/projects/afropython$ python3 manage.py migrate blog Operations to perform: Apply all migrations: blog Running migrations: diff --git a/django/primeiro_projeto.md b/django/primeiro_projeto.md index 8f4d44a..ea21d01 100644 --- a/django/primeiro_projeto.md +++ b/django/primeiro_projeto.md @@ -1,18 +1,10 @@ # Seu primeiro projeto Django! > Parte deste capítulo é baseado nos tutoriais do Geek Girls Carrots (https://github.com/ggcarrots/django-carrots). -Parte deste capítulo é baseado no django-marcador tutorial licenciado sobre Creative Commons Attribution-ShareAlike 4.0 International License. O tutorial do django-marcador é protegido por direitos autorais por Markus Zapke-Gründemann et al. +> Parte deste capítulo é baseado no django-marcador tutorial licenciado sobre Creative Commons Attribution-ShareAlike 4.0 International License. O tutorial do django-marcador é protegido por direitos autorais por Markus Zapke-Gründemann et al. Nós vamos criar um blog simples! -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. +O primeiro passo para criá-lo é começar um novo projeto de Django. Mas antes, precisamos do Django. -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. - -`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. - -Lembra quando falamos sobre um carteiro verificando onde entregar uma carta? arquivo `urls.py` contém uma lista dos padrões usados por `urlresolver`. - -Vamos ignorar os outros arquivos por agora - nós não vamos mudá-los. A única coisa a lembrar é não excluí-los por acidente! +O python possui um instalador de pacotes chamado `pip` (**P**ackage **I**nstaller of **P**ython) e vamos usá-lo para instalar o Django no nosso ambiente de desenvolvimento. Top né? diff --git a/editor_de_codigo/editor_de_codigo/arquivo.png b/editor_de_codigo/editor_de_codigo/arquivo.png deleted file mode 100644 index 4a7a4d5..0000000 Binary files a/editor_de_codigo/editor_de_codigo/arquivo.png and /dev/null differ diff --git a/editor_de_codigo/editor_de_codigo/botao_create.png b/editor_de_codigo/editor_de_codigo/botao_create.png new file mode 100644 index 0000000..dc82906 Binary files /dev/null and b/editor_de_codigo/editor_de_codigo/botao_create.png differ diff --git a/editor_de_codigo/editor_de_codigo/editor_aberto.png b/editor_de_codigo/editor_de_codigo/editor_aberto.png new file mode 100644 index 0000000..ef15936 Binary files /dev/null and b/editor_de_codigo/editor_de_codigo/editor_aberto.png differ diff --git a/editor_de_codigo/editor_de_codigo/nome_do_arquivo.png b/editor_de_codigo/editor_de_codigo/nome_do_arquivo.png new file mode 100644 index 0000000..6d2feaa Binary files /dev/null and b/editor_de_codigo/editor_de_codigo/nome_do_arquivo.png differ diff --git a/editor_de_codigo/editor_de_codigo/novo_arquivo.png b/editor_de_codigo/editor_de_codigo/novo_arquivo.png deleted file mode 100644 index 626a86f..0000000 Binary files a/editor_de_codigo/editor_de_codigo/novo_arquivo.png and /dev/null differ diff --git a/editor_de_codigo/editor_de_codigo/project_explorer.png b/editor_de_codigo/editor_de_codigo/project_explorer.png new file mode 100644 index 0000000..61570af Binary files /dev/null and b/editor_de_codigo/editor_de_codigo/project_explorer.png differ diff --git a/editor_de_codigo/editor_de_codigo/selecionando_tipo_do_arquivo.png b/editor_de_codigo/editor_de_codigo/selecionando_tipo_do_arquivo.png new file mode 100644 index 0000000..de6392b Binary files /dev/null and b/editor_de_codigo/editor_de_codigo/selecionando_tipo_do_arquivo.png differ diff --git a/editor_de_codigo/introducao.md b/editor_de_codigo/introducao.md index b673672..82114f8 100644 --- a/editor_de_codigo/introducao.md +++ b/editor_de_codigo/introducao.md @@ -1,13 +1,32 @@ # Editor de código -Você está prestes a escrever sua primeira linha de código, então precisamos de um editor de código! +Você está prestes a escrever suas primeiras linhas 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 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 Sourcelair. Para isso, basta criar um novo arquivo, clicando no primeiro botão do menu horizontal “Create New File”: +Vamos criar uma pasta chamada ** codigo-python ** que irá conter os arquivos de código que iremos criar. +Para isso, execute o comando abaixo no terminal: -![Criando novo arquivo](editor_de_codigo/novo_arquivo.png) +``` +$ mkdir codigo-python +``` -Uma nova linha será criada. Coloque o nome do arquivo como 'teste' e aperte Enter: +Podemos ver a pasta que acabamos de criar na secção ** Projects Explorer ** -![Criando novo arquivo](editor_de_codigo/arquivo.png) +![Projects Explorer](editor_de_codigo/project_explorer.png) + +Usaremos o editor interno do Codenvy. Para isso, basta criar um novo arquivo, selecionando a pasta ** codigo-python ** e clicando no primeiro botão do menu horizontal “Create...”: + +![Botão Create](editor_de_codigo/botao_create.png) + +Depois, seleciona o tipo de arquivo ** Python File ** + +![Tipo do arquivo](editor_de_codigo/selecionando_tipo_do_arquivo.png) + +Coloque o nome do arquivo como 'python_intro.py' e aperte Enter ou no botão OK: + +![Criando novo arquivo](editor_de_codigo/nome_do_arquivo.png) + +No final, o arquivo será criado e aberto no editor. A tua tela ficará parecida com essa: + +![Editar](editor_de_codigo/editor_aberto.png) diff --git a/editor_de_codigo/necessidade.md b/editor_de_codigo/necessidade.md index 6362186..dad43ef 100644 --- a/editor_de_codigo/necessidade.md +++ b/editor_de_codigo/necessidade.md @@ -7,4 +7,4 @@ Primeiro é que código precisa ser **texto sem formatação**, e o problema com A segunda razão é que editores de código são especializados em editar código, então eles podem oferecer recursos úteis, como realce de código com cores de acordo com o seu significado, ou automaticamente fechar citações para você. Nós vamos ver isso em ação depois. Em breve você terá seu editor de código como uma das suas ferramentas favoritas. :) -Agora, vamos voltar para a linha de comando (alterne a aba!). +Agora, vamos voltar para a linha de comando. diff --git a/linha_de_comando/conhecendo.md b/linha_de_comando/conhecendo.md index 4708924..2edd6bd 100644 --- a/linha_de_comando/conhecendo.md +++ b/linha_de_comando/conhecendo.md @@ -2,14 +2,15 @@ Para começar alguns experimentos, precisamos acessar a linha de comando primeiro. -#### Sourcelair -No Sourcelair, a linha de comando já está aberta para você, na parte inferior da tua tela. +#### Codenvy + +No Codenvy, a linha de comando já está aberta para você, na parte inferior da tua tela. ![SSH Terminal](linha_de_comando/terminal.png) #### Prompt + 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ê :) - +Cada comando será antecedido pelo sinal **\$** e um espaço, mas você não precisa digitá-lo. Seu computador fará isso por você :) diff --git a/linha_de_comando/entrando_nas_pastas.md b/linha_de_comando/entrando_nas_pastas.md index 266fcb5..50c38b3 100644 --- a/linha_de_comando/entrando_nas_pastas.md +++ b/linha_de_comando/entrando_nas_pastas.md @@ -10,8 +10,9 @@ Veja se realmente entramos na pasta: ``` $ pwd -/mnt/project/minhapasta +/projects/minhapasta ``` + Aqui está! **Dica de profissional:** se você digitar **cd m** e apertar a tecla _tab_ no seu teclado, a linha de comando irá preencher automaticamente o resto do nome para que você possa navegar rapidamente. diff --git a/linha_de_comando/limpando.md b/linha_de_comando/limpando.md index 8ee6a2c..5f58c91 100644 --- a/linha_de_comando/limpando.md +++ b/linha_de_comando/limpando.md @@ -14,7 +14,7 @@ Veja onde você está: ``` $ pwd -/mnt/project +/projects ``` Agora é hora de excluir o diretório **minhapasta**. diff --git a/linha_de_comando/linha_de_comando/prompt.png b/linha_de_comando/linha_de_comando/prompt.png index 9ce438e..a83dd1a 100644 Binary files a/linha_de_comando/linha_de_comando/prompt.png and b/linha_de_comando/linha_de_comando/prompt.png differ diff --git a/linha_de_comando/linha_de_comando/terminal.png b/linha_de_comando/linha_de_comando/terminal.png index 4b151be..3bee249 100644 Binary files a/linha_de_comando/linha_de_comando/terminal.png and b/linha_de_comando/linha_de_comando/terminal.png differ diff --git a/linha_de_comando/pasta_atual.md b/linha_de_comando/pasta_atual.md index 7f2d07e..1cf46d3 100644 --- a/linha_de_comando/pasta_atual.md +++ b/linha_de_comando/pasta_atual.md @@ -4,7 +4,7 @@ Seria legal saber em que pasta estamos agora, certo? Vamos ver. Digite o seguint ``` $ pwd -/mnt/project +/projects ``` 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. diff --git a/linha_de_comando/primeiro_comando.md b/linha_de_comando/primeiro_comando.md index faf8fc0..af3c854 100644 --- a/linha_de_comando/primeiro_comando.md +++ b/linha_de_comando/primeiro_comando.md @@ -10,11 +10,11 @@ Depois tecla Enter. Essa é nossa saída: ``` $ whoami -www-data +user ``` -Como você pode ver, o terminal só apresentou o nome de usuário, no caso `www-data`. -Isso acontece pois o nome de usuário do nosso computador ** remoto ** é ** www-data ** . +Como você pode ver, o terminal só apresentou o nome de usuário, no caso `user`. +Isso acontece pois o nome de usuário do nosso computador ** remoto ** é ** user ** . Caso você esteja fazendo esse teste em algum terminal local, a saída do terminal será seu nome de usuário. Elegante, né?:) diff --git a/linha_de_comando/resumo.md b/linha_de_comando/resumo.md index 9e2cf1e..9e67ec3 100644 --- a/linha_de_comando/resumo.md +++ b/linha_de_comando/resumo.md @@ -2,18 +2,20 @@ Aqui vai uma lista de alguns comandos úteis: -| Comando (Windows)|Comando (MacOS/Linux/Sourcelair)| Descrição | Exemplo | -|:----------------:|:-------------------:| -------------- |--------------| -| exit | exit | Fecha a janela | **exit** | -| cd | cd | Muda a pasta | **cd teste** | -| dir | ls | Lista pastas e arquivos | **dir**| -| copy | cp | Copia um arquivo | **copy c:\test\test.txt c:\windows\test.txt**| -| move | mv | Move um arquivo | **move c:\test\test.txt c:\windows\test.txt**| -| mkdir | mkdir | Cria uma pasta | **mkdir teste**| -| del | rm | Deleta uma pasta e/ou arquivo | **del c:\test\test.txt**| +| Comando (MacOS/Linux/Codenvy) | Descrição | Exemplo | +| :---------------------------: | ----------------------------- | ------------------------------------------------------- | +| exit | Fecha a janela | **exit** | +| cd | Muda a pasta | **cd teste** | +| ls | Lista pastas e arquivos | **ls** | +| cp | Copia um arquivo | **cp /projects/minhapasta/test.txt /projects/test.txt** | +| mv | Move um arquivo | **mv projects/minhapasta/test.txt /projects** | +| mkdir | Cria uma pasta | **mkdir teste** | +| rm | Deleta uma pasta e/ou arquivo | **rm /projects/minhapasta/test.txt** | Estes são apenas alguns dos poucos comandos que você pode executar em sua linha de comando, mas você não vai usar mais nada do que isto hoje. +Alguns comandos podem variar no sistema operacional Windows. + Se você estiver curioso, [ss64.com](ss64.com) contém uma referência completa de comandos para todos os sistemas operacionais. **Vamos começar? ** diff --git a/python/introducao.md b/python/introducao.md index eb637fd..8326907 100644 --- a/python/introducao.md +++ b/python/introducao.md @@ -8,7 +8,8 @@ Vamos escrever um pouco de código! Para começar a brincar com Python nós precisamos abrir uma linha de comando no seu computador. Você já deve saber como fazer isso -- você aprendeu isso no capítulo [Introdução à Linha de Comando](../linha_de_comando/introducao.md). Assim que estiver pronto(a), siga as instruções abaixo. -Nós queremos abrir o Python num terminal, então digite python3 no terminal (verifique se está na janela que aparece usuario@AfroPython:/mnt/project$) e tecle Enter. +Nós queremos abrir o Python num terminal, então digite python3 no terminal (verifique se está na janela que aparece user@f6107045ef8b:/projects\$) e tecle Enter. + ``` $ python3 Python 3.6.5 (...) @@ -17,15 +18,16 @@ Type "copyright", "credits" or "license" for more information. ``` ## Seu primeiro comando Python! -Depois de executar o comando Python, o prompt mudou para ``>>>``. Para nós, isso significa que por enquanto só utilizaremos comandos na linguagem Python. Você não precisa digitar ``>>>`` - O Python fará isso por você. -Se você deseja sair do console do Python, apenas digite ``exit()`` ou use o atalho ``Ctrl + D`` no Mac/Linux. Então você não vai ver mais o ``>>>``. -Mas agora não queremos sair da linha de comando do Python. Queremos aprender mais sobre ele. Entre novamente em nosso interpretador (digite ``python3``). Vamos, então, fazer algo muito simples. Por exemplo, tente digitar alguma operação matemática, como ``2 + 3`` e aperte Enter. + +Depois de executar o comando Python, o prompt mudou para `>>>`. Para nós, isso significa que por enquanto só utilizaremos comandos na linguagem Python. Você não precisa digitar `>>>` - O Python fará isso por você. +Se você deseja sair do console do Python, apenas digite `exit()` ou use o atalho `Ctrl + D` no Mac/Linux. Então você não vai ver mais o `>>>`. +Mas agora não queremos sair da linha de comando do Python. Queremos aprender mais sobre ele. Entre novamente em nosso interpretador (digite `python3`). Vamos, então, fazer algo muito simples. Por exemplo, tente digitar alguma operação matemática, como `2 + 3` e aperte Enter. ``` >>> 2 + 3 5 ``` -Incrível! Vê como a resposta simplesmente aparece? O Python conhece matemática! Você pode tentar outros comandos como: - ``4 * 5`` - ``5 - 1`` - ``40 / 2`` +Incrível! Vê como a resposta simplesmente aparece? O Python conhece matemática! Você pode tentar outros comandos como: - `4 * 5` - `5 - 1` - `40 / 2` Divirta-se com isso por um tempo e depois volte aqui :). Como você pode ver, o Python é uma ótima calculadora. Se você está se perguntando o que mais você pode fazer... Vamos aprender um pouco mais? diff --git a/query-set-orm/shell_do_django.md b/query-set-orm/shell_do_django.md index d7d6986..97f58a2 100644 --- a/query-set-orm/shell_do_django.md +++ b/query-set-orm/shell_do_django.md @@ -2,7 +2,7 @@ Abra o terminal e digite: ```` -...@AfroPython:/mnt/project$ python3 manage.py shell +(django) user@b3592ed04e17:/projects/afropython$ python3 manage.py shell ``` O resultado deve ser: diff --git a/salve_o_codigo/intro.md b/salve_o_codigo/intro.md index 96479af..b6af17f 100644 --- a/salve_o_codigo/intro.md +++ b/salve_o_codigo/intro.md @@ -1,12 +1,14 @@ # Salvando o código + Até agora nós escrevemos todo nosso código em um interpretador python, que nos limita a uma linha de código em um momento. Programas normais são salvos em arquivos e executados pelo nosso **interpretador** de linguagem de programação ou **compilador**. Até agora só executamos nossos programas de uma linha de cada vez no **interpretador Python**. Nós vamos precisar de mais de uma linha de código para as próximas tarefas, então precisaremos rapidamente: - Sair do interpretador Python -- Abrir o editor de código -- Salvar algum código em um novo arquivo python +- Abrir o arquivo ** python_intro.py ** no editor de código +- Salvar algum código no arquivo python `python_intro.py` - Executá-lo! Para sair do interpretador Python que estamos usando, simplesmente digite a função `exit()`: + ``` >>> exit() $ @@ -14,26 +16,34 @@ $ Isso vai colocá-la(o) no prompt de comando. -Nós precisamos criar um novo arquivo para escrever o código, para isso clique no primeiro botão do menu horizontal, depois em Create New File: +Vamos abrir o arquivo `python_intro.py` que criamos anteriormente. Você pode clicar duas vezes no arquivo no ** Projects Explorar ** para abri-lo -![Criar arquivo](salve_o_codigo/novo_arquivo.png) +![Editar](salve_o_codigo/editor_aberto.png) -Vamos chamar o arquivo de `python_intro.py` e salvá-lo. Podemos nomear o arquivo de tudo o que quisermos, o importante aqui é ter certeza que o arquivo termina com `py`, isto diz nosso computador que é um `arquivo executável de python` e Python pode executá-lo. +Podemos nomear o arquivo de tudo o que quisermos, o importante aqui é ter certeza que o arquivo termina com `py`, isto diz nosso computador que é um `arquivo executável de python` e Python pode executá-lo. Agora você pode escrever seu programa. + ``` print('Olá, AfroPython!') ``` ->Nota: Você deve observar que uma das coisas mais legais sobre editores de código: cores! No console do Python, tudo era da mesma cor, mas agora você deve ver que a função de ``Imprimir`` é uma cor diferente da sequência de caracteres no seu interior. Isso é chamado de ``"realce de sintaxe"``, e é uma ajuda muito útil quando está programando. Perceba a cor das coisas e você vai obter uma dica para quando você esquecer de fechar uma seqüência de caracteres, ou fazer um erro de digitação em um nome de palavra-chave (como ``def`` em uma função, que veremos abaixo). Esta é uma das razões pelas quais nós usamos um editor de código :) +> Nota: Você deve observar que uma das coisas mais legais sobre editores de código: cores! No console do Python, tudo era da mesma cor, mas agora você deve ver que a função de `Imprimir` é uma cor diferente da sequência de caracteres no seu interior. Isso é chamado de `"realce de sintaxe"`, e é uma ajuda muito útil quando está programando. Perceba a cor das coisas e você vai obter uma dica para quando você esquecer de fechar uma seqüência de caracteres, ou fazer um erro de digitação em um nome de palavra-chave (como `def` em uma função, que veremos abaixo). Esta é uma das razões pelas quais nós usamos um editor de código :) Obviamente, você é um(a) desenvolvedor(a) python bastante experiente agora, então sinta-se livre para escrever um código que você aprendeu hoje. -Não esqueça de salvar as modificações no seu arquivo (`Save File, ou utilize o atalho Ctrl + S`). Com o arquivo salvo, é hora de executá-lo! Usando as habilidades que você aprendeu na seção de linha de comando, use o terminal para chegar na pasta em que seu arquivo foi salvo. +O Codenvy salva as modificações no arquivo automaticamente. Com o arquivo salvo, é hora de executá-lo! Usando as habilidades que você aprendeu na seção de linha de comando, use o terminal para chegar na pasta em que seu arquivo foi salvo. Se você ficar presa, peça ajuda. +Primeiro, vamos entrar na pasta ** codigo-python ** onde o arquivo se encontra. Se você já estiver dentro da pasta, então ignore o comando abaixo. + +``` +$ cd codigo-python +``` + Em seguida, usar o Python para executar o código no arquivo assim: + ``` $ python3 python_intro.py Olá, AfroPython! diff --git a/salve_o_codigo/salve_o_codigo/editor_aberto.png b/salve_o_codigo/salve_o_codigo/editor_aberto.png new file mode 100644 index 0000000..ef15936 Binary files /dev/null and b/salve_o_codigo/salve_o_codigo/editor_aberto.png differ diff --git a/salve_o_codigo/salve_o_codigo/novo_arquivo.png b/salve_o_codigo/salve_o_codigo/novo_arquivo.png deleted file mode 100644 index 626a86f..0000000 Binary files a/salve_o_codigo/salve_o_codigo/novo_arquivo.png and /dev/null differ diff --git a/urls/como_funcionam_as_urls_em_django.md b/urls/como_funcionam_as_urls_em_django.md index 631ba73..32166a2 100644 --- a/urls/como_funcionam_as_urls_em_django.md +++ b/urls/como_funcionam_as_urls_em_django.md @@ -1,6 +1,6 @@ # Como funcionam as URLs em Django? -Vamos abrir o arquivo `AfroPython/urls.py`, ele deve ser alterado para ficar assim: +Vamos abrir o arquivo `afropython/urls.py`, ele deve ser alterado para ficar assim: ``` from django.contrib import admin diff --git a/urls/sua_primeira_url_django.md b/urls/sua_primeira_url_django.md index a35e2c5..db7e4e6 100644 --- a/urls/sua_primeira_url_django.md +++ b/urls/sua_primeira_url_django.md @@ -2,11 +2,12 @@ É hora de criar nossa primeira URL! Queremos que nossa página inicial do nosso blog e exibir uma lista de posts. -Também queremos manter o arquivo de `AfroPython/urls.py` limpo, aí nós importaremos urls da nossa aplicação blog para o arquivo principal `AfroPython/urls.py`. +Também queremos manter o arquivo de `afropython/urls.py` limpo, aí nós importaremos urls da nossa aplicação blog para o arquivo principal `afropython/urls.py`. Vá em frente e adicione uma linha que vai importar `blog.urls` para a url principal (`''`). -O seu arquivo `AfroPython/urls.py` deve agora se parecer com isto: +O seu arquivo `afropython/urls.py` deve agora se parecer com isto: + ``` from django.contrib import admin from django.urls import include, path