diff options
Diffstat (limited to 'pt-br')
| -rw-r--r-- | pt-br/awk-pt.html.markdown | 6 | ||||
| -rw-r--r-- | pt-br/c++-pt.html.markdown | 2 | ||||
| -rw-r--r-- | pt-br/c-pt.html.markdown | 5 | ||||
| -rw-r--r-- | pt-br/clojure-pt.html.markdown | 2 | ||||
| -rw-r--r-- | pt-br/csharp-pt.html.markdown | 4 | ||||
| -rw-r--r-- | pt-br/dart-pt.html.markdown | 5 | ||||
| -rw-r--r-- | pt-br/git-pt.html.markdown | 340 | ||||
| -rw-r--r-- | pt-br/go-pt.html.markdown | 2 | ||||
| -rw-r--r-- | pt-br/groovy-pt.html.markdown | 15 | ||||
| -rw-r--r-- | pt-br/latex-pt.html.markdown | 101 | ||||
| -rw-r--r-- | pt-br/lua-pt.html.markdown | 2 | ||||
| -rw-r--r-- | pt-br/make-pt.html.markdown | 4 | ||||
| -rw-r--r-- | pt-br/markdown-pt.html.markdown | 265 | ||||
| -rw-r--r-- | pt-br/matlab-pt.html.markdown | 16 | ||||
| -rw-r--r-- | pt-br/php-pt.html.markdown | 2 | ||||
| -rw-r--r-- | pt-br/processing-pt.html.markdown | 480 | ||||
| -rw-r--r-- | pt-br/pythonstatcomp-pt.html.markdown | 249 | ||||
| -rw-r--r-- | pt-br/qt-pt.html.markdown | 2 | ||||
| -rw-r--r-- | pt-br/r-pt.html.markdown | 786 | ||||
| -rw-r--r-- | pt-br/rust-pt.html.markdown | 2 | ||||
| -rw-r--r-- | pt-br/sql-pt.html.markdown | 119 | ||||
| -rw-r--r-- | pt-br/tmux-pt.html.markdown | 48 | ||||
| -rw-r--r-- | pt-br/visualbasic-pt.html.markdown | 40 | ||||
| -rw-r--r-- | pt-br/yaml-pt.html.markdown | 157 | 
24 files changed, 2325 insertions, 329 deletions
diff --git a/pt-br/awk-pt.html.markdown b/pt-br/awk-pt.html.markdown index 70d0a01c..02bffc41 100644 --- a/pt-br/awk-pt.html.markdown +++ b/pt-br/awk-pt.html.markdown @@ -202,7 +202,7 @@ function string_functions(    localvar, arr) {      # Ambas retornam o número de instâncias substituídas      localvar = "fooooobar"      sub("fo+", "Meet me at the ", localvar) # localvar => "Meet me at the bar" -    gsub("e+", ".", localvar) # localvar => "m..t m. at th. bar" +    gsub("e", ".", localvar) # localvar => "M..t m. at th. bar"      # Localiza um texto que casa com uma expressão regular      # index() faz a mesma coisa, mas não permite uma expressão regular @@ -370,8 +370,10 @@ END {  }  ``` +  Leituras adicionais (em inglês):  * [Awk tutorial](http://www.grymoire.com/Unix/Awk.html)  * [Awk man page](https://linux.die.net/man/1/awk) -* [The GNU Awk User's Guide](https://www.gnu.org/software/gawk/manual/gawk.html) GNU AWK é encontrado na maioria dos sistemas GNU/Linux. +* [The GNU Awk User's Guide](https://www.gnu.org/software/gawk/manual/gawk.html) +  GNU AWK é encontrado na maioria dos sistemas GNU/Linux. diff --git a/pt-br/c++-pt.html.markdown b/pt-br/c++-pt.html.markdown index 42a29991..7d8b75f1 100644 --- a/pt-br/c++-pt.html.markdown +++ b/pt-br/c++-pt.html.markdown @@ -1,5 +1,5 @@  --- -language: c++ +language: C++  filename: learncpp-pt.cpp  contributors:      - ["Steven Basart", "http://github.com/xksteven"] diff --git a/pt-br/c-pt.html.markdown b/pt-br/c-pt.html.markdown index 4e55f068..c3f62bc6 100644 --- a/pt-br/c-pt.html.markdown +++ b/pt-br/c-pt.html.markdown @@ -1,6 +1,6 @@  --- -language: c -filename: learnc.c +language: C +filename: learnc-pt.c  contributors:      - ["Adam Bard", "http://adambard.com/"]      - ["Árpád Goretity", "http://twitter.com/H2CO3_iOS"] @@ -10,7 +10,6 @@ translators:      - ["Cássio Böck", "https://github.com/cassiobsilva"]      - ["Heitor P. de Bittencourt", "https://github.com/heitorPB/"]  lang: pt-br -filename: c-pt.el  ---  Ah, C. Ainda é **a** linguagem de computação de alta performance. diff --git a/pt-br/clojure-pt.html.markdown b/pt-br/clojure-pt.html.markdown index e40b8fe7..15ad930a 100644 --- a/pt-br/clojure-pt.html.markdown +++ b/pt-br/clojure-pt.html.markdown @@ -561,7 +561,7 @@ Caso queira aprender mais:  [http://clojuredocs.org/quickref/Clojure%20Core](http://clojuredocs.org/quickref/Clojure%20Core)  * 4clojure possui alguns problemas e desafios interessantes para quem quiser treinar clojure ou programação funcional: -[http://www.4clojure.com/](http://www.4clojure.com/) +[https://4clojure.oxal.org/](https://4clojure.oxal.org/)  * clojure-doc.org tem um bom número de artigos para iniciantes:  [http://clojure-doc.org/](http://clojure-doc.org/) diff --git a/pt-br/csharp-pt.html.markdown b/pt-br/csharp-pt.html.markdown index 384ca325..87e5b3a4 100644 --- a/pt-br/csharp-pt.html.markdown +++ b/pt-br/csharp-pt.html.markdown @@ -1,5 +1,5 @@  --- -language: c# +language: C#  filename: csharp-pt.cs  contributors:      - ["Robson Alves", "http://robsonalves.net/"]     @@ -153,7 +153,7 @@ on a new line! ""Wow!"", the masses cried";              intArray[1] = 1;              // Listas -            // Listas são usadas frequentemente tanto quanto matriz por serem mais flexiveis +            // Listas são usadas frequentemente tanto quanto matriz por serem mais flexíveis              // O formato de declarar uma lista é o seguinte:              // List<tipodado> <var nome> = new List<tipodado>();              List<int> intList = new List<int>(); diff --git a/pt-br/dart-pt.html.markdown b/pt-br/dart-pt.html.markdown index e9d72850..6aff1ac3 100644 --- a/pt-br/dart-pt.html.markdown +++ b/pt-br/dart-pt.html.markdown @@ -3,15 +3,16 @@ language: dart  filename: learndart-pt.dart  contributors:      - ["Joao Pedrosa", "https://github.com/jpedrosa/"] +    - ["Hélio Oliveira", "https://github.com/insign/"]  translators:      - ["Junior Damacena", "https://github.com/jdamacena/"]  lang: pt-br  ---  Dart é uma novata no reino das linguagens de programação. -Ela empresta muito de outras linguagens mais conhecidas, e tem a meta de não se diferenciar muito de seu irmão, JavaScript. Assim como JavaScript, Dart foi pensada para oferecer grande integração com o Browser. +Ela absorve muitas teorias de outras linguagens mais conhecidas, e tem a meta de não se diferenciar muito de seu irmão, JavaScript. Assim como JavaScript, Dart foi pensada para oferecer grande integração com o navegador. -A característica mais controversa da Dart é a sua Tipagem Opcional, ou seja, não é obrigatório declarar tipos. +As variáveis em Dart tem tipos, mas não é obrigatório declarar devido à função de [detecção automática](https://dart.dev/guides/language/type-system#type-inference).  ```dart  import "dart:collection"; diff --git a/pt-br/git-pt.html.markdown b/pt-br/git-pt.html.markdown index e59ba901..2cc1c337 100644 --- a/pt-br/git-pt.html.markdown +++ b/pt-br/git-pt.html.markdown @@ -11,6 +11,7 @@ contributors:  translators:    - ["Suzane Sant Ana", "http://github.com/suuuzi"]    - ["Bruno Volcov", "http://github.com/volcov"] +  - ["Marcel Ribeiro-Dantas", "http://github.com/mribeirodantas"]  ---  Git é um sistema distribuido de gestão para código fonte e controle de versões. @@ -67,7 +68,8 @@ referências e outros.  ### *Working Tree* (componente do repositório) -A *Working Tree* é basicamente a listagem dos diretórios e arquivos do repositório. É chamada também de diretório do projeto. +A *Working Tree* é basicamente a listagem dos diretórios e arquivos do +repositório. É chamada também de diretório do projeto.  ### *Index* (componente do diretório .git) @@ -77,28 +79,37 @@ maior controle sobre o que é registado no repositório git.  ### *Commit* -Um *commit** de git é um registo de um cojunto de alterações ou manipulações nos arquivos do projeto. -Por exemplo, ao adicionar cinco arquivos e remover outros 2, estas alterações -serão gravadas num *commit* (ou registo). Este *commit* pode então ser enviado -para outros repositórios ou não! +Um *commit** de git é um registo de um conjunto de alterações ou manipulações +nos arquivos do projeto. Por exemplo, ao adicionar cinco arquivos e remover +outros 2, estas alterações serão gravadas em um *commit* (ou registro). Este +*commit* pode então ser enviado para outros repositórios, caso você queira.  ### *Branch* -Um *branch* é essencialmente uma referência que aponta para o último *commit* +Uma *branch* é essencialmente uma referência que aponta para o último *commit*  efetuado. Na medida que são feitos novos commits, esta referência é atualizada  automaticamente e passa a apontar para o commit mais recente.  ### *Tag*  Uma tag é uma marcação em um ponto específico da história. Geralmente as -pessoas usam esta funcionalidade para marcar pontos de release (v2.0, e por aí vai) +pessoas usam esta funcionalidade para marcar pontos de release (v2.0, e por aí +vai)  ### *HEAD* e *head* (componentes do diretório .git) -*HEAD* é a referência que aponta para o *branch* em uso. Um repositório só tem -uma *HEAD* activa. -*head* é uma referência que aponta para qualquer *commit*. Um repositório pode -ter um número indefinido de *heads* +*HEAD* é a referência que aponta para a *branch* em uso. Um repositório só tem +uma *HEAD* activa. *head* é uma referência que aponta para qualquer *commit*. Um +repositório pode ter um número indefinido de *heads*. + +### Estados no Git + +* Modificado (Modified): Ocorreram mudanças em ao menos um arquivo mas essas +mudanças ainda não foram registradas na base de dados do Git +* Preparado (Staged): Marca o arquivo como preparado para ser adicionado ao +próximo commit +* Consolidado (Committed): As mudanças foram registradas na base de dados do +Git  ### Recursos conceituais (EN) @@ -109,8 +120,8 @@ ter um número indefinido de *heads*  ### *init* -Cria um repositório Git vazio. As definições, informação guardada e outros do -repositório git são guardados em uma pasta chamada ".git". +Cria um repositório Git vazio. As configurações do repositório, e outras +informações são guardadas em uma pasta dentro do repositório com o nome ".git".  ```bash  $ git init @@ -118,23 +129,24 @@ $ git init  ### *config* -Permite configurar as definições, sejam as definições do repositório, sistema -ou configurações globais. +Permite configurar o git, seja com respeito a definições deste repositório, +do sistema ou configurações globais para todos os repositórios.  ```bash -# Imprime e define algumas variáveis de configuração básicas (global) -$ git config --global user.email -$ git config --global user.name - +# Define e imprime algumas variáveis de configuração básicas (global)  $ git config --global user.email "MyEmail@Zoho.com"  $ git config --global user.name "My Name" + +$ git config --global user.email +$ git config --global user.name  ```  [Aprenda mais sobre git config. (EN)](http://git-scm.com/docs/git-config)  ### help -Para visualizar rapidamente o detalhamento de cada comando ou apenas lembrar da semântica. +Para visualizar rapidamente o detalhamento de cada comando ou apenas lembrar da +semântica.  ```bash  # Ver rapidamente os comandos disponiveis @@ -148,16 +160,32 @@ $ git help -a  $ git help add  $ git help commit  $ git help init +# ou git <comando_aqui> --help +$ git add --help +$ git commit --help +$ git init --help +``` + +### Ignorando arquivos + +É possível intencionalmente ignorar arquivos e pastas. Costuma-se utilizar o +arquivo .gitignore para fazer o git ignorar a existência de arquivos e pastas +geralmente utilizados para arquivos privados ou temporários que, de outro modo, +seriam compartilhados com todos que tem acesso ao repositório. + +```bash +$ echo "temp/" >> .gitignore +$ echo "chave_privada" >> .gitignore  ```  ### status -Apresenta as diferenças entre o arquivo *index* (a versão corrente -do repositório) e o *commit* da *HEAD* atual. +Apresenta as diferenças entre o arquivo *index* (a versão corrente do +repositório) e o *commit* da *HEAD* atual.  ```bash -# Apresenta o *branch*, arquivos não monitorados, alterações e outras +# Apresenta a *branch*, arquivos não monitorados, alterações e outras  # diferenças  $ git status @@ -173,35 +201,42 @@ incluidos nos commits!  ```bash  # adiciona um arquivo no diretório do projeto atual -$ git add HelloWorld.java +$ git add OlaMundo.java -# adiciona um arquivo num sub-diretório -$ git add /path/to/file/HelloWorld.c +# adiciona um arquivo em um sub-diretório +$ git add /caminho/para/arquivo/OlaMundo.java  # permite usar expressões regulares!  $ git add ./*.java + +# Você também pode adicionar tudo no seu diretório de trabalho como alterações +prontas para o próximo commit. +$ git add -A  ``` +Esse comando apenas adiciona os arquivos no estado de preparados para o próximo +commit, mas não realiza o commit de fato. +  ### branch -Gerencia os *branches*. É possível ver, editar, criar e apagar branches com este +Gerencia as *branches*. É possível ver, editar, criar e apagar branches com este  comando.  ```bash  # listar *branches* existentes e remotos  $ git branch -a -# criar um novo *branch* +# criar uma nova *branch*  $ git branch myNewBranch -# apagar um *branch* +# apagar uma *branch*  $ git branch -d myBranch -# alterar o nome de um *branch* +# alterar o nome de uma *branch*  # git branch -m <oldname> <newname>  $ git branch -m myBranchName myNewBranchName -# editar a descrição de um *branch* +# editar a descrição de uma *branch*  $ git branch myBranchName --edit-description  ``` @@ -212,18 +247,22 @@ Gerencia as *tags*  ```bash  # Listar tags  $ git tag +  # Criar uma tag anotada.  # O parâmetro -m define uma mensagem, que é armazenada com a tag.  # Se você não especificar uma mensagem para uma tag anotada,  # o Git vai rodar seu editor de texto para você digitar alguma coisa.  $ git tag -a v2.0 -m 'minha versão 2.0' +  # Mostrar informações sobre a tag  # O comando mostra a informação da pessoa que criou a tag,  # a data de quando o commit foi taggeado,  # e a mensagem antes de mostrar a informação do commit.  $ git show v2.0 +  # Enviar uma tag para o repositório remoto  $ git push origin v2.0 +  # Enviar várias tags para o repositório remoto  $ git push origin --tags  ``` @@ -231,14 +270,16 @@ $ git push origin --tags  ### checkout  Atualiza todos os arquivos no diretório do projeto para que fiquem iguais -à versão do index ou do *branch* especificado. +à versão do index ou da *branch* especificado.  ```bash -# Checkout de um repositório - por padrão para o branch master +# Checkout de um repositório - por padrão para a branch master  $ git checkout -# Checkout de um branch especifico + +# Checkout de uma branch especifica  $ git checkout branchName -# Cria um novo branch e faz checkout para ele. + +# Cria uma nova branch e faz checkout para ela.  # Equivalente a: "git branch <name>; git checkout <name>"  $ git checkout -b newBranch  ``` @@ -246,22 +287,41 @@ $ git checkout -b newBranch  ### clone  Clona ou copia um repositório existente para um novo diretório. Também -adiciona *branches* de monitoramento remoto para cada *branch* no repositório -clonado o que permite enviar alterações para um *branch* remoto. +adiciona *branches* no repositório clonado para cada *branch* no repositório +remoto o que permite enviar alterações para uma *branch* no repositório remoto.  ```bash  # Clona learnxinyminutes-docs  $ git clone https://github.com/adambard/learnxinyminutes-docs.git + +# Clone superficial - É mais rápido, mas puxa apenas o último commit +$ git clone --depth 1 https://github.com/adambard/learnxinyminutes-docs.git + +# Clona apenas uma branch em específica +$ git clone -b master-cn https://github.com/adambard/learnxinyminutes-docs.git --single-branch  ```  ### commit -Guarda o conteudo atual do index num novo *commit*. Este *commit* contém +Guarda o conteúdo atual do index em um novo *commit*. Este *commit* contém  as alterações feitas e a mensagem criada pelo usuário.  ```bash -# commit com uma mensagem -$ git commit -m "Added multiplyNumbers() function to HelloWorld.c" +# Realiza um commit com uma mensagem +$ git commit -m "Adicione a função multipliqueNumeros() em OlaMundo.c" + +# Assine um commit com sua chave GPG. Antes disso, você precisa ter +# configurado a opção user.signkey do git com o comando: +# git config --global user.signinkey ID_CHAVE_AQUI +$ git commit -S -m "mensagem do commit aqui" + +# Automaticamente adicione como preparados arquivos modificados ou apagados e +# então realize um commit: +$ git commit -a -m "Modified foo.php and removed bar.php" + +# Altere o último commit (Esse comando cria um novo commit com o conteúdo do +# commit anterior mais suas novas alterações e sobrescreve o último commit) +$ git commit --amend -m "Correct message"  ```  ### diff @@ -282,7 +342,7 @@ $ git diff HEAD  ### grep -Permite procurar facilmente num repositório +Permite procurar facilmente em um repositório.  Configurações opcionais: @@ -313,74 +373,158 @@ Apresenta commits do repositório.  # Apresenta todos os commits  $ git log -# Apresenta X commits -$ git log -n 10 +# Apresenta apenas mensagem do commit e referência +$ git log --oneline  # Apresenta apenas commits de merge  $ git log --merges + +# Apresenta todos os commits representados por um gráfico em ASCII +$ git log --graph  ```  ### merge -"Merge" junta as alterações de commits externos com o *branch* atual. +"Merge" junta as alterações de commits externos com a *branch* atual.  ```bash -# Junta o branch especificado com o atual +# Junta a branch especificada com o atual  $ git merge branchName -# Para gerar sempre um commit ao juntar os branches +# Para gerar sempre um commit ao juntar as branches  $ git merge --no-ff branchName  ```  ### mv -Alterar o nome ou mover um arquivo. +Altera o nome ou move um arquivo.  ```bash  # Alterar o nome de um arquivo -$ git mv HelloWorld.c HelloNewWorld.c +$ git mv OlaMundo.c OlaNovoMundo.c  # Mover um arquivo -$ git mv HelloWorld.c ./new/path/HelloWorld.c +$ git mv OlaMundo.c ./novo/caminho/OlaMundo.c -# Forçar a alteração de nome ou mudança local -# "existingFile" já existe no directório, será sobrescrito. +# Forçar a alteração de nome ou mudança de local +# Se o arquivo já existir no diretório, será sobrescrito.  $ git mv -f myFile existingFile  ```  ### pull -Puxa alterações de um repositório e as junta com outro branch +Puxa alterações de um repositório e as junta com outra branch  ```bash  # Atualiza o repositório local, juntando as novas alterações  # do repositório remoto 'origin' e branch 'master'  # git pull <remote> <branch> -# git pull => aplica a predefinição => git pull origin master  $ git pull origin master -# Juntar alterações do branch remote e fazer rebase commits do branch +# Por padrão, o git irá realizar o pull na branch atual fazendo um merge +# com as alterações novas na branch remota +$ git pull + +# Juntar alterações da branch remote e fazer rebase commits da branch  # no repositório local, como: "git pull <remote> <branch>, git rebase <branch>"  $ git pull origin master --rebase  ```  ### push -Enviar e juntar alterações de um branch para o seu branch correspondente -num repositório remoto. +Enviar e juntar alterações de uma branch para a sua branch correspondente +em um repositório remoto.  ```bash  # Envia e junta as alterações de um repositório local -# para um remoto denominado "origin" no branch "master". +# para um remoto denominado "origin" na branch "master".  # git push <remote> <branch> -# git push => aplica a predefinição => git push origin master  $ git push origin master + +# Por padrão, o git push irá enviar e realizar merge das mudanças da sua branch +# local com a branch remota +$ git push + +# Para associar a branch local com uma branch específica remota, adicione a +# flag -u +$ git push -u origin master + +# Agora, sempre que você realizar um push daquela branch local, use o atalho: +$ git push  ``` +### stash + +O objetivo desse comando do git é pegar o estado "sujo" do seu diretório de +trabalho, que não está pronto (staged), e salvá-lo em um outro lugar para que +você possa trabalhar no seu repositório do zero, mas sem perder as mudanças que +fez. Em qualquer outro momento que você quiser, você pode trazer de volta as +alterações que você tirou dali com o comando stash. + +Digamos que você tem feito algumas alterações no seu repositório, mas agora +você quer realizar um pull do repositório remoto. Como você tem alterações não +commitadas no seu diretório (ele está "sujo"), você não irá conseguir realizar +o `git pull` com sucesso. Mas você pode executar o `git stash` para salvar +essas alterações e conseguir realizar o pull. Depois, você traz de volta. + +```bash +$ git stash +Saved working directory and index state \ +  "WIP on master: 049d078 added the index file" +  HEAD is now at 049d078 added the index file +  (To restore them type "git stash apply") +``` + +Agora você irá conseguir realizar o pull! + +```bash +git pull +``` +`...changes apply...` + +Verifique se está tudo OK com o `git status` + +```bash +$ git status +# On branch master +nothing to commit, working directory clean +``` + +É possível verificar as alterações que você guardou com cada uso do comando +`git stash` com o `git stash list`. Como os usos desse comando são guardados +como em uma pilha, os usos mais recentes estarão no topo. + +```bash +$ git stash list +stash@{0}: WIP on master: 049d078 added the index file +stash@{1}: WIP on master: c264051 Revert "added file_size" +stash@{2}: WIP on master: 21d80a5 added number to log +``` + +Agora vamos trazer o que havíamos salvado com o `git stash` de volta para o +diretório de trabalho. + +```bash +$ git stash pop +# On branch master +# Changes not staged for commit: +#   (use "git add <file>..." to update what will be committed) +# +#      modified:   index.html +#      modified:   lib/simplegit.rb +# +``` + +`git stash apply` faz a mesma coisa + +Agora podemos voltar a trabalhar no que havíamos deixado de lado! + +[Additional Reading.](http://git-scm.com/book/en/v1/Git-Tools-Stashing) +  ### rebase (cautela!) -Pega em todas as alterações que foram registadas num branch e volta a -aplicá-las em outro branch. +Pega em todas as alterações que foram registadas em uma branch e volta a +aplicá-las em outra branch.  *Não deve ser feito rebase de commits que foram enviados para um repositório  público* @@ -407,31 +551,79 @@ $ git reset  # sobrescreve o projeto atual  $ git reset --hard -# Move a head do branch atual para o commit especificado, sem alterar o projeto. +# Move a head da branch atual para o commit especificado, sem alterar o projeto.  # todas as alterações ainda existem no projeto  $ git reset 31f2bb1 -# Inverte a head do branch atual para o commit especificado +# Inverte a head da branch atual para o commit especificado  # fazendo com que este esteja em sintonia com o diretório do projeto -# Remove alterações não registadas e todos os commits após o commit especificado +# Remove alterações não registradas e todos os commits após o commit +# especificado  $ git reset --hard 31f2bb1  ``` +### reflog (cuidado!) + +O reflog irá listar a maior parte dos comandos que você realizou no git em um +determinado intervalo de tempo. O intervalo padrão é de 90 dias. + +Isso te dá a oportunidade de reverter qualquer comando que você realizou no git +e que tenha tido consequências indesejadas (por exemplo, se um rebase quebrou +sua aplicação). + +Você pode fazer assim: + +1. `git reflog` para listar todos os comandos utilizados no git para o rebase + +``` +38b323f HEAD@{0}: rebase -i (finish): returning to refs/heads/feature/add_git_reflog +38b323f HEAD@{1}: rebase -i (pick): Clarify inc/dec operators +4fff859 HEAD@{2}: rebase -i (pick): Update java.html.markdown +34ed963 HEAD@{3}: rebase -i (pick): [yaml/en] Add more resources (#1666) +ed8ddf2 HEAD@{4}: rebase -i (pick): pythonstatcomp spanish translation (#1748) +2e6c386 HEAD@{5}: rebase -i (start): checkout 02fb96d +``` +2. Selecione para onde você quer resetar. No nosso exemplo, seria o commit +`2e6c386`, ou `HEAD@{5}` +3. 'git reset --hard HEAD@{5}' esse comando irá resetar o seu repositório para +aquele ponto (5 commits atrás). +4. Agora você pode recomeçar o rebase ou apenas deixar como está. + +[Leitura complementar](https://git-scm.com/docs/git-reflog) + +### revert + +O comando revert pode ser utilizado para desfazer um commit. Não deve ser +confundido com o comando reset que restabelece o estado do repositório para um +momento anterior. O revert irá criar um novo commit com alterações inversas a +de um outro commit especificado, portanto revertendo aquelas alterações. + +```bash +# Revertendo um commit específico +$ git revert <commit> +``` +  ### rm -O oposto de git add, git rm remove arquivos do branch atual. +O oposto de git add, git rm remove arquivos da branch atual.  ```bash -# remove HelloWorld.c -$ git rm HelloWorld.c +# remove OlaMundo.c +$ git rm OlaMundo.c -# Remove um arquivo de um sub-directório -$ git rm /pather/to/the/file/HelloWorld.c +# Remove um arquivo de um sub-diretório +$ git rm /caminho/para/o/arquivo/OlaMundo.c  ``` -## Informação complementar (EN) +## Leitura complementar + +* [Configurar o Git (GitHub Docs)](https://docs.github.com/pt/get-started/quickstart/set-up-git) + +* [Learn Git Branching - the most visual and interactive way to learn Git on the web](http://learngitbranching.js.org/) -* [tryGit - A fun interactive way to learn Git.](http://try.github.io/levels/1/challenges/1) +* [Udemy Git Tutorial: A Comprehensive Guide](https://blog.udemy.com/git-tutorial-a-comprehensive-guide/) + +* [Git Immersion - A Guided tour that walks through the fundamentals of git](http://gitimmersion.com/)  * [git-scm - Video Tutorials](http://git-scm.com/videos) @@ -441,4 +633,10 @@ $ git rm /pather/to/the/file/HelloWorld.c  * [SalesForce Cheat Sheet](https://na1.salesforce.com/help/doc/en/salesforce_git_developer_cheatsheet.pdf) -* [GitGuys](http://www.gitguys.com/) +* [Git - the simple guide](http://rogerdudler.github.io/git-guide/index.html) + +* [Pro Git (em Português)](https://www.git-scm.com/book/pt-br/v2) + +* [An introduction to Git and GitHub for Beginners (Tutorial)](http://product.hubspot.com/blog/git-and-github-tutorial-for-beginners) + +* [The New Boston tutorial to Git covering basic commands and workflow](https://www.youtube.com/playlist?list=PL6gx4Cwl9DGAKWClAD_iKpNC0bGHxGhcx) diff --git a/pt-br/go-pt.html.markdown b/pt-br/go-pt.html.markdown index 31473ee1..f68d63eb 100644 --- a/pt-br/go-pt.html.markdown +++ b/pt-br/go-pt.html.markdown @@ -28,7 +28,7 @@ Go vem com uma biblioteca padrão exaustiva e uma comunidade entusiasta.     várias linhas */  // A cláusula package aparece no início de cada arquivo. -// Main é um nome especial declarando um executável ao invés de uma biblioteca. +// main é um nome especial declarando um executável ao invés de uma biblioteca.  package main  // A cláusula Import declara os pacotes referenciados neste arquivo. diff --git a/pt-br/groovy-pt.html.markdown b/pt-br/groovy-pt.html.markdown index 3acfce21..dff3f2e1 100644 --- a/pt-br/groovy-pt.html.markdown +++ b/pt-br/groovy-pt.html.markdown @@ -5,7 +5,8 @@ filename: learngroovy-pt.groovy  contributors:      - ["Roberto Pérez Alcolea", "http://github.com/rpalcolea"]  translators: -    - ["João Farias", "https://github.com/JoaoGFarias"] +    - ["João Farias", "https://github.com/joaogfarias"] +    - ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]  lang: pt-br  --- @@ -201,8 +202,16 @@ if(x==1) {  //Groovy também suporta o operador ternário  def y = 10 -def x = (y > 1) ? "functionou" : "falhou" -assert x == "functionou" +def x = (y > 1) ? "funcionou" : "falhou" +assert x == "funcionou" + +//E suporta o 'The Elvis Operator' também! +//Em vez de usar o operador ternário: + +displayName = nome.name ? nome.name : 'Anonimo' + +//Podemos escrever: +displayName = nome.name ?: 'Anonimo'  //Loop 'for'  //Itera sobre um intervalo (range) diff --git a/pt-br/latex-pt.html.markdown b/pt-br/latex-pt.html.markdown index 58586522..919c0f4f 100644 --- a/pt-br/latex-pt.html.markdown +++ b/pt-br/latex-pt.html.markdown @@ -8,6 +8,7 @@ contributors:      - ["Svetlana Golubeva", "https://attillax.github.io/"]  translators:      - ["Paulo Henrique Rodrigues Pinheiro", "https://github.com/paulohrpinheiro"] +    - ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]  lang: pt-br  filename: learn-latex-pt.tex  --- @@ -16,10 +17,10 @@ filename: learn-latex-pt.tex  % Todas as linhas de comentários começam com %  % Não existem comentários multilinhas -$ LaTeX não é um programa processador de textos "Visual" como +% LaTeX não é um programa processador de textos "Visual" como  % MS Word ou OpenOffice Writer -$ Todo comando LaTeX começa com uma barra invertida (\) +% Todo comando LaTeX começa com uma barra invertida (\)  % Documentos LaTeX começam com a definição do tipo que será % compilado  % Os tipos de documento podem ser livro, relatório, apresentação, etc. @@ -37,14 +38,11 @@ $ Todo comando LaTeX começa com uma barra invertida (\)  \usepackage{float}  \usepackage{hyperref} -% Para poder usar caracteres acentuados, use o seguinte pacote: -\usepackage[utf8]{inputenc} -  % Podemos definir algumas outras propriedades do documento também!  \author{Chaitanya Krishna Ande, Colton Kohnke, Sricharan Chiruvolu \& \\  Svetlana Golubeva}  \date{\today} -\title{Aprenda \LaTeX \hspace{1pt} em Y Minutos!} +\title{Aprenda \LaTeX{} em Y Minutos!}  % Agora estamos prontos para começar o documento  % Tudo antes dessa linha é chamado "preâmbulo". @@ -52,6 +50,7 @@ Svetlana Golubeva}  % Se informarmos os campos author (autores), date (data), "title" (título),  % LaTeX poderá cria uma página inicial para nós.  \maketitle +  % Se tivermos seções, poderemos criar uma tabela de conteúdo. Para isso,  % o documento deve ser compilado duas vezes, para que tudo apareça na ordem  % correta. @@ -69,7 +68,7 @@ Svetlana Golubeva}  % Esse comando está disponível para os documentos do tipo artigo (article)  % e relatório (report).  \begin{abstract} - Documentação do \LaTeX \hspace{1pt} escrita em \LaTeX! Nada original! + Documentação do \LaTeX{} escrita em \LaTeX! Nada original!  \end{abstract}  % Comandos para seções são intuitivos.  @@ -93,11 +92,17 @@ Muito melhor agora.  Afinal nem todas as seções precisam ser numeradas!  \section{Algumas notas sobre texto} -%\section{Espaçamento % É necessário mais informação sobre intervalos de espaço. -\LaTeX \hspace{1pt} geralmente é muito bom sobre colocar texto onde ele deve +%\section{Espaçamento} % É necessário mais informação sobre intervalos de espaço. +\LaTeX{} geralmente é muito bom sobre colocar texto onde ele deve  ser posto. Se   uma linha \\ deve \\ ser \\ quebrada \\ adicione \textbackslash\textbackslash -\hspace{1pt} ao código de seu documento. \\  +\hspace{1pt} ao código de seu documento.  + +Separe parágrafos por linhas vazias. + +Você precisa adicionar um til após abreviações (se não forem seguidas de vírgula) +para um espaço sem quebra, senão o espaçamento após o ponto será muito largo: +E.g., i.e., etc.~são exemplos de abreviações.  \section{Listas}  Listas são uma das coisas mais fáceis de criar no \LaTeX! Preciso fazer compras @@ -112,21 +117,21 @@ amanhã, então façamos uma lista de compras.    Não é um item da lista, mas faz parte do bloco enumerate. -  \end{enumerate} % Todos os blocos devem ter um final (end{}). +\end{enumerate} % Todos os blocos devem ter um final (end{}).  \section{Matemática} -Um dos usos iniciais para \LaTeX \hspace{1pt} foi a produção de artigos +Um dos usos iniciais para \LaTeX{} foi a produção de artigos  acadêmicos e técnicos. Usualmente nos campos da matemática e ciência. Assim, é -necessários que consigamos incluir alguns símbolos especiais em nosso texto! \\ +necessários que consigamos incluir alguns símbolos especiais em nosso texto!  A matemática tem muitos símbolos, além dos quais se pode encontrar no teclado;  símbolos para relações e conjuntos, setas, operadores, e letras gregas, apenas -para mencionar alguns.\\ +para mencionar alguns.  Conjuntos e relações são essenciais em muitos textos de pesquisa em matemática.  Aqui está como você pode indicar como todo x que pertence -a X, $\forall$ x $\in$ X. \\ +a X, $\forall$ x $\in$ X.  % Perceba que é necessário adicionar os sinais $ antes e depois dos símbolos.  % Isso é porque quando escrevendo, estamos em modo texto.  % Mas os símbolos de matemática só existem no modo matemática. @@ -138,15 +143,14 @@ a X, $\forall$ x $\in$ X. \\  \[a^2 + b^2 = c^2 \]  Minha letra grega favorita é $\xi$. Eu também gosto da $\beta$, $\gamma$ e $\sigma$. -Eu ainda não encontrei uma letra grega que o \LaTeX \hspace{1pt} não tenha!\\ +Eu ainda não encontrei uma letra grega que o \LaTeX{} não tenha!\\  Operadores são parte essencial de um documento sobre matemática:  funções trigonométricas ($\sin$, $\cos$, $\tan$),  logaritmo e exponencial ($\log$, $\exp$),  -limites ($\lim$), etc.  -possuem comandos pré-definidos em LaTex.  +limites ($\lim$), etc.~possuem comandos pré-definidos em LaTex.   Vamos escrever uma equação para ver como se faz: -$\cos(2\theta) = \cos^{2}(\theta) - \sin^{2}(\theta)$ \\ +$\cos(2\theta) = \cos^{2}(\theta) - \sin^{2}(\theta)$  Frações (numerador/denominador) podem ser escritas dessa forma: @@ -183,8 +187,10 @@ Somatórios e Integrais são escritas com os comandos sum e int:  \section{Figuras} -Insiramos uma Figura. O local para colocar a figura pode ser difícil -de determinar. Eu tenho sempre que verificar as opções toda vez. +Insiramos uma Figura. O local para colocar a figura pode ser difícil de determinar. +Operações básicas são [t] para o topo, [b] para base, [h] para aqui (aproximadamente). +Eu tenho sempre que verificar as opções toda vez. +% Veja https://en.wikibooks.org/wiki/LaTeX/Floats,_Figures_and_Captions para mais detalhes  \begin{figure}[H] % H aqui é uma opção para o local da figura.       \centering % centra a figura na página @@ -201,36 +207,45 @@ Também podemos incluir tabelas da mesma forma que figuras.  \begin{table}[H]    \caption{Título para a Tabela.}    % os argumentos {} abaixo descrevem como cada linha da tabela é desenhada. -  % Aqui também, Preciso ver isso. Toda. E. Cada. Vez. +  % O básico é simples: uma letra para cada coluna, para controlar o alinhamento: +  % Operações básicas são: c, l, r e p para centro, esquerda, direita e parágrafo +  % opcionalmente, você pode adicionar um | para linha vertical +  % Veja https://en.wikibooks.org/wiki/LaTeX/Tables para mais detalhes    \begin{tabular}{c|cc}  -    Número &  Sobrenome & Primeiro Nome \\ % Colunas são separadas por & +    Número &  Primeiro Nome & Sobrenome \\ % Colunas são separadas por &      \hline % uma linha horizontal      1 & Biggus & Dickus \\      2 & Monty & Python    \end{tabular} +  % Vai ficar mais ou menos assim: +  % Número | Primeiro Nome  Sobrenome +  % -------|---------------------------  % por causa do \hline +  %   1    |   Biggus        Dickus +  %   2    |   Monty         Python  \end{table} -\section{Fazendo o \LaTeX \hspace{1pt} não compilar algo (o código fonte)} +\section{Fazendo o \LaTeX{} não compilar algo (o código fonte)}  Digamos que precisamos incluir algum código dentro do nosso -documento \LaTeX \hspace{1pt}, para isso precisamos com o \LaTeX \hspace{1pt} +documento \LaTeX{}, para isso precisamos com o \LaTeX{}  não tente interpretar esse texto e que apenas inclua ele no documento. Fazemos  isso com o bloco verbatim.  % Existem outros pacotes (por exemplo, minty, lstlisting, etc.)  % mas verbatim é o básico  \begin{verbatim}  -  print("Hello World!") +  print("Olá mundo!")    a%b; % olha só! Podemos usar os sinais % no bloco verbatim.  -  random = 4; #decided by fair random dice roll +  random = 4; #decidido por um lançamento honesto de dado +  Veja https://www.explainxkcd.com/wiki/index.php/221:_Random_Number  \end{verbatim}  \section{Compilando}   Imagino que agora você esteja pensando como compilar esse fantástico documento -e visualizar a gloriosa glória que é um pdf gerado por \LaTeX \hspace{1pt} pdf. +e visualizar a gloriosa glória que é um pdf gerado por \LaTeX{} pdf.  (sim, esse documento é compilável). \\ -Finalizando o documento usando \LaTeX \hspace{1pt} consiste nos seguintes passos: +Finalizando o documento usando \LaTeX{} consiste nos seguintes passos:    \begin{enumerate}      \item Escrever o documento em texto puro (o ``código fonte'').      \item Compilar o código fonte para gerar um pdf.  @@ -240,7 +255,7 @@ Finalizando o documento usando \LaTeX \hspace{1pt} consiste nos seguintes passos       \end{verbatim}    \end{enumerate} -Existem editores de \LaTeX \hspace{1pt} que combinam os passos 1 e 2 no mesmo +Existem editores de \LaTeX{} que combinam os passos 1 e 2 no mesmo  sistema de software. Assim, você pode ver o passo 1, mas não o passo 2 por  completo. Passo 2 estará acontecendo escondido\footnote{Por exemplo, quando usar  referências (como Equação~\ref{eq:pythagoras}), pode ser necessário executar o @@ -267,6 +282,27 @@ Existem dois tipos principais de links: URL visíveis \\  Esse pacote também produz uma lista de thumbnails no documento pdf gerado e  ativa os links na tabela de conteúdo. +\section{Escrevendo em ASCII ou outras codificações} + +Por padrão, historicamente LaTeX aceita entradas que são puro ASCII (128), +mas não ASCII extendido, o que significa sem acentos (à, è etc.) e símbolos não latinos. + +É fácil inserir acentos e símbolos latinos básicos através de atalhos de barra invertida +como \,c, \'e, \`A, \ae e \oe etc.  % Para ç, é, À, etc +% Veja https://en.wikibooks.org/wiki/LaTeX/Special_Characters#Escaped_codes para mais detalhes + +Para escrever diretamente em UTF-8 quando compilando com pdflatex, use +\begin{verbatim} +    \usepackage[utf8]{inputenc} +\end{verbatim} +A fonte selecionada precisa suportar os glifos usados em seu documento. Você precisa adicionar +\begin{verbatim} +    \usepackage[T1]{fontenc} +\end{verbatim} + +Desde LuaTeX e XeLaTeX, suporte para UTF-8 vem embutido por padrão, tornando a vida muito +mais fácil para escrever em alfabetos não latinos. +  \section{End}  Por enquanto é isso! @@ -276,7 +312,7 @@ Por enquanto é isso!  \begin{thebibliography}{1}    % como em outras listas, o comando \bibitem pode ser usado para itens da lista    % cada entrada pode ser citada diretamente no corpo do texto -  \bibitem{latexwiki} The amazing \LaTeX \hspace{1pt} wikibook: {\em  +  \bibitem{latexwiki} The amazing \LaTeX{} wikibook: {\em   https://en.wikibooks.org/wiki/LaTeX}    \bibitem{latextutorial} An actual tutorial: {\em http://www.latex-tutorial.com}  \end{thebibliography} @@ -289,3 +325,6 @@ https://en.wikibooks.org/wiki/LaTeX}  * The amazing LaTeX wikibook: [https://en.wikibooks.org/wiki/LaTeX](https://en.wikibooks.org/wiki/LaTeX)  * An actual tutorial: [http://www.latex-tutorial.com/](http://www.latex-tutorial.com/) +* A quick guide for learning LaTeX: [Learn LaTeX in 30 minutes](https://www.overleaf.com/learn/latex/Learn_LaTeX_in_30_minutes) +* An interactive platform to learn LaTeX (installationfree) [learnlatex.org/](https://www.learnlatex.org/) +* Stack Exchange's question and answer site about TeX, LaTeX, ConTeXt, etc. [tex.stackexchange.com](https://tex.stackexchange.com/) diff --git a/pt-br/lua-pt.html.markdown b/pt-br/lua-pt.html.markdown index 0c75da26..4aaf3a1e 100644 --- a/pt-br/lua-pt.html.markdown +++ b/pt-br/lua-pt.html.markdown @@ -2,7 +2,7 @@  language: Lua  contributors:      - ["Tyler Neylon", "http://tylerneylon.com/"] -filename: learnlua.lua +filename: learnlua-pt.lua  translators:      - ["Iaan Mesquita", "https://github.com/ianitow"]  lang: pt-br diff --git a/pt-br/make-pt.html.markdown b/pt-br/make-pt.html.markdown index cbdebde7..40ac733a 100644 --- a/pt-br/make-pt.html.markdown +++ b/pt-br/make-pt.html.markdown @@ -4,7 +4,9 @@ tool: make  contributors:
      - ["Robert Steed", "https://github.com/robochat"]
      - ["Stephan Fuhrmann", "https://github.com/sfuhrm"]
 -filename: Makefile
 +translators:
 +    - ["Rogério Gomes Rio", "https://github.com/rogerlista"]
 +filename: Makefile-pt
  lang: pt-br
  ---
 diff --git a/pt-br/markdown-pt.html.markdown b/pt-br/markdown-pt.html.markdown index dc50cac1..7960a59a 100644 --- a/pt-br/markdown-pt.html.markdown +++ b/pt-br/markdown-pt.html.markdown @@ -6,36 +6,56 @@ translators:      - ["Miguel Araújo", "https://github.com/miguelarauj1o"]      - ["Gabriele Luz", "https://github.com/gabrieleluz"]      - ["Monique Baptista", "https://github.com/bfmonique"] +    - ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]  lang: pt-br      filename: learnmarkdown-pt.md  --- -Markdown foi criado por John Gruber in 2004. Originado para ser fácil de ler e  -escrever sintaxe que converte facilmente em HTML (hoje, suporta outros formatos também). - -Dê-me feedback tanto quanto você quiser! / Sinta-se livre para fazer uma bifurcação (fork) e  -puxar o projeto (pull request) +O Markdown foi lançado por John Gruber em 2004. Criado para ser uma sintaxe +fácil de ler e escrever e que é facilmente convertida em HTML (hoje, suporta +outros formatos também). + +O Markdown varia em termos de implementação de um parser para outro. Esse guia +irá tentar deixar explícito quando os recursos são universais ou quando são +específicos para um parser em específico. + +- [Elementos HTML](#elementos-html) +- [Cabeçalhos](#cabeçalhos) +- [Estilos de texto simples](#estilos-de-texto-simples) +- [Parágrafos](#parágrafos) +- [Listas](#listas) +- [Blocos de código](#blocos-de-código) +- [Linha Horizontal](#linha-horizontal) +- [Links](#links) +  - [Tabela de conteúdo](#tabela-de-conteúdo) +- [Imagens](#imagens) +- [Miscelânea](#miscelânea) +  - [Auto-links](#auto-links) +  - [Auto-links para e-mails](#auto-links-com-e-mails) +  - [Escapando caracteres](#escapando-caracteres) +  - [Teclas do teclado](#teclas-do-teclado) +  - [Tabelas](#tabelas) +- [Markdownlint](#markdownlint) +- [Leitura complementar](#leitura-complementar)  ## Elementos HTML -Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é  +O Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é   um arquivo Markdown válido. -```md -<!-- Markdown é um superconjunto do HTML, de modo que qualquer arquivo HTML é  -um arquivo Markdown válido. Isso significa que nós podemos usar elementos HTML  -em Markdown, como o elemento de comentário, e eles não serão afetados pelo analisador -de remarcação. No entanto, se você criar um elemento HTML em seu arquivo Markdown, você -não pode usar sintaxe de remarcação dentro desse conteúdo do elemento.--> - -<!--A maneira como o Markdown é analisado varia de software para software. -Este guia vai tentar esclarecer quando as características são universais, ou quando eles são específicos para um determinado interpretador --> +```md +<!--Isso significa que nós podemos usar elementos HTML em Markdown, como o +elemento de comentário, e eles não serão afetados pelo analisador de +remarcação. No entanto, se você criar um elemento HTML em seu arquivo Markdown, +você não pode usar sintaxe de remarcação dentro do conteúdo desse elemento.--> +```  ## Cabeçalhos  Você pode criar elementos HTML `<h1>` até `<h6>` facilmente antecedendo o texto -que deseja estar nesse elemento por um número de hashes (#) +que deseja estar nesse elemento por um número de cerquilhas (#). +```md  # Isto é um cabeçalho <h1>  ## Isto é um cabeçalho <h2>  ### Isto é um cabeçalho <h3> @@ -44,7 +64,7 @@ que deseja estar nesse elemento por um número de hashes (#)  ###### Isto é um cabeçalho <h6>  ``` -Markdown também nos fornece duas maneiras alternativas de indicar h1 e h2 +Markdown também nos fornece duas maneiras alternativas de indicar h1 e h2.  ```md  Isto é um cabeçalho h1 @@ -55,21 +75,22 @@ Isto é um cabeçalho h2  ```  ## Estilos de texto simples -O texto pode ser facilmente denominado como marcação itálico, negrito ou tachado usando: + +O texto pode ser facilmente estilizado como itálico ou negrito usando Markdown.  ```md  *Este texto está em itálico*  _E este também está._  **Este texto está em negrito** -__E este também está._ +__E este também está.__  ***Este texto está em negrito e itálico.***  **_E este também está_** -*--Danouse! Este também__* +*__Danou-se! Este também__*  ``` -Em GitHub Flavored Markdown, que é usado para processar arquivos Markdown  +No GitHub Flavored Markdown, que é usado para processar arquivos Markdown  GitHub, nós também temos:  ```md @@ -77,43 +98,46 @@ GitHub, nós também temos:  ```  ## Parágrafos -Os parágrafos estão uma ou várias linhas adjacentes de texto separadas por  +Os parágrafos estão em uma ou várias linhas adjacentes de texto separadas por   uma ou múltiplas linhas em branco.  ```md  Este é um parágrafo. Eu estou digitando em um parágrafo, não é legal?  Agora, eu estou no parágrafo 2. -... Ainda continuo no parágrafo 2! :) +Ainda continuo no parágrafo 2! -Eu estou no parágrafo três. + +Eu estou no parágrafo três!  ```  Se você quiser inserir uma tag HTML `<br />`, você pode acabar com um parágrafo  -com dois ou mais espaços e, em seguida, começar um novo parágrafo +com dois ou mais espaços e, em seguida, começar um novo parágrafo.  ```md -Termino com dois espaços (destacar-me para vê-los).  +Termino com dois espaços (selecione essa linha para vê-los).   Há um <br /> acima de mim!  ``` - -Bloco de citações são fáceis e feito com o caractere >. +Blocos de citações são fáceis e feitos com o caractere >.  ```md  > Este é um bloco de citação. Você pode  -> Quebrar manualmente suas linhas e colocar um `>` antes de cada linha ou você pode -> deixar suas linhas ficarem muito longas e quebrarem por conta própria. Não faz diferença,  -> desde que eles começam com um `>`. -	 +> Quebrar manualmente suas linhas e colocar um `>` antes de cada linha ou você +> pode deixar suas linhas ficarem muito longas e quebrarem por conta própria. +> Não faz diferença, desde que elas comecem com um `>`.  > Você também pode usar mais de um nível   >> De recuo? +> O quão legal é isso? +  ```  ## Listas -As listas não ordenadas podem ser feitas usando asteriscos, positivos ou hífens + +As listas não ordenadas podem ser feitas usando asteriscos, sinais de positivo +ou hífens.  ```md  * Item @@ -141,18 +165,18 @@ Listas ordenadas são feitas com um número seguido por um ponto.  3. Item três  ``` -<!-- Você não tem poder para rotular os itens corretamente e a remarcação ainda deixará os  -itens em ordem, mas isso pode não ser uma boa idéia --> - +Você não precisa sequer rotular os itens corretamente e o Markdown ainda +assim deixará os itens em ordem, mas isso pode não ser uma boa idéia.  ```md  1. Item um  1. Item dois  1. Item três  ``` +  (Isto é processado da mesma forma que o exemplo acima) -Você também pode usar sublistas +Você também pode usar sublistas.  ```md  1. Item um @@ -163,63 +187,59 @@ Você também pode usar sublistas  4. Item quatro  ``` -Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) de HTML +Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) do  +HTML.  ```md -As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas -- [ ] Primeira tarefa a completar +As caixas abaixo sem o 'x' são checkboxes HTML desmarcadas. +- [ ] Primeira tarefa a completar.  - [ ] Segunda tarefa a completar -A caixa de seleção abaixo será exibida como uma checkbox HTML marcada +A caixa de seleção abaixo será exibida como uma checkbox HTML marcada.  - [x] Essa tarefa foi completa -  ``` -  ## Blocos de código -Você pode indicar um bloco de código (que utiliza o elemento `<code>`) pelo recuo -uma linha com quatro espaços ou uma guia + +Você pode indicar um bloco de código (que utiliza o elemento `<code>`) através +de indentação com quatro espaços ou uma tabulação. +  ```md -	Isto é código -	É assim, sacou? -	 +    Isto é código +    É assim, sacou?  ``` -Você pode também re-guia (ou adicionar mais quatro espaços adicionais) para o recuo  -dentro do seu código +Você pode também adicionar mais tabulações (ou adicionar mais quatro espaços +adicionais) para indentação no seu código.  ```md -	my_array.each do |item| +    my_array.each do |item|          puts item      end	 - ``` +``` -Código embutido pode ser criada usando o caractere de crase `` ` `` +Código embutido pode ser criado usando o caractere de crase `` ` ``.  ```md -John não sabia nem o que o função `goto()` fazia! +John não sabia nem o que a função `go_to()` fazia!  ``` -Em GitHub Flavored Markdown, você pode usar uma sintaxe especial para o código -```md -	``` ruby -	def foobar -    	puts "Hello world!" -	end -	``` -``` -======= -\`\`\`ruby <!-- exceto remover essas barras invertidas quando você faz isso, apenas ``` -ruby! -->  +No GitHub Flavored Markdown, você pode usar uma sintaxe especial para código. + +<pre> +<code class="highlight">```ruby  def foobar -    puts "Hello world!" +    puts "Olá mundo!"  end -\`\`\` <!-- Aqui também, não use barras invertidas, apenas ``` --> +```</code></pre> + -O texto acima não requer recuo, além disso o GitHub vai usar a sintaxe highlight da linguagem que você especificar após a \`\`\`. +O texto acima não requer indentação, além disso o GitHub vai usar o destaque +de sintaxe da linguagem qeu você especificar após a tag <code>```</code>.  ## Linha Horizontal -Linhas horizontais são facilmente adicionados com três ou mais asteriscos ou hífens, -com ou sem espaços. + +Linhas horizontais são facilmente adicionadas com três ou mais asteriscos ou +hífens, com ou sem espaços.  ```md  *** @@ -229,17 +249,19 @@ com ou sem espaços.  ```  ## Links -Uma das melhores coisas sobre a marcação é o quão fácil é fazer ligações. Colocar  -o texto a ser exibido entre parênteses rígidos [] seguido pela url em parênteses () + +Uma das melhores coisas sobre o Mardkwon é o quão fácil é criar links. +Coloque o texto a ser exibido entre colchetes [] seguido pela url entre +parênteses ()  ```md -[Click aqui!](http://test.com/) +[Clique aqui!](http://test.com/)  ``` -Você também pode adicionar um título link usando aspas dentro dos parênteses +Você também pode adicionar um título ao link usando aspas dentro dos parênteses.  ```md -[Click aqui!](http://test.com/ "Link para Test.com") +[Cliqueaqui!](http://test.com/ "Link para Test.com")  ```  Caminhos relativos funcionam também. @@ -248,46 +270,64 @@ Caminhos relativos funcionam também.  [Ir para música](/música/).  ``` -Markdown também suporta ligações de estilo de referência +O Markdown também suporta links para referências no texto. -```md -[Clique neste link] [link1] para mais informações sobre isso! -[Além disso, verifique este link] [foobar] se você quiser. +<pre><code class="highlight">[<span class="nv">Clique nesse link</span>][<span class="ss">link1</span>] para mais informações! +[<span class="nv">Também cheque esse link</span>][<span class="ss">foobar</span>] se você quiser. -[link1]: http://test.com/ "Legal!" -[foobar]: http://foobar.biz/ "OK!" -``` +[<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Legal!"</span> +[<span class="nv">link2r</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Certo!"</span></code></pre>  O título também pode estar entre aspas simples ou entre parênteses, ou omitido  -inteiramente. As referências podem estar em qualquer lugar no documento e os IDs de referência  -pode ser qualquer um, desde que eles são únicos. +inteiramente. As referências podem estar em qualquer lugar no documento e os +IDs de referência podem ser qualquer um, desde que eles sejam únicos. -Existe também a "nomeação implicita", que permite que você use o texto do link como o id +Existe também a "nomeação implícita", que permite que você use o texto do link +como o id: -```md -[Este] [] é um link.  +<pre><code class="highlight">[<span class="nv">Isso</span>][] é um link. + +[<span class="nv">Isso</span>]: <span class="sx">http://thisisalink.com/</span></code></pre> + + +Mas geralmente não são usados. + +### Tabela de conteúdo + +Alguns sabores de Markdown fazem inclusive uso de combinação de listas, links e +cabeçalhos de modo a criar uma tabela de conteúdo. Nesse caso, títulos em +cabeçalhos são precedidos de (`#`) e são usados como ids para links. Se o +cabeçalho consistir de várias palavras, elas serão conectadas por hífens (`-`), +que também substitui alguns caracteres especiais. (Embora alguns outros +carácteres especiais sejam omitidos.) -[este]: http://thisisalink.com/  +```md +- [Cabeçalho](#cabecalho) +- [Um outro cabeçalho](#outro-cabecalho) +- [Capítulo](#capitulo) +  - [Subcapítulo <h3 />](#subcapitulo-h3-)  ``` -Mas não são usados normalmente +De qualquer modo, esse é um recurso que talvez não funcione em todas as +implementações do Markdown da mesma forma.  ## Imagens -As imagens são feitas da mesma forma que as ligações, mas com um ponto de exclamação na frente! + +As imagens são feitas da mesma forma que os links, mas com um ponto de +exclamação na frente!  ```md -  +   ```  E estilo de referência funciona como esperado -```md -![Este é o pairar-texto.][Myimage]  +<pre><code class="highlight">![<span class="nv">Esse é o alt-attribute.</span>][<span class="ss">myimage</span>] -[myimage]: relative/urls/legal/image.jpg "se você precisa de um título, é aqui"  -``` +[<span class="nv">Minha imagem</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"se precisar de um título, está aqui"</span></code></pre>  ## Miscelânea  +  ### Auto-links   ```md @@ -303,14 +343,25 @@ E estilo de referência funciona como esperado  ### Escapando caracteres -Quero digitar * Este texto entre asteriscos *, mas eu não quero que ele seja  +Quero digitar *Este texto entre asteriscos*, mas eu não quero que ele seja   em itálico, então eu faço o seguinte: \*Este texto entre asteriscos \*. +### Teclas do teclado + +No GitHub Flavored Markdown, você pode usar a tag `<kbd>` para representar uma +tecla do teclado. + +```md +Seu computador travou? Tente apertar +<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> +``` +  ### Tabelas  +  Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente   complicadas, mas se você realmente quer: -```md +```md  | Col1         | Col2     | Col3          |  | :----------- | :------: | ------------: |  | esquerda-alin| Centrado | direita-alinh | @@ -325,8 +376,22 @@ Col 1 | Col2 | Col3  Ugh isso é tão feio | faça isto | parar  ``` -Fim! +## Markdownlint + +De modo a simplificar o trabalho com Markdown e padronizar estilo de código, o +`Markdownlint` foi criado. Essa ferramenta está disponível como plugin para +algumas interfaces de desenvolvimento (IDEs) e pode ser utilizada como um +utilitário para garantir validade e legibilidade do Markdown.  --- -Para mais informações, confira o post oficial de John Gruber de sintaxe [aqui](http://daringfireball.net/projects/markdown/syntax) -e de Adam Pritchard grande cheatsheet [aqui](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet). + +## Leitura complementar + +Para mais informações, confira o post oficial de John Gruber sobre sintaxe [aqui](http://daringfireball.net/projects/markdown/syntax) +e o do cheatsheet do Adam Pritchard [aqui](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet). + +Se você quiser aprender mais sobre recursos de alguns sabores específicos de +Markdown, veja: + +- [GitHub flavored Markdown](https://docs.github.com/en/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) +- [GitLab flavored Markdown](https://docs.gitlab.com/ee/user/markdown.html) diff --git a/pt-br/matlab-pt.html.markdown b/pt-br/matlab-pt.html.markdown index fae17bca..947e0699 100644 --- a/pt-br/matlab-pt.html.markdown +++ b/pt-br/matlab-pt.html.markdown @@ -1,5 +1,5 @@  --- -language: Matlab +language: MATLAB  contributors:      - ["mendozao", "http://github.com/mendozao"]      - ["jamesscottbrown", "http://jamesscottbrown.com"] @@ -120,7 +120,7 @@ A.d.e = false;  % Vetores  x = [4 32 53 7 1] -x(2) % Resposta = 32, índices no Matlab começam por 1, não 0 +x(2) % Resposta = 32, índices no MATLAB começam por 1, não 0  x(2:3) % Resposta = 32 53  x(2:end) % Resposta = 32 53 7 1 @@ -479,7 +479,7 @@ perms(x) % Lista todas as permutações de elementos de x  % Classes -% Matlab pode suportar programação orientada a objetos. +% MATLAB pode suportar programação orientada a objetos.  % Classes devem ser colocadas em um arquivo de mesmo nome com a extensão *.m  % Para começar, criamos uma simples classe que armazena posições de GPS  % Início ClassePosicoesGPS.m @@ -501,7 +501,7 @@ classdef ClassePosicoesGPS % O nome da classe.      end      % Se quisermos somar dois objetos de PosicoesGPS juntos sem chamar -    % uma função especial nós podemos sobrepor a aritmética do Matlab, desta maneira: +    % uma função especial nós podemos sobrepor a aritmética do MATLAB, desta maneira:      function r = plus(o1,o2)        r = ClassePosicoesGPS([o1.latitude] +[o2.latitude], ...                          [o1.longitude]+[o2.longitude]); @@ -513,7 +513,7 @@ end  % Podemos criar um objeto da classe usando o construtor  a = ClassePosicoesGPS(45.0, 45.0) -% Propriedades da classe se comportam exatamente como estruturas Matlab +% Propriedades da classe se comportam exatamente como estruturas MATLAB  a.latitude = 70.0  a.longitude = 25.0 @@ -524,15 +524,15 @@ ans = multiplicarLatPor(a,3)  % o objeto não precisa ser passado para o método.  ans = a.multiplicarLatPor(a,1/3) -% Funções do Matlab podem ser sobrepostas para lidar com objetos. -% No método abaixo, nós sobrepomos a forma como o Matlab lida com a soma de +% Funções do MATLAB podem ser sobrepostas para lidar com objetos. +% No método abaixo, nós sobrepomos a forma como o MATLAB lida com a soma de  % dois objetos PosicoesGPS.  b = ClassePosicoesGPS(15.0, 32.0)  c = a + b  ``` -## Mais sobre Matlab +## Mais sobre MATLAB  * O site oficial [http://http://www.mathworks.com/products/matlab/](http://www.mathworks.com/products/matlab/)  * O fórum oficial de respostas: [http://www.mathworks.com/matlabcentral/answers/](http://www.mathworks.com/matlabcentral/answers/) diff --git a/pt-br/php-pt.html.markdown b/pt-br/php-pt.html.markdown index e55f1100..7db6a671 100644 --- a/pt-br/php-pt.html.markdown +++ b/pt-br/php-pt.html.markdown @@ -7,7 +7,7 @@ translators:      - ["Abdala Cerqueira", "http://abda.la"]      - ["Raquel Diniz", "http://twitter.com/raquelrdiniz"]  lang: pt-br -filename: php-pt.html.markdown +filename: learnphp-pt.php  ---  Este documento descreve PHP 5+. diff --git a/pt-br/processing-pt.html.markdown b/pt-br/processing-pt.html.markdown new file mode 100644 index 00000000..5ed2950a --- /dev/null +++ b/pt-br/processing-pt.html.markdown @@ -0,0 +1,480 @@ +--- +language: processing +filename: learnprocessing.pde +contributors: +    - ["Phone Thant Ko", "http://github.com/phonethantko"] +    - ["Divay Prakash", "https://github.com/divayprakash"] +translators: +    - ["Kemel Zaidan", "https://github.com/kemelzaidan"] +lang: pt-br +--- + +## Introdução + +Processing é uma linguagem de programação para criação de artes digitais e +conteúdo multimídia, permitindo que não programadores aprendam os fundamentos  +da programação computacional em um contexto visual. + +Embora a linguagem seja baseada na linguagem Java, sua sintaxe foi amplamente +influenciado por ambas as sintaxes Java e Javascript. +[Veja mais aqui](https://processing.org/reference/) + +A linguagem é tipada estaticamente e também vem com o seu Ambiente de Desenvolvimento +Integrado (do inglês Integrated Development Environment - IDE) oficial para +compilar e executar os scripts. + +``` +/* --------- +   Comentários +   --------- +*/ + +// Comentário de linha única começa com // + +/* +   Como o Processing é baseado em Java, +   a sintaxe para seus comentários é a mesma do Java (como você deve ter notado  +   acima)! +   Comentários de várias linhas são agrupados como visto aqui. +*/ + +/* --------------------------------------- +   Escrevendo e executando programas em Processing +   --------------------------------------- +*/ + +// No Processing, o ponto de entrada do programa é uma função chamada setup()  +// com um tipo de retorno void. +// Observação! A sintaxe é muito semelhante à do C++. +void setup() { +  // Isso imprime a saída clássica "Hello World!" no console quando executado. +  println("Olá Mundo!"); // Mais uma linguagem com esse maldito ponto e vírgula, não é? +} + +// Normalmente, colocamos todos os códigos estáticos dentro do método setup()  +// como o próprio nome sugere, uma vez que é executado apenas uma vez. +// Pode variar da definição das cores de fundo, ou o tamanho da tela. +background(color); //define a cor do fundo +size(largura,altura,[renderizador]); // define o tamanho da tela com parâmetro +// opcional para definir o renderizador +// Você verá mais sobre isso ao longo deste documento. + +// Se você deseja executar os códigos indefinidamente, eles devem ser colocados  +// dentro do método draw() +// draw() deve existir caso você queira que o código seja executado  +// continuamente e, obviamente, só pode haver um método draw(). +int = 0; +void draw(){ +  // Este bloco de código faz um loop para sempre até parar +  imprima(i); +  i++; // Operador de incremento! +} + +// Agora que sabemos como escrever o script de trabalho e como executá-lo, +// continuaremos a explorar quais tipos de dados e coleções são suportados no +// Processing. + +/* ------------------------ +   Tipos de dados e coleções +   ------------------------ +*/ + +// De acordo com as Referências do Processing, ele suporta 8 tipos primitivos +// de dados da seguinte forma. + +boolean valorBoleano = true; // Boleano +byte valorByteDeA = 23; // Byte +char valorCharDeA = 'A'; // Caractere +color valorDeCorBrancoM = color(255, 255, 255); // Cor (especificada usando +// método color()) +color valorDeCorBrancoH = #FFFFFF; // Cor (especificada usando valor de hash) +int valor = 5; // Inteiro (Número sem decimais) +long valorLongo = 2147483648L; // "L" é adicionado ao número para marcá-lo como um longo +float valorFloat = 1,12345; // Float (números de ponto flutuante de 32 bits) +double valorDouble = 1,12345D; // Double (números de ponto flutuante de 64 bits) + +// NOTA! +// Embora os tipos de dados "long" e "double" funcionem na linguagem, +// funções do Processing não usam esses tipos de dados, portanto +// eles precisam ser convertidos em tipos de dados "int" e "float",  +// respectivamente, usando a sintaxe (int) e (float) antes de passar para uma  +// função. + +// Existem vários tipos de dados compostos que estão disponíveis por padrão para  +// uso no Processing. +// Primeiramente, farei um resumo dos mais usados para economizar tempo. + +// String +// Enquanto o tipo de dados char usa '', o tipo de dados String usa "" - aspas  +// duplas. +string stringExemplo = "Olá, Processing!"; +// String também pode ser criada a partir de um array de tipos de dados char. +// Nós vamos discutir array muito em breve. +char fonte = {'H', 'E', 'L', 'L', 'O'}; +String stringDeFonte = new String(source); // HELLO +// Como em Java, strings podem ser concatenadas usando o operador "+". +print("Olá " + "Mundo!"); // Olá Mundo! + +// Array +// Arrays em Processing podem conter quaisquer tipos de dados, incluindo os  +// próprios objetos. Como os arrays são semelhantes aos objetos, eles devem  +// ser criados com a palavra-chave "new". +int[] arrayInt = new int[5]; +int[] arrayIntComValores = {1, 2, 3}; // Você também pode preencher com dados. + +// Lista de Arrays +// As funções são semelhantes às do array; arraylists podem conter qualquer  +// tipo de dados. A única diferença é que as listas de matrizes são  +// redimensionadas dinamicamente, pois é uma forma de implementação de matriz  +// redimensionável da interface "List" do Java . +ArrayList<Integer> intArrayList = new ArrayList<Integer>(); + +// Objeto +// Como é baseado em Java, o Processing suporta programação orientada a objetos. +// Isso significa que você pode basicamente definir quaisquer tipos de dados de  +// sua preferência e manipulá-los para suas necessidades. +// Claro, uma classe tem que ser definida antes para o objeto que você quer. +// Formato --> NomeClasse NameInstancia +UmaClasseQualquer meuObjeto // então instancia mais tarde +//ou +UmaClasseQualquer meuObjetoInstanciado = new UmaClasseQualquer(); + +// O Processing surge com mais coleções (ex. - Dicionários e Listas) por +// padrão, por uma questão de simplicidade, vou deixá-los fora da discussão aqui. + +/* ------------ +   Matemática +   ------------ +*/ + +// Aritmética +1 + 1 // 2 +2 - 1 // 1 +2 * 3 // 6 +3/2 // 1 +3.0 / 2 // 1.5 +3.0% 2 // 1.0 + +// O Processing também vem com um conjunto de funções que simplificam operações  +// matemáticas. +float f = sq(3); // f = 9.0 +float p = pow(3, 3); // p = 27.0 +int a = abs(-13); // a = 13 +int r1 = round(3.1); // r1 = 3 +int r2 = round(3.7); // r2 = 4 +float sr = sqrt(25); // sr = 5.0 + +// Vetores +// O Processing fornece uma maneira fácil de implementar vetores em seu ambiente +// usando a classe PVector. Ela pode descrever um vetor bi ou tridimensional e +// vem com um conjunto de métodos que são úteis para operações com matrizes. +// Você pode encontrar mais informações sobre a classe PVector e suas funções  +// aqui. (https://processing.org/reference/PVector.html) + +// Trigonometria +// O Processing também suporta operações trigonométricas fornecendo um  +// conjunto de funções. sin(), cos(), tan(), asin(), acos(), atan() e também  +// degrees() e radians() para conversão conveniente. +// No entanto, essas funções usam o ângulo em radianos como parâmetro, então é  +// necessário converter previamente. +float um = sin(PI/2); // um = 1.0 +// Como você deve ter notado, existe um conjunto de constantes para usos  +// trigonométricos; PI, HALF_PI, QUARTER_PI e assim por diante... + +/* ------------- +   Controle de fluxo +   ------------- +*/ + +// Declarações Condicionais +// Instruções If - A mesma sintaxe das instruções if em Java. +if (author.getAppearance().equals("quente")) { +  print("Narcisismo no máximo!"); +} else { +  // Você pode verificar outras condições aqui. +  print("Algo está realmente errado aqui!"); +} +// Um atalho para instruções if-else também pode ser usado. +int = 3; +String valor = (i > 5) ? "Grande" : "Pequena"; // "Pequena" + +// A estrutura switch-case pode ser usada para verificar várias condições de  +// forma concisa. É importante usar a instrução break. Se a instrução `break` +// não existe o programa executa todos os casos a seguir após um caso ser  +// verdadeiro. +int valor = 2; +switch(valor) { +  case 0: +    print("Nada!"); // Isso não é executado. +    break; // Salta para a próxima instrução +  case 1: +    print("Chegando lá..."); // Isso novamente não é executado. +    break; +  case 2: +    print("Bravo!"); // Esta linha é executada. +    break; +  default: +    print("Não encontrado!"); // Esta linha é executada se nosso valor for algum outro valor. +    break; +} + +// Declarações iterativas +// Declarações For - Novamente, a mesma sintaxe que em Java +for(int i = 0; i < 5; i++){ +  print(i); // imprime de 0 a 4 +} + +// Declarações While - Novamente, nada de novo se você estiver familiarizado com +// a sintaxe Java. +int j = 3; +while(j > 0) { +  print(j); +  j--; // Isso é importante para evitar que o código seja executado indefinidamente. +} + +// loop()| noLoop() | redraw() | exit() +// Estas são mais funções específicas do Processing para configurar o fluxo do  +// programa. +loop(); // permite que o método draw() seja executado para sempre enquanto +noLoop(); // só permite que ele seja executado uma vez. +redraw(); // executa o método draw() mais uma vez. +exit(); // Isso para o programa. É útil para programas com draw() +// rodando continuamente. +``` + +## Desenho com Processing + +Como você já deve ter entendido o básico da linguagem, vamos agora +ver a melhor parte do Processing - DESENHAR. + +``` +/* ------ +   Formas +   ------ +*/ + +// Formas 2D + +// Ponto +point(x, y); // No espaço 2D +point(x, y, z); // No espaço 3D +// Desenha um ponto no espaço de coordenadas. + +// Linha +line(x1, y1, x2, y2); // No espaço 2D +line(x1, y1, z1, x2, y2, z2); // No espaço 3D +// Desenha uma linha conectando dois pontos definidos por (x1, y1) e (x2, y2). + +// Triângulo +triangle(x1, y1, x2, y2, x3, y3); +// Desenha um triângulo conectando três pontos definidos por parâmetros de coordenadas. + +// Retângulo +rect(a, b, c, d, [r]); // Com parâmetro opcional definindo o raio de todos os cantos +rect(a, b, c, d, [te, td, bd, be]); // Com conjunto opcional de parâmetros definindo +// raio de cada canto +// Desenha um retângulo com {a, b} como coordenada superior esquerda e c e d como largura +// e altura respectivamente. + +// Quad +quad(x, y, x2, y2, x3, y3, x4, y4); +// Desenha um quadrilátero com parâmetros que definem as coordenadas de cada canto +// ponto. + +// Elipse +ellipse(x, y, largura, altura); +// Desenha um eclipse no ponto {x, y} com largura e altura especificadas. + +// Arco +arc(x, y, largura, altura, inicio, fim, [modo]); +// Enquanto os primeiros quatro parâmetros são autoexplicativos, +// início e fim definem os ângulos que o arco começa e termina (em radianos). +// O parâmetro opcional [mode] define o preenchimento; +// PIE dá o contorno de torta, CHORD dá o contorno reto e OPEN é como +// CHORD porém sem contorno + +// Curvas +// O Processing fornece duas implementações de curvas; usando curve() e  +// bezier(). Como pretendo manter isso simples, não vou discutir mais detalhes. +// No entanto, se você quiser implementá-lo em seu sketch, aqui estão as  +// referências: (https://processing.org/reference/curve_.html) +// (https://processing.org/reference/bezier_.html) + +// Formas 3D + +// espaço 3D +pode ser configurado definindo "P3D" para o parâmetro do renderizador no +// método size(). +size(largura, altura, P3D); +// No espaço 3D, você terá que traduzir para a coordenada específica para +// renderiza as formas 3D. + +// Caixa +box(tamanho); // Cubo com o mesmo comprimento definido pelo tamanho +box(w, h, d); // Caixa com largura, altura e profundidade definidas separadamente + +// Esfera +sphere(raio); // Seu tamanho é definido usando o parâmetro raio +// O mecanismo por trás da renderização das esferas é implementado por  +// triângulos em mosaico. Dito isso, o nível de detalhe sendo renderizado é  +// controlado pela função sphereDetail(res) +// Mais informações aqui: (https://processing.org/reference/sphereDetail_.html) + +// Formas irregulares +// E se você quiser desenhar algo que não foi disponibilizado pelo Processing +// funções? +// Você pode usar beginShape(), endShape(), vertex(x,y) para definir formas por +// especificando cada ponto. Mais informações aqui: +// (https://processing.org/reference/beginShape_.html) +// Você também pode usar formas personalizadas usando a classe PShape: +// (https://processing.org/reference/PShape.html) + +/* --------------- +   Transformações +   --------------- +*/ + +// As transformações são particularmente úteis para acompanhar o espaço de  +// coordenadas e os vértices das formas que você desenhou. Particularmente; +// métodos de pilha de matrizes; pushMatrix(), popMatrix() e translate(x,y) +pushMatriz(); // Salva o sistema de coordenadas atual na pilha +// ... aplique todas as transformações aqui ... +popMatriz(); // Restaura o sistema de coordenadas salvo +// Usando-os, o sistema de coordenadas pode ser preservado e visualizado sem +// causar qualquer conflito. + +// Traduzir +translate(x,y); // Traduz para o ponto{x, y} ou seja - configurando a origem para esse ponto +translate(x, y, z); // Contraparte 3D da função + +// Rotacionar +rotate(ângulo); // Gira a quantidade especificada pelo parâmetro ângulo +// Possui 3 contrapartes 3D para realizar a rotação, uma para cada dimensão:  +// rotateX(ângulo), rotateY(ângulo), rotateZ(ângulo) + +// Escala +scale(s); // Dimensiona o sistema de coordenadas expandindo ou contraindo-o. + +/* -------------------- +   Estilo e texturas +   -------------------- +*/ + +// Cores +// Como discuti anteriormente, a cor de fundo pode ser configurada usando a  +// função background(). Você pode definir a cor de um objeto de antemão e depois +// passar para a função como um argumento. +color c = cor(255, 255, 255); // BRANCO! +// Por padrão, o Processing usa o esquema de cores RGB, mas pode ser configurado +//  para HSB usando colorMode(). Leia mais aqui: +// (https://processing.org/reference/colorMode_.html) +background(c); // Até agora, a cor de fundo deve ser branca. +// Você pode usar a função fill() para selecionar a cor para preencher as formas. +// Tem que ser configurado antes de você começar a desenhar formas para que as  +// cores fiquem aplicadas. +fill(color(0, 0, 0)); +// Se você quiser apenas colorir os contornos das formas, você pode usar +// função stroke(). +stroke(255, 255, 0, 200); // cor do traço definida para amarelo com transparência +// definido para um valor menor. + +// Imagens +// O Processing pode renderizar imagens e usá-las de várias maneiras.  +// Principalmente armazenado como Tipo de dados PImage. +filter(sombreador); // O Processing suporta várias funções de filtro para manipulação de imagens. +texture(imagem); // PImage pode ser passado em argumentos para mapeamento de textura das formas. +``` + +Se você quiser levar as coisas adiante, há mais coisas que o Processing tem o poder de fazer. Renderizar modelos, shaders e outros efeitos. Há muito para se cobrir em uma +documentação curta, então vou deixá-los aqui. Se você se interessar, por favor verifique as referências. + +``` +// Antes de prosseguirmos, vou falar um pouco mais sobre como importar bibliotecas +// para que você possa estender a funcionalidade do Processing para outros horizontes. + +/* ------- +   Importações +   ------- +*/ + +// As possibilidades do Processing pode ser estendidas ainda mais quando  +// importamos bibliotecas e pacotes em nossos esboços. +// A instrução de importação pode ser escrita como abaixo na parte superior  +// do código-fonte. +import processing.algumacoisa.*; +``` + +## VAC? + +Vamos ao código? Vamos sujar as mãos! + +Vamos ver um exemplo do openprocessing para visualizar o quanto o Processing é +capaz de fazer com poucas linhas de código. + +Copie o código abaixo em seu IDE do Processing e veja a mágica. + +``` +// Isenção de responsabilidade: eu não escrevi este programa porque atualmente  +// estou ocupado com meu estágio e este sketch é adaptado do openprocessing pois +//  mostra algo legal com um código simples. +// Recuperado de: (https://www.openprocessing.org/sketch/559769) + +float theta; +float a; +float col; +float num; + +void setup() { +  size(600,600); +} + +void draw() { +  background(#F2F2F2); +  translate(width/2, height/2); +  theta = map(sin(millis()/1000.0), -1, 1, 0, PI/6); + +  float num=6; +  for (int i=0; i<num; i++) { +    a =350; +    rotate(TWO_PI/num); +    branch(a); +  } + +} + +void branch(float len) { +  col=map(len, 0, 90, 150, 255); +  fill(col, 0, 74); +  stroke (col, 0, 74); +  line(0, 0, 0, -len); +  ellipse(0, -len, 3, 3); +  len *= 0.7; + +  if (len>30) { +    pushMatrix(); +    translate(0, -30); +    rotate(theta); +    branch(len); +    popMatrix(); + +    pushMatrix(); +    translate(0, -30); +    rotate(-theta); +    branch(len); +    popMatrix(); + +  } +} +``` + +A linguagem Processing é fácil de aprender e é particularmente útil para criar +conteúdo (mesmo em 3D) sem ter que digitar muitos códigos. É tão simples +que você pode ler o código e ter uma ideia aproximada do fluxo do programa. + +No entanto, isso não se aplica quando você introduz bibliotecas externas, pacotes +e até mesmo suas próprias aulas. (Confie em mim! Projetos em processing podem ficar realmente monstruosos...) + +## Alguns recursos úteis + +  - [Site do Processing](http://processing.org) +  - [Sketches em Processing](http://openprocessing.org) diff --git a/pt-br/pythonstatcomp-pt.html.markdown b/pt-br/pythonstatcomp-pt.html.markdown new file mode 100644 index 00000000..aa532eb4 --- /dev/null +++ b/pt-br/pythonstatcomp-pt.html.markdown @@ -0,0 +1,249 @@ +--- +category: tool +tool: Statistical Computing with Python +contributors: +    - ["e99n09", "https://github.com/e99n09"] +translators: +    - ["waltercjunior", "https://github.com/waltercjunior"] +filename: pythonstatcomp-pt.py +lang: pt-br +--- + +Este é um tutorial sobre como fazer algumas tarefas típicas de programação estatística usando Python. +É destinado basicamente à pessoas familizarizadas com Python e experientes com programação estatística em linguagens como R, +Stata, SAS, SPSS ou MATLAB. + +```python + + + +# 0. Preparando-se ==== + +"""  Para começar, instale o seguinte : jupyther, numpy, scipy, pandas,  +    matplotlib, seaborn, requests. +    Certifique-se de executar este tutorial utilizando o Jupyther notebook para +    que você utilize os gráficos embarcados e ter uma fácil consulta à  +    documentação. +    O comando para abrir é simplesmente '`jupyter notebook`, quando abrir então +    clique em 'New -> Python'. +""" + +# 1. Aquisição de dados ==== + +""" A única razão das pessoas optarem por Python no lugar de R é que pretendem +    interagir com o ambiente web, copiando páginas diretamente ou solicitando +    dados utilizando uma API. Você pode fazer estas coisas em R, mas no  +    contexto de um projeto já usando Python, há uma vantagem em se ater uma +    linguágem única. +""" + +import requests  # para requisições HTTP (web scraping, APIs) +import os + +# web scraping +r = requests.get("https://github.com/adambard/learnxinyminutes-docs") +r.status_code  # se retornou código 200, a requisição foi bem sucedida +r.text  # código fonte bruto da página +print(r.text)  # formatado bonitinho +# salve a o código fonte d apágina em um arquivo: +os.getcwd()  # verifique qual é o diretório de trabalho +with open("learnxinyminutes.html", "wb") as f: +    f.write(r.text.encode("UTF-8")) + +# Baixar um arquivo csv +fp = "https://raw.githubusercontent.com/adambard/learnxinyminutes-docs/master/" +fn = "pets.csv" +r = requests.get(fp + fn) +print(r.text) +with open(fn, "wb") as f: +    f.write(r.text.encode("UTF-8")) + +""" para mais informações sobre o módulo de solicitações, incluindo API's, veja em +    http://docs.python-requests.org/en/latest/user/quickstart/ +""" + +# 2. Lendo um arquivo formato CSV ==== + +""" Um pacote de pandas da Wes McKinney lhe dá um objeto 'DataFrame' em Python. +    Se você já usou R, já deve estar familiarizado com a ideia de "data.frame". +""" + +import pandas as pd +import numpy as np +import scipy as sp +pets = pd.read_csv(fn) +pets +#        name  age  weight species +# 0    fluffy    3      14     cat +# 1  vesuvius    6      23    fish +# 2       rex    5      34     dog + +""" Usuários R: observe que o Python, como a maioria das linguagens de programação  +    influenciada pelo C, a indexação começa de 0. Em R, começa a indexar em 1 +    devido à influência do Fortran. +""" + +# duas maneiras diferentes de imprimir uma coluna +pets.age +pets["age"] + +pets.head(2)  # imprima as 2 primeiras linhas +pets.tail(1)  # imprima a última linha + +pets.name[1]  # 'vesuvius' +pets.species[0]  # 'cat' +pets["weight"][2]  # 34 + +# Em R, você esperaria obter 3 linhas fazendo isso, mas aqui você obtem 2: +pets.age[0:2] +# 0    3 +# 1    6 + +sum(pets.age) * 2  # 28 +max(pets.weight) - min(pets.weight)  # 20 + +""" Se você está fazendo alguma álgebra linear séria e processamento de  +    números você pode desejar apenas arrays, não DataFrames. DataFrames são +    ideais para combinar colunas de diferentes tipos de dados. +""" + +# 3. Gráficos ==== + +import matplotlib as mpl +import matplotlib.pyplot as plt +%matplotlib inline + +# Para fazer a visualiação de dados em Python, use matplotlib + +plt.hist(pets.age); + +plt.boxplot(pets.weight); + +plt.scatter(pets.age, pets.weight) +plt.xlabel("age") +plt.ylabel("weight"); + +# seaborn utiliza a biblioteca do matplotlib e torna os enredos mais bonitos + +import seaborn as sns + +plt.scatter(pets.age, pets.weight) +plt.xlabel("age") +plt.ylabel("weight"); + +# também existem algumas funções de plotagem específicas do seaborn +# observe como o seaborn automaticamenteo o eixto x neste gráfico de barras +sns.barplot(pets["age"]) + +# Veteranos em R ainda podem usar o ggplot +from ggplot import * +ggplot(aes(x="age",y="weight"), data=pets) + geom_point() + labs(title="pets") +# fonte: https://pypi.python.org/pypi/ggplot + +# há até um d3.js veja em: https://github.com/mikedewar/d3py + +# 4. Limpeza de dados simples e análise exploratória ==== + +""" Aqui está um exemplo mais complicado que demonstra dados básicos +    fluxo de trabalho de limpeza levando à criação de algumas parcelas +    e a execução de uma regressão linear. +        O conjunto de dados foi transcrito da Wikipedia à mão. Contém +    todos os sagrados imperadores romanos e os marcos importantes em suas vidas +    (birth, death, coronation, etc.). +        O objetivo da análise será explorar se um relacionamento existe +    entre o ano de nascimento (birth year) e a expectativa de vida (lifespam) +    do imperador. +    Fonte de dados: https://en.wikipedia.org/wiki/Holy_Roman_Emperor +""" + +# carregue alguns dados dos sagrados imperadores romanos +url = "https://raw.githubusercontent.com/adambard/learnxinyminutes-docs/master/hre.csv" +r = requests.get(url) +fp = "hre.csv" +with open(fp, "wb") as f: +    f.write(r.text.encode("UTF-8")) + +hre = pd.read_csv(fp) + +hre.head() +""" +   Ix      Dynasty        Name        Birth             Death +0 NaN  Carolingian   Charles I  2 April 742    28 January 814 +1 NaN  Carolingian     Louis I          778       20 June 840 +2 NaN  Carolingian   Lothair I          795  29 September 855 +3 NaN  Carolingian    Louis II          825     12 August 875 +4 NaN  Carolingian  Charles II  13 June 823     6 October 877 + +       Coronation 1   Coronation 2 Ceased to be Emperor +0   25 December 800            NaN       28 January 814 +1  11 September 813  5 October 816          20 June 840 +2       5 April 823            NaN     29 September 855 +3        Easter 850     18 May 872        12 August 875 +4   29 December 875            NaN        6 October 877 +""" + +# limpar as colunas Birth e Death + +import re  # módulo para expressões regulares + +rx = re.compile(r'\d+$')  # conincidir com os códigos finais + +""" Esta função aplia a expressão reguar a uma coluna de entrada (here Birth, +    Death), nivela a lista resultante, converte-a em uma lista de objetos, e +    finalmente converte o tipo do objeto da lista de String para inteiro. para +    mais informações sobre o que as diferentes partes do código fazer, veja em: +      - https://docs.python.org/2/howto/regex.html +      - http://stackoverflow.com/questions/11860476/how-to-unlist-a-python-list +      - http://pandas.pydata.org/pandas-docs/stable/generated/pandas.Series.html +""" + +from functools import reduce + +def extractYear(v): +    return(pd.Series(reduce(lambda x, y: x + y, map(rx.findall, v), [])).astype(int)) + +hre["BirthY"] = extractYear(hre.Birth) +hre["DeathY"] = extractYear(hre.Death) + +# faça uma coluna infomrnado a idade estimada ("EstAge") +hre["EstAge"] = hre.DeathY.astype(int) - hre.BirthY.astype(int) + +# gráfico de dispersão simples, sem linha de tendência, cor representa dinastia +sns.lmplot("BirthY", "EstAge", data=hre, hue="Dynasty", fit_reg=False) + +# use o scipy para executar uma regrassão linear +from scipy import stats +(slope, intercept, rval, pval, stderr) = stats.linregress(hre.BirthY, hre.EstAge) +# código fonte: http://wiki.scipy.org/Cookbook/LinearRegression + +# varifique o declive (slope) +slope  # 0.0057672618839073328 + +# varifique o valor R^2: +rval**2  # 0.020363950027333586 + +# varifique o valor p-value +pval  # 0.34971812581498452 + +# use o seaborn para fazer um gráfico de dispersão e traçar a linha de tendência de regrassão linear +sns.lmplot("BirthY", "EstAge", data=hre) + +""" Para mais informações sobre o seaborn, veja +      - http://web.stanford.edu/~mwaskom/software/seaborn/ +      - https://github.com/mwaskom/seaborn +    Para mais informações sobre o SciPy, veja +      - http://wiki.scipy.org/SciPy +      - http://wiki.scipy.org/Cookbook/ +    Para ver uma versão da análise dos sagrados imperadores romanos usando R, consulte +      - http://github.com/e99n09/R-notes/blob/master/holy_roman_emperors_dates.R +""" + +``` + +Se você quiser saber mais, obtenha o Python para análise de dados de Wes McKinney. É um excelente recurso e usei-o como referência ao escrever este tutorial. + +Você também pode encontrar muitos tutoriais interativos de IPython sobre assuntos específicos de seus interesses, como Cam Davidson-Pilon's <a href="http://camdavidsonpilon.github.io/Probabilistic-Programming-and-Bayesian-Methods-for-Hackers/" Title="Programação Probabilística e Métodos Bayesianos para Hackers">Programação Probabilística e Métodos Bayesianos para Hackers</a>. + +Mais alguns módulos para pesquisar: +   - análise de texto e processamento de linguagem natural: nltk, http://www.nltk.org +   - análise de rede social: igraph, http://igraph.org/python/ diff --git a/pt-br/qt-pt.html.markdown b/pt-br/qt-pt.html.markdown index 99579c35..f4211e09 100644 --- a/pt-br/qt-pt.html.markdown +++ b/pt-br/qt-pt.html.markdown @@ -1,7 +1,7 @@  ---  category: tool  tool: Qt Framework -language: c++ +language: C++  filename: learnqt-pt.cpp  contributors:      - ["Aleksey Kholovchuk", "https://github.com/vortexxx192"] diff --git a/pt-br/r-pt.html.markdown b/pt-br/r-pt.html.markdown new file mode 100644 index 00000000..5c9304ec --- /dev/null +++ b/pt-br/r-pt.html.markdown @@ -0,0 +1,786 @@ +--- +language: R +contributors: +    - ["e99n09", "http://github.com/e99n09"] +    - ["isomorphismes", "http://twitter.com/isomorphisms"] +    - ["kalinn", "http://github.com/kalinn"] +translators: +    - ["Marcel Ribeiro-Dantas", "http://github.com/mribeirodantas"] +lang: pt-br     +filename: learnr-pt.r +--- + +R é uma linguagem de programação estatística. Ela tem muitas bibliotecas para carregar e limpar conjuntos de dados, executar análises estatísticas e produzir gráficos. Você também pode executar comandos do `R` dentro de um documento LaTeX. + +```r + +# Comentários começam com o símbolo de Cerquilha, também conhecido como +# jogo da velha + +# Não existe um símbolo especial para comentários em várias linhas +# mas você pode escrever várias linhas de comentários adicionando a +# cerquilha (#) ao início de cada uma delas. + +# No Windows e Linux, você pode usar CTRL-ENTER para executar uma linha. +# No MacOS, o equivalente é COMMAND-ENTER + + + +############################################################################# +# Coisas que você pode fazer sem entender nada sobre programação +############################################################################# + +# Nesta seção, mostramos algumas das coisas legais que você pode fazer em +# R sem entender nada de programação. Não se preocupe em entender tudo o +# que o código faz. Apenas aproveite! + +data()	          # navegue pelos conjuntos de dados pré-carregados +data(rivers)	  # carregue este: "Comprimentos dos principais rios norte-americanos" +ls()	          # observe que "rivers" apareceu na área de trabalho (workspace) +head(rivers)	  # dê uma espiada no conjunto de dados +# 735 320 325 392 524 450 + +length(rivers)	  # quantos rios foram medidos? +# 141 +summary(rivers)   # consulte um sumário de estatísticas básicas +#   Min. 1st Qu.  Median    Mean 3rd Qu.    Max. +#  135.0   310.0   425.0   591.2   680.0  3710.0 + +# faça um diagrama de ramos e folhas (uma visualização de dados semelhante a um histograma) +stem(rivers) + +#  A vírgula está 2 dígito(s) à direita do símbolo | +# +#   0 | 4 +#   2 | 011223334555566667778888899900001111223333344455555666688888999 +#   4 | 111222333445566779001233344567 +#   6 | 000112233578012234468 +#   8 | 045790018 +#  10 | 04507 +#  12 | 1471 +#  14 | 56 +#  16 | 7 +#  18 | 9 +#  20 | +#  22 | 25 +#  24 | 3 +#  26 | +#  28 | +#  30 | +#  32 | +#  34 | +#  36 | 1 + +stem(log(rivers)) # Observe que os dados não são normais nem log-normais! +# Tome isso, fundamentalistas da curva normal! + +#  O ponto decimal está 1 dígito(s) à esquerda do símbolo | +# +#  48 | 1 +#  50 | +#  52 | 15578 +#  54 | 44571222466689 +#  56 | 023334677000124455789 +#  58 | 00122366666999933445777 +#  60 | 122445567800133459 +#  62 | 112666799035 +#  64 | 00011334581257889 +#  66 | 003683579 +#  68 | 0019156 +#  70 | 079357 +#  72 | 89 +#  74 | 84 +#  76 | 56 +#  78 | 4 +#  80 | +#  82 | 2 + +# faça um histograma: +hist(rivers, col="#333333", border="white", breaks=25)      # brinque com estes parâmetros +hist(log(rivers), col="#333333", border="white", breaks=25) # você fará mais gráficos mais tarde + +# Aqui está outro conjunto de dados que vem pré-carregado. O R tem toneladas deles. +data(discoveries) +plot(discoveries, col="#333333", lwd=3, xlab="Ano", +     main="Número de descobertas importantes por ano") +plot(discoveries, col="#333333", lwd=3, type = "h", xlab="Ano", +     main="Número de descobertas importantes por ano") + +# Em vez de deixar a ordenação padrão (por ano), +# também podemos ordenar para ver o que é mais comum: +sort(discoveries) +#  [1]  0  0  0  0  0  0  0  0  0  1  1  1  1  1  1  1  1  1  1  1  1  2  2  2  2 +# [26]  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  2  3  3  3 +# [51]  3  3  3  3  3  3  3  3  3  3  3  3  3  3  3  3  3  4  4  4  4  4  4  4  4 +# [76]  4  4  4  4  5  5  5  5  5  5  5  6  6  6  6  6  6  7  7  7  7  8  9 10 12 + +stem(discoveries, scale=2) +# +#  O ponto decimal está no símbolo | +# +#   0 | 000000000 +#   1 | 000000000000 +#   2 | 00000000000000000000000000 +#   3 | 00000000000000000000 +#   4 | 000000000000 +#   5 | 0000000 +#   6 | 000000 +#   7 | 0000 +#   8 | 0 +#   9 | 0 +#  10 | 0 +#  11 | +#  12 | 0 + +max(discoveries) +# 12 +summary(discoveries) +#   Min. 1st Qu.  Median    Mean 3rd Qu.    Max. +#    0.0     2.0     3.0     3.1     4.0    12.0 + +# Role um dado algumas vezes +round(runif(7, min=.5, max=6.5)) +# 1 4 6 1 4 6 4 +# Seus números serão diferentes dos meus, a menos que definamos a mesma semente aleatória com o set.seed + +# Obtenha 9 números de forma aleatória a partir de uma distribuição normal +rnorm(9) +# [1]  0.07528471  1.03499859  1.34809556 -0.82356087  0.61638975 -1.88757271 +# [7] -0.59975593  0.57629164  1.08455362 + + + +################################################## +# Tipos de dados e aritmética básica +################################################## + +# Agora para a parte orientada a programação do tutorial. +# Nesta seção você conhecerá os tipos de dados importantes do R: +# integers, numerics, characters, logicals, e factors. +# Existem outros, mas estes são o mínimo que você precisa para +# iniciar. + +# INTEGERS +# Os inteiros de armazenamento longo são escritos com L +5L # 5 +class(5L) # "integer" +# (Experimente ?class para obter mais informações sobre a função class().) +# Em R, todo e qualquer valor, como 5L, é considerado um vetor de comprimento 1 +length(5L) # 1 +# Você pode ter um vetor inteiro com comprimento > 1 também: +c(4L, 5L, 8L, 3L) # 4 5 8 3 +length(c(4L, 5L, 8L, 3L)) # 4 +class(c(4L, 5L, 8L, 3L)) # "integer" + +# NUMERICS +# Um "numeric" é um número de ponto flutuante de precisão dupla +5 # 5 +class(5) # "numeric" +# De novo, tudo em R é um vetor; +# você pode fazer um vetor numérico com mais de um elemento +c(3,3,3,2,2,1) # 3 3 3 2 2 1 +# Você também pode usar a notação científica +5e4 # 50000 +6.02e23 # Número de Avogadro +1.6e-35 # Comprimento de Planck +# Você também pode ter números infinitamente grandes ou pequenos +class(Inf)	# "numeric" +class(-Inf)	# "numeric" +# Você pode usar "Inf", por exemplo, em integrate(dnorm, 3, Inf) +# isso evita as tabelas de escores-Z. + +# ARITMÉTICA BÁSICA +# Você pode fazer aritmética com números +# Fazer aritmética com uma mistura de números inteiros (integers) e com +# ponto flutuante (numeric) resulta em um numeric +10L + 66L # 76      # integer mais integer resulta em integer +53.2 - 4  # 49.2    # numeric menos numeric resulta em numeric +2.0 * 2L  # 4       # numeric vezes integer resulta em numeric +3L / 4    # 0.75    # integer dividido por numeric resulta em numeric +3 %% 2	  # 1       # o resto de dois numeric é um outro numeric +# Aritmética ilegal produz um "não-é-um-número" (do inglês Not-a-Number): +0 / 0 # NaN +class(NaN) # "numeric" +# Você pode fazer aritmética em dois vetores com comprimento maior que 1, +# desde que o comprimento do vetor maior seja um múltiplo inteiro do menor +c(1,2,3) + c(1,2,3) # 2 4 6 +# Como um único número é um vetor de comprimento um, escalares são aplicados +# elemento a elemento com relação a vetores +(4 * c(1,2,3) - 2) / 2 # 1 3 5 +# Exceto para escalares, tenha cuidado ao realizar aritmética em vetores com +# comprimentos diferentes. Embora possa ser feito, +c(1,2,3,1,2,3) * c(1,2) # 1 4 3 2 2 6 +# ter comprimentos iguais é uma prática melhor e mais fácil de ler +c(1,2,3,1,2,3) * c(1,2,1,2,1,2)  + +# CHARACTERS +# Não há diferença entre strings e caracteres em R +"Horatio" # "Horatio" +class("Horatio") # "character" +class('H') # "character" +# São ambos vetores de caracteres de comprimento 1 +# Aqui está um mais longo: +c('alef', 'bet', 'gimmel', 'dalet', 'he') +# "alef"   "bet"    "gimmel" "dalet"  "he" +length(c("Call","me","Ishmael")) # 3 +# Você pode utilizar expressões regulares (regex) em vetores de caracteres: +substr("Fortuna multis dat nimis, nulli satis.", 9, 15) # "multis " +gsub('u', 'ø', "Fortuna multis dat nimis, nulli satis.") # "Fortøna møltis dat nimis, nølli satis." +# R tem vários vetores de caracteres embutidos: +letters +#  [1] "a" "b" "c" "d" "e" "f" "g" "h" "i" "j" "k" "l" "m" "n" "o" "p" "q" "r" "s" +# [20] "t" "u" "v" "w" "x" "y" "z" +month.abb # "Jan" "Feb" "Mar" "Apr" "May" "Jun" "Jul" "Aug" "Sep" "Oct" "Nov" "Dec" + +# LOGICALS +# Em R, um "logical" é um booleano +class(TRUE)	# "logical" +class(FALSE)	# "logical" +# O comportamento deles é normal +TRUE == TRUE	# TRUE +TRUE == FALSE	# FALSE +FALSE != FALSE	# FALSE +FALSE != TRUE	# TRUE +# Dados ausentes (NA) são logical, também +class(NA)	# "logical" +# Use | e & para operações lógicas. +# OR +TRUE | FALSE	# TRUE +# AND +TRUE & FALSE	# FALSE +# Aplicar | e & a vetores retorna operações lógicas elemento a elemento +c(TRUE,FALSE,FALSE) | c(FALSE,TRUE,FALSE) # TRUE TRUE FALSE +c(TRUE,FALSE,TRUE) & c(FALSE,TRUE,TRUE) # FALSE FALSE TRUE +# Você pode testar se x é TRUE +isTRUE(TRUE)	# TRUE +# Aqui obtemos um vetor logical com muitos elementos: +c('Z', 'o', 'r', 'r', 'o') == "Zorro" # FALSE FALSE FALSE FALSE FALSE +c('Z', 'o', 'r', 'r', 'o') == "Z" # TRUE FALSE FALSE FALSE FALSE + +# FACTORS +# A classe factor é para dados categóricos +# Os fatores podem ser ordenados (como as avaliações de crianças) ou +# não ordenados (como as cores) +factor(c("azul", "azul", "verde", NA, "azul")) +#  azul azul verde   <NA>   azul +# Levels: azul verde +# Os "levels" são os valores que os dados categóricos podem assumir +# Observe que os dados ausentes não entram nos levels +levels(factor(c("verde", "verde", "azul", NA, "azul"))) # "azul" "verde" +# Se um vetor de factor tem comprimento 1, seus levels também terão comprimento 1 +length(factor("green")) # 1 +length(levels(factor("green"))) # 1 +# Os fatores são comumente vistos em data frames, uma estrutura de dados que abordaremos +# mais tarde +data(infert) # "Infertilidade após aborto espontâneo e induzido" +levels(infert$education) # "0-5yrs"  "6-11yrs" "12+ yrs" + +# NULL +# "NULL" é um valor estranho; use-o para "apagar" um vetor +class(NULL)	# NULL +parakeet = c("bico", "penas", "asas", "olhos") +parakeet +# [1] "bico"  "penas" "asas"  "olhos" +parakeet <- NULL +parakeet +# NULL + +# COERÇÃO DE TIPO +# Coerção de tipo é quando você força um valor a assumir um tipo diferente +as.character(c(6, 8)) # "6" "8" +as.logical(c(1,0,1,1)) # TRUE FALSE  TRUE  TRUE +# Se você colocar elementos de diferentes tipos em um vetor, coerções estranhas acontecem: +c(TRUE, 4) # 1 4 +c("cachorro", TRUE, 4) # "cachorro"  "TRUE" "4" +as.numeric("Bilbo") +# [1] NA +# Warning message: +# NAs introduced by coercion + +# Observe também: esses são apenas os tipos de dados básicos +# Existem muitos outros tipos de dados, como datas, séries temporais, etc. + + + +################################################## +# Variáveis, laços, expressões condicionais +################################################## + +# Uma variável é como uma caixa na qual você armazena um valor para uso posterior. +# Chamamos isso de "atribuir" o valor à variável. +# Ter variáveis nos permite escrever laços, funções e instruções com condição + +# VARIÁVEIS +# Existem muitas maneiras de atribuir valores: +x = 5 # é possível fazer assim +y <- "1" # mas é preferível fazer assim +TRUE -> z # isso funciona, mas é estranho + +# LAÇOS +# Nós temos laços com for +for (i in 1:4) { +  print(i) +} +# [1] 1 +# [1] 2 +# [1] 3 +# [1] 4 +# Nós temos laços com while +a <- 10 +while (a > 4) { +	cat(a, "...", sep = "") +	a <- a - 1 +} +# 10...9...8...7...6...5... +# Tenha em mente que os laços for e while são executados lentamente em R +# Operações em vetores inteiros (por exemplo, uma linha inteira, uma coluna inteira) +# ou funções do tipo apply() (discutiremos mais tarde) são mais indicadas + +# IF/ELSE +# Novamente, bastante padrão +if (4 > 3) { +	print("4 é maior que 3") +} else { +	print("4 não é maior que 3") +} +# [1] "4 é maior que 3" + +# FUNÇÕES +# Definidas assim: +jiggle <- function(x) { +	x = x + rnorm(1, sd=.1)	# adicione um pouco de ruído (controlado) +	return(x) +} +# Chamada como qualquer outra função R: +jiggle(5)	# 5±ε. Após set.seed(2716057), jiggle(5)==5.005043 + + + +########################################################################### +# Estruturas de dados: Vetores, matrizes, data frames e arranjos (arrays) +########################################################################### + +# UNIDIMENSIONAL + +# Vamos começar do início, e com algo que você já sabe: vetores. +vec <- c(8, 9, 10, 11) +vec	#  8  9 10 11 +# Consultamos elementos específicos utilizando colchetes +# (Observe que R começa a contar a partir de 1) +vec[1]		# 8 +letters[18]	# "r" +LETTERS[13]	# "M" +month.name[9]	# "September" +c(6, 8, 7, 5, 3, 0, 9)[3]	# 7 +# Também podemos pesquisar os índices de componentes específicos, +which(vec %% 2 == 0)	# 1 3 +# pegue apenas as primeiras ou últimas entradas no vetor, +head(vec, 1)	# 8 +tail(vec, 2)	# 10 11 +# ou descubra se um determinado valor está no vetor +any(vec == 10) # TRUE +# Se um índice for além do comprimento de um vetor, você obterá NA: +vec[6]	# NA +# Você pode encontrar o comprimento do seu vetor com length() +length(vec)	# 4 +# Você pode realizar operações em vetores inteiros ou subconjuntos de vetores +vec * 4	# 32 36 40 44 +vec[2:3] * 5	# 45 50 +any(vec[2:3] == 8) # FALSE +# e R tem muitas funções internas para sumarizar vetores +mean(vec)	# 9.5 +var(vec)	# 1.666667 +sd(vec)		# 1.290994 +max(vec)	# 11 +min(vec)	# 8 +sum(vec)	# 38 +# Mais alguns recursos embutidos: +5:15	# 5  6  7  8  9 10 11 12 13 14 15 +seq(from=0, to=31337, by=1337) +#  [1]     0  1337  2674  4011  5348  6685  8022  9359 10696 12033 13370 14707 +# [13] 16044 17381 18718 20055 21392 22729 24066 25403 26740 28077 29414 30751 + +# BIDIMENSIONAL (ELEMENTOS DA MESMA CLASSE) + +# Você pode fazer uma matriz com entradas do mesmo tipo assim: +mat <- matrix(nrow = 3, ncol = 2, c(1,2,3,4,5,6)) +mat +#      [,1] [,2] +# [1,]    1    4 +# [2,]    2    5 +# [3,]    3    6 +# Ao contrário de um vetor, a classe de uma matriz é "matrix" independente do que ela contém +class(mat) # "matrix" +# Consulte a primeira linha +mat[1,]	# 1 4 +# Execute uma operação na primeira coluna +3 * mat[,1]	# 3 6 9 +# Consulte uma célula específica +mat[3,2]	# 6 + +# Transponha toda a matriz +t(mat) +#      [,1] [,2] [,3] +# [1,]    1    2    3 +# [2,]    4    5    6 + +# Multiplicação de matrizes +mat %*% t(mat) +#      [,1] [,2] [,3] +# [1,]   17   22   27 +# [2,]   22   29   36 +# [3,]   27   36   45 + +# cbind() une vetores em colunas para formar uma matriz +mat2 <- cbind(1:4, c("cachorro", "gato", "passaro", "cachorro")) +mat2 +#      [,1] [,2] +# [1,] "1"  "cachorro" +# [2,] "2"  "gato" +# [3,] "3"  "passaro" +# [4,] "4"  "cachorro" +class(mat2)	# matrix +# Mais uma vez, observe o que aconteceu! +# Como as matrizes devem conter todas as entradas da mesma classe, +# tudo foi convertido para a classe character +c(class(mat2[,1]), class(mat2[,2])) + +# rbind() une vetores linha a linha para fazer uma matriz +mat3 <- rbind(c(1,2,4,5), c(6,7,0,4)) +mat3 +#      [,1] [,2] [,3] [,4] +# [1,]    1    2    4    5 +# [2,]    6    7    0    4 +# Ah, tudo da mesma classe. Sem coerções. Muito melhor. + +# BIDIMENSIONAL (CLASSES DIFERENTES) + +# Para colunas de tipos diferentes, use um data frame +# Esta estrutura de dados é tão útil para programação estatística, +# que uma versão dela foi adicionada ao Python através do pacote "pandas". + +estudantes <- data.frame(c("Cedric","Fred","George","Cho","Draco","Ginny"), +                         c(3,2,2,1,0,-1), +                         c("H", "G", "G", "R", "S", "G")) +names(estudantes) <- c("nome", "ano", "casa") # nomeie as colunas +class(estudantes)	# "data.frame" +estudantes +#     nome  ano  casa +# 1 Cedric    3     H +# 2   Fred    2     G +# 3 George    2     G +# 4    Cho    1     R +# 5  Draco    0     S +# 6  Ginny   -1     G +class(estudantes$ano)	# "numeric" +class(estudantes[,3])	# "factor" +# encontre as dimensões +nrow(estudantes)	# 6 +ncol(estudantes)	# 3 +dim(estudantes)	# 6 3 +# A função data.frame() converte vetores de caracteres em vetores de fator +# por padrão; desligue isso definindo stringsAsFactors = FALSE quando +# você criar um data frame +?data.frame + +# Existem muitas maneiras particulares de consultar partes de um data frame, +# todas sutilmente diferentes +estudantes$ano	# 3  2  2  1  0 -1 +estudantes[,2]	# 3  2  2  1  0 -1 +estudantes[,"ano"]	# 3  2  2  1  0 -1 + +# Uma versão extendida da estrutura data.frame é a data.table +# Se você estiver trabalhando com dados enormes ou em painel, ou precisar mesclar +# alguns conjuntos de dados, data.table pode ser uma boa escolha. Aqui está um tour +# relâmpago: +install.packages("data.table") # baixe o pacote a partir do CRAN +require(data.table) # carregue ele +estudantes <- as.data.table(estudantes) +estudantes # observe a saída ligeiramente diferente +#      nome  ano  casa +# 1: Cedric    3     H +# 2:   Fred    2     G +# 3: George    2     G +# 4:    Cho    1     R +# 5:  Draco    0     S +# 6:  Ginny   -1     G +estudantes[nome=="Ginny"] # Consulte estudantes com o nome == "Ginny" +#     nome  ano  casa +# 1: Ginny   -1     G +estudantes[ano==2] # Consulte estudantes com o ano == 2 +#      nome  ano  casa +# 1:   Fred    2     G +# 2: George    2     G +# data.table facilita a fusão de dois conjuntos de dados +# vamos fazer outro data.table para mesclar com os alunos +fundadores <- data.table(casa=c("G","H","R","S"), +                         fundador=c("Godric","Helga","Rowena","Salazar")) +fundadores +#     casa fundador +# 1:     G  Godric +# 2:     H   Helga +# 3:     R  Rowena +# 4:     S Salazar +setkey(estudantes, casa) +setkey(fundadores, casa) +estudantes <- fundadores[estudantes] # mescle os dois conjuntos de dados com base na "casa" +setnames(estudantes, c("casa","nomeFundadorCasa","nomeEstudante","ano")) +estudantes[,order(c("nome","ano","casa","nomeFundadorCasa")), with=F] +#  nomeEstudante  ano  casa nomeFundadorCasa +# 1:        Fred    2     G           Godric +# 2:      George    2     G           Godric +# 3:       Ginny   -1     G           Godric +# 4:      Cedric    3     H            Helga +# 5:         Cho    1     R           Rowena +# 6:       Draco    0     S          Salazar + +# O data.table torna as tabelas de sumário fáceis +estudantes[,sum(ano),by=casa] +#     casa V1 +# 1:     G  3 +# 2:     H  3 +# 3:     R  1 +# 4:     S  0 + +# Para remover uma coluna de um data.frame ou data.table, +# atribua a ela o valor NULL +estudantes$nomeFundadorCasa <- NULL +estudantes +#  nomeEstudante  ano  casa +# 1:        Fred    2     G +# 2:      George    2     G +# 3:       Ginny   -1     G +# 4:      Cedric    3     H +# 5:         Cho    1     R +# 6:       Draco    0     S + +# Remova uma linha consultando parte dos dados +# Usando data.table: +estudantes[nomeEstudante != "Draco"] +#     casa estudanteNome  ano +# 1:     G          Fred    2 +# 2:     G        George    2 +# 3:     G         Ginny   -1 +# 4:     H        Cedric    3 +# 5:     R           Cho    1 +# Usando data.frame: +estudantes <- as.data.frame(estudantes) +estudantes[estudantes$casa != "G",] +#    casa nomeFundadorCasa nomeEstudante  ano +# 4     H            Helga        Cedric    3 +# 5     R           Rowena           Cho    1 +# 6     S          Salazar         Draco    0 + +# MULTIDIMENSIONAL (TODOS OS ELEMENTOS DE UM TIPO) + +# Arranjos (arrays) criam tabelas n-dimensionais +# Todos os elementos devem ser do mesmo tipo +# Você pode fazer uma tabela bidimensional (como uma matriz) +array(c(c(1,2,4,5),c(8,9,3,6)), dim=c(2,4)) +#      [,1] [,2] [,3] [,4] +# [1,]    1    4    8    3 +# [2,]    2    5    9    6 +# Você pode usar array para fazer matrizes tridimensionais também +array(c(c(c(2,300,4),c(8,9,0)),c(c(5,60,0),c(66,7,847))), dim=c(3,2,2)) +# , , 1 +# +#      [,1] [,2] +# [1,]    2    8 +# [2,]  300    9 +# [3,]    4    0 +# +# , , 2 +# +#      [,1] [,2] +# [1,]    5   66 +# [2,]   60    7 +# [3,]    0  847 + +# LISTAS (MULTIDIMENSIONAIS, POSSIVELMENTE IMPERFEITAS, DE DIFERENTES TIPOS) + +# Finalmente, R tem listas (de vetores) +lista1 <- list(tempo = 1:40) +lista1$preco = c(rnorm(40,.5*lista1$tempo,4)) # aleatória +lista1 +# Você pode obter itens na lista assim +lista1$tempo # um modo +lista1[["tempo"]] # um outro modo +lista1[[1]] # e ainda um outro modo +#  [1]  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 +# [34] 34 35 36 37 38 39 40 +# Você pode obter itens de uma lista como qualquer outro vetor +lista1$preco[4] + +# Listas não são a estrutura de dados mais eficiente para se trabalhar em R; +# a menos que você tenha um bom motivo, você deve se ater a data.frames +# As listas geralmente são retornadas por funções que realizam regressões lineares + +################################################## +# A família de funções apply() +################################################## + +# Lembra de mat? +mat +#      [,1] [,2] +# [1,]    1    4 +# [2,]    2    5 +# [3,]    3    6 +# Use apply(X, MARGIN, FUN) para aplicar a função FUN a uma matriz X +# sobre linhas (MARGIN = 1) ou colunas (MARGIN = 2) +# Ou seja, R faz FUN para cada linha (ou coluna) de X, muito mais rápido que um +# laço for ou while faria +apply(mat, MAR = 2, jiggle) +#      [,1] [,2] +# [1,]    3   15 +# [2,]    7   19 +# [3,]   11   23 +# Outras funções: ?lappy, ?sapply + +# Não as deixe te intimidar; todos concordam que essas funções são bem confusas + +# O pacote plyr visa substituir (e melhorar!) a família *apply(). +install.packages("plyr") +require(plyr) +?plyr + + + +######################### +# Carregando dados +######################### + +# "pets.csv" é um arquivo hospedado na internet +# (mas também poderia tranquilamente ser um arquivo no seu computador) +require(RCurl) +pets <- read.csv(textConnection(getURL("https://learnxinyminutes.com/docs/pets.csv"))) +pets +head(pets, 2) # primeiras duas linhas +tail(pets, 1) # última linha + +# Para salvar um data frame ou matriz como um arquivo .csv: +write.csv(pets, "pets2.csv") # para criar um novo arquivo .csv +# Define o diretório de trabalho com setwd(), confirme em qual você está com getwd() + +# Experimente ?read.csv e ?write.csv para obter mais informações + + + +######################### +# Análise estatística +######################### + +# Regressão linear! +modeloLinear <- lm(preco  ~ tempo, data = lista1) +modeloLinear # imprime na tela o resultado da regressão +# Call: +# lm(formula = preco ~ tempo, data = lista1) +#  +# Coefficients: +# (Intercept)        tempo   +#      0.1453       0.4943   +summary(modeloLinear) # saída mais detalhada da regressão +# Call: +# lm(formula = preco ~ tempo, data = lista1) +# +# Residuals: +#     Min      1Q  Median      3Q     Max  +# -8.3134 -3.0131 -0.3606  2.8016 10.3992  +# +# Coefficients: +#             Estimate Std. Error t value Pr(>|t|)     +# (Intercept)  0.14527    1.50084   0.097    0.923     +# tempo        0.49435    0.06379   7.749 2.44e-09 *** +# --- +# Signif. codes:  0 ‘***’ 0.001 ‘**’ 0.01 ‘*’ 0.05 ‘.’ 0.1 ‘ ’ 1 +# +# Residual standard error: 4.657 on 38 degrees of freedom +# Multiple R-squared:  0.6124,	Adjusted R-squared:  0.6022  +# F-statistic: 60.05 on 1 and 38 DF,  p-value: 2.44e-09 +coef(modeloLinear) # extrai os parâmetros estimados +# (Intercept)       tempo  +#   0.1452662   0.4943490  +summary(modeloLinear)$coefficients # um outro meio de extrair os resultados +#              Estimate Std. Error    t value     Pr(>|t|) +# (Intercept) 0.1452662 1.50084246 0.09678975 9.234021e-01 +# tempo       0.4943490 0.06379348 7.74920901 2.440008e-09 +summary(modeloLinear)$coefficients[,4] # the p-values  +#  (Intercept)        tempo +# 9.234021e-01 2.440008e-09  + +# MODELOS LINEARES GERAIS +# Regressão logística +set.seed(1) +lista1$sucesso = rbinom(length(lista1$tempo), 1, .5) # binário aleatório +modeloLg <- glm(sucesso  ~ tempo, data = lista1,  +	family=binomial(link="logit")) +modeloLg # imprime na tela o resultado da regressão logística +# Call:  glm(formula = sucesso ~ tempo,  +#	family = binomial(link = "logit"), data = lista1) +# +# Coefficients: +# (Intercept)        tempo   +#     0.17018     -0.01321   +#  +# Degrees of Freedom: 39 Total (i.e. Null);  38 Residual +# Null Deviance:	    55.35  +# Residual Deviance: 55.12 	 AIC: 59.12 +summary(modeloLg) # saída mais detalhada da regressão +# Call: +# glm(formula = sucesso ~ tempo,  +#	family = binomial(link = "logit"), data = lista1) + +# Deviance Residuals:  +#    Min      1Q  Median      3Q     Max   +# -1.245  -1.118  -1.035   1.202   1.327   +#  +# Coefficients: +#             Estimate Std. Error z value Pr(>|z|) +# (Intercept)  0.17018    0.64621   0.263    0.792 +# tempo       -0.01321    0.02757  -0.479    0.632 +#  +# (Dispersion parameter for binomial family taken to be 1) +# +#     Null deviance: 55.352  on 39  degrees of freedom +# Residual deviance: 55.121  on 38  degrees of freedom +# AIC: 59.121 +#  +# Number of Fisher Scoring iterations: 3 + + +######################### +# Gráficos +######################### + +# FUNÇÕES DE PLOTAGEM INTEGRADAS +# Gráficos de dispersão! +plot(lista1$tempo, lista1$preco, main = "dados falsos") +# Trace a linha de regressão em um gráfico existente! +abline(modeloLinear, col = "red") +# Obtenha uma variedade de diagnósticos legais +plot(modeloLinear) +# Histogramas! +hist(rpois(n = 10000, lambda = 5), col = "thistle") +# Gráficos de barras! +barplot(c(1,4,5,1,2), names.arg = c("red","blue","purple","green","yellow")) + +# GGPLOT2 +# Mas estes não são nem os mais bonitos dos gráficos no R +# Experimente o pacote ggplot2 para gráficos diferentes e mais bonitos +install.packages("ggplot2") +require(ggplot2) +?ggplot2 +pp <- ggplot(estudantes, aes(x=casa)) +pp + geom_bar() +ll <- as.data.table(lista1) +pp <- ggplot(ll, aes(x=tempo,preco)) +pp + geom_point() +# ggplot2 tem uma excelente documentação (disponível em http://docs.ggplot2.org/current/) + + + +``` + +## Como faço para obter R? + +* Obtenha o R e uma interface gráfica para o R em [http://www.r-project.org/](http://www.r-project.org/) +* [RStudio](http://www.rstudio.com/ide/) é uma outra interface gráfica diff --git a/pt-br/rust-pt.html.markdown b/pt-br/rust-pt.html.markdown index 3dd4a8d5..1080baa4 100644 --- a/pt-br/rust-pt.html.markdown +++ b/pt-br/rust-pt.html.markdown @@ -1,5 +1,5 @@  --- -language: rust +language: Rust  filename: rust-pt.rs  contributors:      - ["Paulo Henrique Rodrigues Pinheiro", "https://about.me/paulohrpinheiro"] diff --git a/pt-br/sql-pt.html.markdown b/pt-br/sql-pt.html.markdown new file mode 100644 index 00000000..0e4631a6 --- /dev/null +++ b/pt-br/sql-pt.html.markdown @@ -0,0 +1,119 @@ +--- +language: SQL +filename: learnsql-pt.sql +contributors: +  - ["Bob DuCharme", "http://bobdc.com/"] +translators: +  - ["jovinoguerrero", "https://github.com/jovinoguerrero"] +lang: pt-br +--- + +A linguagem de consulta estruturada (SQL em inglês) é uma linguagem padrão ISO para criar e trabalhar com bancos de dados armazenados num conjunto de tabelas. As implementações geralmente adicionam suas próprias extensões à linguagem; [Comparação entre diferentes implementações de SQL](http://troels.arvin.dk/db/rdbms/) é uma boa referência sobre as diferenças entre os diferentes produtos. + +As implementações normalmente fornecem uma linha de comando onde se pode digitar os comandos mostrados aqui de forma interativa, e também oferecem uma maneira de executar uma série desses comandos armazenados em um arquivo de script (mostrar que é feito com o prompt interativo é um bom exemplo de algo que não é padronizado - a maioria das implementações SQL suporta as palavras-chave QUIT, EXIT ou ambas). + +Vários desses comandos de exemplo assumem que o [banco de dados de funcionários de exemplo MySQL](https://dev.mysql.com/doc/employee/en/) disponível em [github](https://github.com/datacharmer/test_db) já foi carregado. Os arquivos do GitHub são scripts de comandos, semelhantes aos comandos abaixo, que criam e carregam tabelas de dados sobre os funcionários de uma empresa fictícia. A sintaxe para executar esses scripts dependerá da implementação SQL que você está usando. Um aplicativo executado a partir do prompt do sistema operacional geralmente é o normal. + + +```sql +-- Os comentários começam com dois hífens. Cada comando é encerrado com um +-- ponto e vírgula. + +-- SQL não diferencia maiúsculas de minúsculas em palavras-chave. Os +-- comandos de exemplo mostrados aqui seguem a convenção de serem escritos +-- em maiúsculas porque torna mais fácil distingui-los dos nomes dos bancos +-- de dados, tabelas e colunas. + +-- Em seguida, um banco de dados é criado e excluído. Os nomes do banco de +-- dados e da tabela são sensíveis a maiúsculas de minúsculas. +CREATE DATABASE someDatabase; +DROP DATABASE someDatabase; + +-- Mostra numa lista todos os bancos de dados disponíveis. +SHOW DATABASES; + +-- Usa um determinado banco de dados existente. +USE employees; + +-- Seleciona todas as filas e colunas da tabela de departamentos no banco +-- de dados atual. A atividade padrão é o intérprete rolar os resultados +-- na tela. +SELECT * FROM departments; + +-- Recupera todas as filas da tabela de departamentos, mas apenas as colunas +-- dept_no e dept_name. +-- A separação de comandos em várias linhas é permitida. +SELECT dept_no, +       dept_name FROM departments; + +-- Obtém todas as colunas de departments, mas é limitado a 5 filas. +SELECT * FROM departments LIMIT 5; + +-- Obtém os valores da coluna dept_name da tabela de departments quando +-- dept_name tem como valor a substring 'en'. +SELECT dept_name FROM departments WHERE dept_name LIKE '%en%'; + +-- Recupera todas as colunas da tabela de departments onde a coluna +-- dept_name começa com um 'S' e tem exatamente 4 caracteres depois dele. +SELECT * FROM departments WHERE dept_name LIKE 'S____'; + +-- Seleciona os valores dos títulos da tabela de titles, mas não mostra +-- duplicatas. +SELECT DISTINCT title FROM titles; + +-- Igual ao anterior, mas ordenado por valores de da coluna title (diferencia +-- maiúsculas de minúsculas). +SELECT DISTINCT title FROM titles ORDER BY title; + +-- Mostra o número de filas da tabela departments. +SELECT COUNT(*) FROM departments; + +-- Mostra o número de filas da tabela departments que contém 'en' como +-- substring na coluna dept_name. +SELECT COUNT(*) FROM departments WHERE dept_name LIKE '%en%'; + +-- Uma união (JOIN) de informações de várias tabelas: a tabela titles mostra +-- quem tem quais cargos laborais, de acordo com seu número de funcionários, +-- e desde que data até que data. Esta informação é obtida, mas em vez do +-- número do funcionário é usada como referência cruzada a tabela employee +-- para obter o nome e sobrenome de cada funcionário (e limita os resultados +--  a 10 filas). +SELECT employees.first_name, employees.last_name, +       titles.title, titles.from_date, titles.to_date +FROM titles INNER JOIN employees ON +       employees.emp_no = titles.emp_no LIMIT 10; + +-- São listadas todas as tabelas de todas os bancos de dados. As implementações +-- normalmente fornecem seus próprios comandos para fazer isso com o banco de +-- dados atualmente em uso. +SELECT * FROM INFORMATION_SCHEMA.TABLES +WHERE TABLE_TYPE='BASE TABLE'; + +-- Cria uma tabela chamada tablename1, com as duas colunas mostradas, a partir +-- do banco de dados em uso. Há muitas outras opções dísponiveis para a forma +-- em que se especificam as colunas, por ex. seus tipos de dados. +CREATE TABLE tablename1 (fname VARCHAR(20), lname VARCHAR(20)); + +-- Insere uma fila de dados na tabela tablename1. É assumido que a tabela foi +-- definida para aceitar esses valores como adequados. +INSERT INTO tablename1 VALUES('Richard','Mutt'); + +-- Em tablename1, se altera o valor de fname para 'John' em todas as filas que +-- contenham um valor em lname igual a 'Mutt'. +UPDATE tablename1 SET fname='John' WHERE lname='Mutt'; + +-- Se excluem as filas da tabela tablename1 em que o valor de lname começa +-- com 'M'. +DELETE FROM tablename1 WHERE lname like 'M%'; + +-- Se excluem as filas da tabela tablename1, deixando a tabla vazia. +DELETE FROM tablename1; + +-- A tabela tablename1, é excluída completamente. +DROP TABLE tablename1; +``` + +# Leitura adicional + +* [Codecademy - SQL](https://www.codecademy.com/learn/learn-sql) A good introduction to SQL in a “learn by doing it” format. +* [Database System Concepts](https://www.db-book.com/) book’s Chapter 3 - Introduction to SQL has an in depth explanation of SQL concepts. diff --git a/pt-br/tmux-pt.html.markdown b/pt-br/tmux-pt.html.markdown index ce3be407..e2130e0a 100644 --- a/pt-br/tmux-pt.html.markdown +++ b/pt-br/tmux-pt.html.markdown @@ -59,47 +59,49 @@ As seções tmux acopladas são controladas através de teclas de atalho. (prefi  ----------------------------------------------------------------------    (C-b) = Ctrl + b    # Abre a opção de receber comandos(atalhos). -  (M-1) = Meta + 1 -or- Alt + 1 +  (M-1) = Meta + 1 -ou- Alt + 1  ---------------------------------------------------------------------- -  ?           # Lista todos os comandos. -  :           # Acessa o prompt command do tmux -  r           # Força a reinicialização do cliente acoplado. -  c           # Cria uma nova janela. +  ?                  # Lista todos os comandos. +  :                  # Acessa o prompt command do tmux +  r                  # Força a reinicialização do cliente acoplado. +  c                  # Cria uma nova janela. -  !           # Retira o painel atual da janela. -  %           # Divide o painel atual em dois. Esquerda e direita. -  "           # Divide o painel atual em dois. Para cima e para baixo. +  !                  # Retira o painel atual da janela. +  %                  # Divide o painel atual em dois. Esquerda e direita. +  "                  # Divide o painel atual em dois. Para cima e para baixo. -  n           # Muda para a próxima janela. -  p           # Muda para a janela anterior. -  {           # Troca o painel atual pelo anterior. -  }           # Troca o painel corrent pelo posterior. +  n                  # Muda para a próxima janela. +  p                  # Muda para a janela anterior. +  {                  # Troca o painel atual pelo anterior. +  }                  # Troca o painel corrent pelo posterior. +  [                  # Entra no modo cópia (Copy Mode) para copiar texto ou ver o histórico. -  s           # Seleciona uma nova seção para o cliente acoplado iterativamente. -  w           # Seleciona a janela atual iterativamente. -  0 to 9      # Seleciona a janela de 0 à 9. -  d           # Separa o cliente atual. -  D           # Seleciona um cliente a ser separado. +  s                  # Seleciona uma nova seção para o cliente acoplado iterativamente. +  w                  # Seleciona a janela atual iterativamente. +  0 to 9             # Seleciona a janela de 0 à 9. -  &           # Encerra a janela atual. -  x           # Encerra o painel atual. +  d                  # Separa o cliente atual. +  D                  # Seleciona um cliente a ser separado. -  Up, Down    # Move para o painel acima, abaixo, a esquerda ou a direita. +  &                  # Encerra a janela atual. +  x                  # Encerra o painel atual. + +  Up, Down           # Move para o painel acima, abaixo, a esquerda ou a direita.    Left, Right -  M-1 to M-5  # Organiza os paines: +  M-1 to M-5         # Organiza os paines:                         # 1) Horizontalmente de maneira igual                         # 2) Verticalmente de maineira igual.                         # 3) Principal horizontalmente                         # 4) Principal verticamente.                         # 5) Mosaico -  C-Up, C-Down    # Altera o tamanho do painel atual em uma célula. +  C-Up, C-Down       # Altera o tamanho do painel atual em uma célula.    C-Left, C-Right -  M-Up, M-Down    # Altera o tamanho do painel atual em cinco células. +  M-Up, M-Down       # Altera o tamanho do painel atual em cinco células.    M-Left, M-Right  ``` diff --git a/pt-br/visualbasic-pt.html.markdown b/pt-br/visualbasic-pt.html.markdown index 2a7205cd..81292798 100644 --- a/pt-br/visualbasic-pt.html.markdown +++ b/pt-br/visualbasic-pt.html.markdown @@ -28,12 +28,12 @@ module Module1          Console.WriteLine ("2. Entrada Olá Mundo" )          Console.WriteLine ("3. Cálculando números inteiros " )          Console.WriteLine ("4. Calculando números decimais " ) -        Console.WriteLine ("5 . Calculadora de Trabalho " ) +        Console.WriteLine ("5. Calculadora de Trabalho " )          Console.WriteLine ("6. Usando Do While Loops " )          Console.WriteLine ("7. Usando Para While Loops " ) -        Console.WriteLine ("8 . Declarações condicionais " ) +        Console.WriteLine ("8. Declarações condicionais " )          Console.WriteLine ("9. Selecione uma bebida" ) -        Console.WriteLine ("50 . About" ) +        Console.WriteLine ("50. About" )          Console.WriteLine ("Por favor, escolha um número da lista acima " )          Seleção Dim As String = Console.ReadLine          Select A seleção dos casos @@ -76,7 +76,7 @@ module Module1      End Sub      ' Um - Eu estou usando números para ajudar com a navegação acima quando eu voltar -    ' depois de construí-lo . +    ' depois de construí-lo.      " Nós usamos subs privadas para separar diferentes seções do programa.      Private Sub HelloWorldOutput () @@ -94,12 +94,12 @@ module Module1          Console.Title = " Olá Mundo YourName | Saiba X em Y Minutes"          ' Variáveis          'Os dados inseridos por um usuário precisam ser armazenados. -        ' As variáveis também começar com um Dim e terminar com um Como VariableType . +        ' As variáveis também começar com um Dim e terminar com um Como VariableType.          ' Neste tutorial, nós queremos saber qual é o seu nome, e faça o programa          ' Responder ao que é dito.          Nome de usuário Dim As String -        " Nós usamos string como string é uma variável de texto baseado . +        " Nós usamos string como string é uma variável de texto baseado.          Console.WriteLine (" Olá, Qual é o seu nome? ") ' Peça ao usuário seu nome.          username = Console.ReadLine () ' armazena o nome do usuário.          Console.WriteLine (" Olá " + username) ' A saída é "Olá < seu nome >". @@ -124,10 +124,10 @@ module Module1      'Quatro      Sub CalculatingDecimalNumbers particulares ()          Console.Title = " Calculando com duplo | Saiba X em Y Minutes" -        ' Claro que gostaria de ser capaz de somar decimais . +        ' Claro que gostaria de ser capaz de somar decimais.          " Por isso, poderia mudar o acima de Integer para Double. -        " Digite um número inteiro , 1,2 , 2,4 , 50,1 , 104,9 ect +        " Digite um número inteiro como 1, 2, 50, 104, etc          Console.Write ("Primeiro número:")          Dim a As Double = Console.ReadLine          Console.Write ("Segundo número:") 'Enter segundo número inteiro. @@ -141,9 +141,9 @@ module Module1      ' Cinco      Private Sub WorkingCalculator ()          Console.Title = " A Calculadora de Trabalho | Saiba X em Y Minutes" -        " No entanto, se você gostaria que a calculadora para subtrair, dividir , múltiplos e +        " No entanto, se você gostaria que a calculadora para subtrair, dividir, múltiplos e          ' somar. -        ' Copie e cole o código acima novamente . +        ' Copie e cole o código acima novamente.          Console.Write ("Primeiro número:")          Dim a As Double = Console.ReadLine          Console.Write ("Segundo número:") 'Enter segundo número inteiro. @@ -153,7 +153,7 @@ module Module1          Dim e As Integer = a - b          Dim f As Integer = a / b -        " Ao adicionar as linhas abaixo , somos capazes de calcular a subtração , +        " Ao adicionar as linhas abaixo, somos capazes de calcular a subtração,          ' multply bem como dividir os valores de a e b          Console.Gravar ( a.ToString ( ) + " + " + b.ToString ( ) )          'Queremos pad as respostas para a esquerda por três espaços. @@ -172,8 +172,8 @@ module Module1      Sub UsingDoWhileLoops particulares ()          ' Assim como o sub privado anterior          ' Desta vez, perguntar se o usuário deseja continuar ( Sim ou Não ? ) -        ' Estamos usando Do While Loop , como não temos certeza se o usuário quer usar o -        'programa mais de uma vez . +        ' Estamos usando Do While Loop, como não temos certeza se o usuário quer usar o +        'programa mais de uma vez.          Console.Title = " UsingDoWhileLoops | Saiba X em Y Minutes"          Dim resposta As String ' Nós usamos a variável " String" como a resposta é um texto          Do ' Começamos o programa com @@ -195,12 +195,12 @@ module Module1              Console.Write ( a.ToString () + "/" + b.ToString ())              Console.WriteLine (" =" + e.ToString.PadLeft (3) )              Console.ReadLine () -            ' Faça a pergunta , se o usuário deseja continuar? Infelizmente, +            ' Faça a pergunta, se o usuário deseja continuar? Infelizmente,              "é sensível a maiúsculas.              Console.Write ( "Deseja continuar? (Sim / não )")              " O programa pega a variável e imprime e começa de novo.              answer = Console.ReadLine -        " O comando para a variável para trabalhar seria , neste caso, " sim " +        " O comando para a variável para trabalhar seria, neste caso, " sim "          Loop While resposta = "yes"      End Sub @@ -233,7 +233,7 @@ module Module1          outro              Console.WriteLine (" Olá " + nome do usuário)              Console.WriteLine (" Você check-out www.learnxinyminutes.com " ) -            Console.ReadLine () ' Fins e imprime a declaração acima . +            Console.ReadLine () ' Fins e imprime a declaração acima.          End If      End Sub @@ -242,15 +242,15 @@ module Module1      Console.Title = "Se Declaração / Else | Saiba X em Y Minutes"          'Às vezes é importante ter em conta mais de duas alternativas.          'Às vezes, há um bom número de outros. -        'Quando este for o caso , mais do que uma if seria necessária . -        'Uma instrução if é ótimo para máquinas de venda automática . Quando o usuário digita um código. -        ' A1 , A2, A3 , ect para selecionar um item. +        'Quando este for o caso, mais do que uma if seria necessária. +        'Uma instrução if é ótimo para máquinas de venda automática. Quando o usuário digita um código. +        ' A1, A2, A3, etc para selecionar um item.          'Todas as opções podem ser combinadas em uma única if.          Seleção Dim Valor String = Console.ReadLine ' para a seleção              Console.WriteLine (" A1. Para Soda " )              Console.WriteLine (" A2. Para Fanta " ) -            Console.WriteLine (" A3 . Para Guaraná" ) +            Console.WriteLine (" A3. Para Guaraná" )              Console.WriteLine (" A4. Para Coca Diet" )              Console.ReadLine ()              Se a seleção = "A1" Então diff --git a/pt-br/yaml-pt.html.markdown b/pt-br/yaml-pt.html.markdown index 21e9b4bb..b2fb2a7d 100644 --- a/pt-br/yaml-pt.html.markdown +++ b/pt-br/yaml-pt.html.markdown @@ -2,6 +2,7 @@  language: yaml  contributors:    - ["Leigh Brenecki", "https://github.com/adambrenecki"] +  - [Suhas SG, 'https://github.com/jargnar']  translators:    - ["Rodrigo Russo", "https://github.com/rodrigozrusso"]  filename: learnyaml-pt.yaml @@ -14,6 +15,8 @@ legível por seres humanos.  É um superconjunto de JSON, com a adição de identação e quebras de linhas sintaticamente significativas, como Python. Ao contrário de Python, entretanto, YAML não permite o caracter literal tab para identação.  ```yaml +---  # início do documento +  # Comentários em YAML são como este.  ################### @@ -30,28 +33,32 @@ boleano: true  valor_nulo: null  chave com espaco: valor  # Observe que strings não precisam de aspas. Porém, elas podem ter. -porem: "Uma string, entre aspas." -"Chaves podem estar entre aspas tambem.": "É útil se você quiser colocar um ':' na sua chave." +porem: 'Uma string, entre aspas.' +'Chaves podem estar entre aspas tambem.': "É útil se você quiser colocar um ':' na sua chave." +aspas simples: 'possuem ''um'' padrão de escape' +aspas duplas: "possuem vários: \", \0, \t, \u263A, \x0d\x0a == \r\n, e mais." +# Caracteres UTF-8/16/32 precisam ser codificados +Superscript dois: \u00B2  # Seqüências de várias linhas podem ser escritas como um 'bloco literal' (utilizando |),  # ou em um 'bloco compacto' (utilizando '>').  bloco_literal: | -    Todo esse bloco de texto será o valor da chave 'bloco_literal', -    preservando a quebra de com linhas. +  Todo esse bloco de texto será o valor da chave 'bloco_literal', +  preservando a quebra de com linhas. -    O literal continua até de-dented, e a primeira identação é  -    removida. +  O literal continua até 'des-indentar', e a primeira identação é  +  removida. -        Quaisquer linhas que são 'mais identadas' mantém o resto de suas identações -  -        estas linhas serão identadas com 4 espaços. +    Quaisquer linhas que são 'mais identadas' mantém o resto de suas identações -  +    estas linhas serão identadas com 4 espaços.  estilo_compacto: > -    Todo esse bloco de texto será o valor de 'estilo_compacto', mas esta -    vez, todas as novas linhas serão substituídas com espaço simples. +  Todo esse bloco de texto será o valor de 'estilo_compacto', mas esta +  vez, todas as novas linhas serão substituídas com espaço simples. -    Linhas em branco, como acima, são convertidas em um carater de nova linha. +  Linhas em branco, como acima, são convertidas em um carater de nova linha. -        Linhas 'mais-indentadas' mantém suas novas linhas também - -        este texto irá aparecer em duas linhas. +    Linhas 'mais-indentadas' mantém suas novas linhas também - +    este texto irá aparecer em duas linhas.  ####################  # TIPOS DE COLEÇÃO # @@ -59,54 +66,85 @@ estilo_compacto: >  # Texto aninhado é conseguido através de identação.  um_mapa_aninhado: -    chave: valor -    outra_chave: Outro valor -    outro_mapa_aninhado: -        ola: ola +  chave: valor +  outra_chave: Outro valor +  outro_mapa_aninhado: +    ola: ola  # Mapas não tem que ter chaves com string.  0.25: uma chave com valor flutuante -# As chaves podem ser também objetos multi linhas, utilizando ? para indicar o começo de uma chave. +# As chaves podem ser complexas, como sequência de várias linhas +# Utilizando ? seguido por espaço para indicar o começo de uma chave complexa.  ? | -    Esta é uma chave -    que tem várias linhas +  Esta é uma chave +  que tem várias linhas  : e este é o seu valor -# também permite tipos de coleção de chaves, mas muitas linguagens de programação -# vão reclamar. +# YAML também permite o mapeamento entre sequências com a sintaxe chave complexa +# Alguns analisadores de linguagem de programação podem reclamar +# Um exemplo +? - Manchester United +  - Real Madrid +: [2001-01-01, 2002-02-02]  # Sequências (equivalente a listas ou arrays) semelhante a isso:  uma_sequencia: -    - Item 1 -    - Item 2 -    - 0.5 # sequencias podem conter tipos diferentes. -    - Item 4 -    - chave: valor -      outra_chave: outro_valor -    - -        - Esta é uma sequencia -        - dentro de outra sequencia +  - Item 1 +  - Item 2 +  - 0.5 # sequências podem conter tipos diferentes. +  - Item 4 +  - chave: valor +    outra_chave: outro_valor +  - +    - Esta é uma sequência +    - dentro de outra sequência +  - - - Indicadores de sequência aninhadas +      - podem ser recolhidas  # Como YAML é um super conjunto de JSON, você também pode escrever mapas JSON de estilo e -# sequencias: +# sequências:  mapa_json: {"chave": "valor"}  json_seq: [3, 2, 1, "decolar"] +e aspas são opcionais: {chave: [3, 2, 1, decolar]} -########################## -# RECURSOS EXTRA DO YAML # -########################## +########################### +# RECURSOS EXTRAS DO YAML # +###########################  # YAML também tem um recurso útil chamado "âncoras", que permitem que você facilmente duplique  # conteúdo em seu documento. Ambas estas chaves terão o mesmo valor: -conteudo_ancora: & nome_ancora Essa string irá aparecer como o valor de duas chaves. -outra_ancora: * nome_ancora +conteudo_ancora: &nome_ancora Essa string irá aparecer como o valor de duas chaves. +outra_ancora: *nome_ancora + +# Âncoras podem ser usadas para dubplicar/herdar propriedades +base: &base +  name: Todos possuem o mesmo nome + +# O regexp << é chamado Mesclar o Tipo Chave Independente-de-Idioma. É usado para +# indicar que todas as chaves de um ou mais mapas específicos devam ser inseridos +# no mapa atual. + +foo: +  <<: *base +  idade: 10 + +bar: +  <<: *base +  idade: 20 + +# foo e bar terão o mesmo nome: Todos possuem o mesmo nome  # YAML também tem tags, que você pode usar para declarar explicitamente os tipos. -string_explicita: !! str 0,5 +string_explicita: !!str 0.5  # Alguns analisadores implementam tags específicas de linguagem, como este para Python de  # Tipo de número complexo. -numero_complexo_em_python: !! python / complex 1 + 2j +numero_complexo_em_python: !!python/complex 1+2j + +# Podemos utilizar chaves YAML complexas com tags específicas de linguagem +? !!python/tuple [5, 7] +: Fifty Seven +# Seria {(5, 7): 'Fifty Seven'} em Python  ####################  # YAML TIPOS EXTRA # @@ -114,27 +152,34 @@ numero_complexo_em_python: !! python / complex 1 + 2j  # Strings e números não são os únicos que escalares YAML pode entender.  # Data e 'data e hora' literais no formato ISO também são analisados. -datetime: 2001-12-15T02: 59: 43.1Z -datetime_com_espacos 2001/12/14: 21: 59: 43.10 -5 -Data: 2002/12/14 +datetime: 2001-12-15T02:59:43.1Z +datetime_com_espaços: 2001-12-14 21:59:43.10 -5 +date: 2002-12-14  # A tag !!binary indica que a string é na verdade um base64-encoded (codificado)  # representação de um blob binário.  gif_file: !!binary | -    R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5 -    OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+ -    +f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC -    AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs= +  R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5 +  OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+ +  +f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC +  AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=  # YAML também tem um tipo de conjunto, o que se parece com isso: -set: -    ? item1 -    ? item2 -    ? item3 - -# Como Python, são apenas conjuntos de mapas com valors nulos; o acima é equivalente a: -set2: -    item1: nulo -    item2: nulo -    item3: nulo +conjunto: +  ? item1 +  ? item2 +  ? item3 +ou: {item1, item2, item3} + +# Como Python, são apenas conjuntos de mapas com valores nulos; o acima é equivalente a: +conjunto2: +  item1: null +  item2: null +  item3: null + +...  # fim do documento  ``` +### Mais Recursos + ++ [Site Oficial do YAML](https://yaml.org/) ++ [Validador YAML Online](http://www.yamllint.com/)  | 
