lostecho/build-web-application-with-golang
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Finished the translation of Chapter 1

Browse Source
This commit is contained in:
James Miranda
2016-09-21 18:04:39 -03:00
committed by James Miranda
parent 9378668922
commit 005c584a05
3 changed files with 131 additions and 134 deletions
Download Patch File Download Diff File Expand all files Collapse all files

249
pt-br/01.4.md
View File

@@ -43,26 +43,26 @@ Recursos do LiteIDE.
- CSS customizado
- Exportação para PDF e HTML
- Conversão para PDF e HTML
### Instalação do LiteIDE
- Instale o LiteIDE
- [Página de Download](http://code.google.com/p/golangide)
- [Código Fonte](https://github.com/visualfc/liteide)
Você precisa instalar Go primeiro (conforme a seção 1.1), depois faça o download da versão do LiteIDE mais apropriada para o seu sistema. Apenas descompacte e use diretamente.
- Instale o gocode
Você precisa instalar o gocode para poder usar o auto-complete inteligente.
go get -u github.com/nsf/gocode
- Ambiente de compilação
Troque a configureguração no LiteIDE para configura-lo corretamente para o seu sistema operacional.
Por exemplo, no Windows e usando a versão 64-bit da linguagem Go, você deve escolher win64 como ambiente de configuração na barra de ferramentas. Escolha `opinion`, encontre `LiteEnv` e na lista esquerda, abro o arquivo `win64.env`. Ele deve ser parecido como modelo a seguir.
GOROOT=c:\go
GOBIN=
GOARCH=amd64
@@ -71,11 +71,11 @@ Recursos do LiteIDE.
PATH=%GOBIN%;%GOROOT%\bin;%PATH%
。。。
Substitua `GOROOT=c:\go` para o caminho de instalação configurado anteriormente, salve o arquivo. Para ter suporte completo ao `cgo`, você precisar ter instalado o MinGW64 e deve adicionar `c:\MinGW64\bin` a a sua variável de ambiente.
No Linux, usando uma versão 64-bit da linguagem Go, você deve escolher linux64 como configuração de ambiente na barra de ferramentas. Em seguida, escolha `opinion`, encontre `LiteEnv` no menu a esquerda e abra o arquivo `linux64.env`. Edite-o conforme segue.
GOROOT=$HOME/go
GOBIN=
GOARCH=amd64
@@ -84,14 +84,14 @@ Recursos do LiteIDE.
PATH=$GOBIN:$GOROOT/bin:$PATH
。。。
Substitua `GOROOT=$HOME/go` para o caminho da sua instalação, salve o arquivo.
- $GOPATH
$GOPATH é o caminho do diretório que contém seus projetos Go. Abra a linha de comando (ou apenas use ``Ctrl+` ``no LiteIDE) e então digite `go help gopath` para maiores detalhes.
É bastante fácil visualizar e alterar a variável $GOPATH no LiteIDE. Use o menu `View - Setup GOPATH` para visualizar e alterar esses valores.
## Sublime Text
Nesse ponto, iremos introduzir o Sublime Text (ou apenas Sublime) + GoSublime + gocode + MarGo. Vamos lá.
@@ -99,16 +99,16 @@ Nesse ponto, iremos introduzir o Sublime Text (ou apenas Sublime) + GoSublime +
- Auto-complete inteligente
![](images/1.4.sublime1.png?raw=true)
Figura 1.5 Auto-complete inteligente no Sublime
- Formatação automática
- Gerenciamento de Projetos
![](images/1.4.sublime2.png?raw=true)
Figura 1.6 Gerenciamento de Projetos no Sublime
- Destaque de sintaxe (Syntax highlight)
- A versão trial é gratuita para sempre sem nenhuma limitação nas funções. Você será lembrado em algumas ocasiões com um prompt solicitando a compra da licença, mas você pode ignorpa-lo, se assim quiser. Claro, se você considerar que o editor melhora sua produtividade e você gostar realmente do produto, considere adquirir uma licença e ajudar a manter o desenvolvimento do produto!
@@ -117,49 +117,49 @@ Primeiro, faça o download da versão apropriada do [Sublime](http://www.sublime
1. Pressione ``Ctrl+` ``, abra a linha de comando e insera o seguintes comandos:
import urllib2,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); os.makedirs(ipp) if not os.path.exists(ipp) else None; urllib2.install_opener(urllib2.build_opener(urllib2.ProxyHandler())); open(os.path.join(ipp,pf),'wb').write(urllib2.urlopen('http://sublime.wbond.net/'+pf.replace(' ','%20')).read()); print 'Please restart Sublime Text to finish installation'
Reinicie o Sublime Text para finalizar a instalação. Você deverá encontrar uma opção `Package Control` no menu "Preferences".
![](images/1.4.sublime3.png?raw=true)
Figura 1.7 Sublime Package Control
2. To install GoSublime, SidebarEnhancements and Go Build, press `Ctrl+Shift+p` to open Package Control, then type `pcip` (short for "Package Control: Install Package").
2. Para instalar o GoSublime, SidebarEnhancements e Go Build, pressione `Ctrl+Shift+p` para abrir o Package Control e então digite `pcip` (um atalho para "Package Control: Install Package").
![](images/1.4.sublime4.png?raw=true)
Figure 1.8 Sublime Install Packages
Now type in "GoSublime", press OK to install the package, and repeat the same steps for installing SidebarEnhancements and Go Build. Once again, restart the editor when it completes the installation.
3. To verify that the installation is successful, open Sublime, then open the `main.go` file to see if it has the proper syntax highlighting. Type `import` to see if code completion prompts appear. After typing `import "fmt"`, type `fmt.` anywhere after the `import` declaration to see whether or not intelligent code completion for functions was successfully enabled.
If everything is fine, you're all set.
If not, check your $PATH again. Open a terminal, type `gocode`. If it does not run, your $PATH was not configured correctly.
Figure 1.8 Instalando pacotes no Sublime
Busque por "GoSublime", pressione OK para instalar o pacote e repita o mesmo procedimento para instalar os pacotes SidebarEnhancements e Go Build. Mais uma vez, reinicie o editor para completar a instalação.
3. Para verificar se a instalação foi bem sucedida, abra o arquivo `main.go` no Sublime e veja se ele está destacando a sintaxe corretamente. Digite `import` e confira se aparece um prompt com sugestões de auto-complete. Inclua `import "fmt"` e em seguida insira `fmt.` em qualquer lugar depois da declaração de `import` para verificar se a função de auto-complete inteligente está corretamente ativada.
Se funcionar corretamente, está tudo pronto.
Se não funcionar, verifique seu $PATH novamente. Abra um terminal e digite `gocode`. Se mesmo isto não funcionar, possivelmente seu $PATH não deve estar corretamente configurado.
## Vim
Vim is a popular text editor for programmers, which evolved from its slimmer predecessor, Vi. It has functions for intelligent completion, compilation and jumping to errors.
Vim é um popular editor de textos para programadores que evolui de seu predecessor mais simples, chamado Vi. Ele possui funções para auto-complete inteligente, compilação e também funções para iterar sobre os erros.
![](images/1.4.vim.png?raw=true)
Figure 1.8 Vim intelligent completion for Go
1. Syntax highlighting for Go
Figure 1.8 Auto-complete inteligente para Go no Vim
1. Primeiramente, copie as configurações padrão para o seu diretório de configuração do Vim
cp -r $GOROOT/misc/vim/* ~/.vim/
2. Enabling syntax highlighting
2. Ative o destaque de sintaxe (syntax highlighting)
filetype plugin indent on
syntax on
3. Install [gocode](https://github.com/nsf/gocode/)
3. Instale o [gocode](https://github.com/nsf/gocode/)
go get -u github.com/nsf/gocode
gocode will be installed in `$GOBIN` as default
4. Configure [gocode](https://github.com/nsf/gocode/)
O gocode será instalado em `$GOBIN` por padrão
4. Configure o [gocode](https://github.com/nsf/gocode/) digitando os comandos abaixo
~ cd $GOPATH/src/github.com/nsf/gocode/vim
~ ./update.bash
@@ -170,32 +170,32 @@ Figure 1.8 Vim intelligent completion for Go
~ gocode set
propose-builtins true
lib-path "/home/border/gocode/pkg/linux_amd64"
Explanation of gocode configuration:
propose-builtins: specifies whether or not to open intelligent completion; false by default.
lib-path: gocode only searches for packages in `$GOPATH/pkg/$GOOS_$GOARCH` and `$GOROOT/pkg/$GOOS_$GOARCH`. This setting can be used to add additional paths.
5. Congratulations! Try `:e main.go` to experience the world of Go!
Explicações sobre a configuração do gocode:
propose-builtins: determina se deve ou não ligar o auto-complete inteligente; false por padrão.
lib-path: Por padrão, o gocode apenas busca por pacotes em `$GOPATH/pkg/$GOOS_$GOARCH` e `$GOROOT/pkg/$GOOS_$GOARCH`. Esta configuração é usada para adicionar novos diretórios como fonte.
5. Parabéns! Tente digitar `:e main.go` no modo de comandos do Vim para experimentar o mundo de Go!
## Emacs
Emacs is the so-called Weapon of God. She is not only an editor, but also a powerful IDE.
Emacs (também conhecida como Arma de Deus) não é apenas um editor, mas também uma poderosa IDE.
![](images/1.4.emacs.png?raw=true)
Figure 1.10 Emacs main panel of Go editor
Figure 1.10 Painel principal do Emacs para editor Go
1. Primeiramente, copie as configurações padrão para o seu diretório de configuração da Emacs
1. Syntax highlighting
cp $GOROOT/misc/emacs/* ~/.emacs.d/
2. Install [gocode](https://github.com/nsf/gocode/)
2. Instale o [gocode](https://github.com/nsf/gocode/)
go get -u github.com/nsf/gocode
gocode will be installed in `$GOBIN` as default
3. Configure [gocode](https://github.com/nsf/gocode/)
O gocode será instalado em `$GOBIN` por padrão
3. Configure o [gocode](https://github.com/nsf/gocode/) digitando os comandos abaixo
~ cd $GOPATH/src/github.com/nsf/gocode/vim
~ ./update.bash
@@ -206,24 +206,24 @@ Figure 1.10 Emacs main panel of Go editor
~ gocode set
propose-builtins true
lib-path "/home/border/gocode/pkg/linux_amd64"
4. Install [Auto Completion](http://www.emacswiki.org/emacs/AutoComplete)
Download and uncompress
4. Instale o [Auto Completion](http://www.emacswiki.org/emacs/AutoComplete)
Faça o download, descompacte e execute
~ make install DIR=$HOME/.emacs.d/auto-complete
Configure ~/.emacs file
Configure o arquivo ~/.emacs conforme abaixo
;;auto-complete
(require 'auto-complete-config)
(add-to-list 'ac-dictionary-directories "~/.emacs.d/auto-complete/ac-dict")
(ac-config-default)
(local-set-key (kbd "M-/") 'semantic-complete-analyze-inline)
(local-set-key "." 'semantic-complete-self-insert)
(local-set-key ">" 'semantic-complete-self-insert)
Follow this [link](http://www.emacswiki.org/emacs/AutoComplete) for more details.
5. Configure .emacs
(local-set-key ">" 'semantic-complete-self-insert)
Veja este [link](http://www.emacswiki.org/emacs/AutoComplete) para maiores detalhes desse processo.
5. Finalize a configuração do arquivo .emacs para usar Go
;; golang mode
(require 'go-mode-load)
@@ -309,95 +309,90 @@ Figure 1.10 Emacs main panel of Go editor
(interactive)
(show-all)
(shell-command-on-region (point-min) (point-max) "go tool fix -diff"))
6. Congratulations, you're done! Speedbar is closed by default -remove the comment symbols in the line `;;(speedbar 1)` to enable this feature, or you can use it through `M-x speedbar`.
6. Parabéns, está tudo pronto! O Speedbar está desativado por padrão, mas remova os símbolos de comentário na linha `;;(speedbar 1)` para ativar esse recurso, ou ainda use o comando `M-x speedbar` com a mesma finalidade.
## Eclipse
Eclipse is also a great development tool. I'll show you how to use it to write Go programs.
O Eclipse é outra excelente ferrramenta de desenvolvimento. Veja como usá-la para programar em Go.
![](images/1.4.eclipse1.png?raw=true)
Figure 1.1 Eclipse main panel for editing Go
Figure 1.1 Painel principal do Eclipse para Go
1. Download and install [Eclipse](http://www.eclipse.org/)
2. Download [goclipse](https://code.google.com/p/goclipse/)
[http://code.google.com/p/goclipse/wiki/InstallationInstructions](http://code.google.com/p/goclipse/wiki/InstallationInstructions)
3. Download gocode
1. Faça o download e instale o [Eclipse](http://www.eclipse.org/)
2. Faça o download do [goclipse](https://code.google.com/p/goclipse/) e instale seguindo as instrução nesse [link](http://code.google.com/p/goclipse/wiki/InstallationInstructions)
3. Faça o download do [gocode](https://github.com/nsf/gocode)
Se você estiver usando no Windows, você deve instalar o git para Windows para poder instalar o gocode. Uma opção bastante usada para este fim é usar o [msysgit](https://code.google.com/p/msysgit/)
Instale pela linha de comando
gocode in Github.
https://github.com/nsf/gocode
You need to install git in Windows, usually we use [msysgit](https://code.google.com/p/msysgit/)
Install gocode in the command tool
go get -u github.com/nsf/gocode
You can install from source code if you like.
4. Download and install [MinGW](http://sourceforge.net/projects/mingw/files/MinGW/)
5. Configure plugins.
Ou ainda instale diretamente pelo código-fonte se preferir.
4. Faça o download e instale o [MinGW](http://sourceforge.net/projects/mingw/files/MinGW/)
5. Configure os plugins.
Windows->Preferences->Go
(1).Configure Go compiler
![](images/1.4.eclipse2.png?raw=true)
Figure 1.12 Go Setting in Eclipse
(2).Configure gocode(optional), set gocode path to where the gocode.exe is.
![](images/1.4.eclipse3.png?raw=true)
Figure 1.13 gocode Setting
(3).Configure gdb(optional), set gdb path to where the gdb.exe is.
![](images/1.4.eclipse4.png?raw=true)
Figure 1.14 gdb Setting
6. Check the installation
Create a new Go project and hello.go file as following.
(1).Configure o compilador Go
![](images/1.4.eclipse2.png?raw=true)
Figure 1.12 Configuração Go no Eclipse
(2).Configure o gocode(opcional), usando o diretório onde você o instalou (gocode.exe)
![](images/1.4.eclipse3.png?raw=true)
Figure 1.13 Configuração do gocode
(3).Configure o gdb(opcional), usando o diretório onde você o instalou (gdb.exe).
![](images/1.4.eclipse4.png?raw=true)
Figure 1.14 Configuração do gdb
6. Verifique a instalação
Crie um novo projeto Go e um novo arquivo hello.go conforme segue.
![](images/1.4.eclipse5.png?raw=true)
Figure 1.15 Create a new project and file
Test installation as follows.(you need to type command in console in Eclipse)
Figure 1.15 Criar novo projeto e arquivo hello.go
Teste a instalação conforme abaixo.(você precisará digitar um comando no console do Eclipse)
![](images/1.4.eclipse6.png?raw=true)
Figure 1.16 Test Go program in Eclipse
Figure 1.16 Teste de um programa Go no Eclipse
## IntelliJ IDEA
People who have worked with Java should be familiar with this IDE. It supports Go syntax highlighting and intelligent code completion, implemented by a plugin.
As pessoas que trabalham com Java tem familiaridade com esta IDE. Ela também suporta a sintaxe para linguagem Go e auto-complete inteligente através de um plugin.
1. Download IDEA, there is no difference between the Ultimate and Community editions
1. Faça o download da IDEA, não há diferença entre as versões Ultimate e Community para uso com Go
![](images/1.4.idea1.png?raw=true)
2. Install the Go plugin. Choose `File - Setting - Plugins`, then click `Browser repo`.
2. Instale o Go plugin. Selecione `File - Setting - Plugins`, e então clique em `Browser repo`.
![](images/1.4.idea3.png?raw=true)
3. Search `golang`, double click `download and install` and wait for the download to complete.
3. Procure por `golang`, duplo-clique em `download and install` e aguarde a finalização do download.
![](images/1.4.idea4.png?raw=true)
Click `Apply`, then restart.
4. Now you can create a Go project.
Clique em `Apply` e reinicie a IDE.
4. Agora você está apto para criar um projeto Go.
![](images/1.4.idea5.png?raw=true)
Input the position of your Go sdk in the next step -basically it's your $GOROOT.
( ***See a [blog post](http://wuwen.org/tips-about-using-intellij-idea-and-go/) for setup and use IntelliJ IDEA with Go step by step *** )
Se for solicitado o caminho para o seu sdk Go em alguma etapa, apenas insira o caminho para seu $GOROOT.
( ***Veja este [post](http://wuwen.org/tips-about-using-intellij-idea-and-go/) para um passo-a-passo de configuração e uso da IntelliJ IDEA com a linguagem Go*** )
## Links
- [Directory](preface.md)
- Previous section: [Go commands](01.3.md)
- Next section: [Summary](01.5.md)
- [Sumário](preface.md)
- Sessão anterior: [Comandos Go](01.3.md)
- Próxima sessão: [Resumo](01.5.md)

12
pt-br/01.5.md
View File

@@ -1,9 +1,11 @@
# 1.5 Summary
# 1.5 Resumo
In this chapter, we talked about how to install Go using three different methods including from source code, the standard package and via third-party tools. Then we showed you how to configure the Go development environment, mainly covering how to setup your `$GOPATH`. After that, we introduced some steps for compiling and deploying Go programs. We then covered Go commands, including the compile, install, format and test commands. Finally, there are many powerful tools to develop Go programs such as LiteIDE, Sublime Text, Vim, Emacs, Eclipse, IntelliJ IDEA, etc. You can choose any one you like exploring the world of Go.
Neste capítulo, nós falamos sobre a instalação da linguagem Go usando três métodos diferentes, incluindo diretaente do código-fonte, pelo pacote padrão e através de ferramentas de terceiros.
Na sequência mostramos como configurar o ambiente de desenvolvimento para Go, cobrindo desde a configuração do `$GOPATH`. Depois disso, foram introduzidos alguns passos para compilação e desenvolvimento de programas Go e cobrimos os Comandos Go, incluindo os comandos compile, install, format e test.
Finalmente, foram apresentadas diversas ferramentas poderosas para o desenvolvimento de programas Go, tais como LiteIDE, Sublime Text, Vim, Emacs, Eclipse, IntelliJ IDEA, etc. Você pode escolher qualquer uma delas para explorar o mundo de Go.
## Links
- [Directory](preface.md)
- Previous section: [Go development tools](01.4.md)
- Next chapter: [Go basic knowledge](02.0.md)
- [Sumário](preface.md)
- Sessão anterior: [Ferramentas de desenvolvimento Go](01.4.md)
- Próxima sessão: [Conhecimento básico de Go](02.0.md)

4
pt-br/02.0.md
View File

@@ -1,4 +1,4 @@
# 2 Go basic knowledge
# 2 Conhecimento básico de Go
Go is a compiled system programming language, and it belongs to the C-family. However, its compilation speed is much faster than other C-family languages. It has only 25 keywords... even less than the 26 letters of the English alphabet! Let's take a look at these keywords before we get started.
@@ -7,7 +7,7 @@ Go is a compiled system programming language, and it belongs to the C-family. Ho
chan else goto package switch
const fallthrough if range type
continue for import return var
In this chapter, I'm going to teach you some basic Go knowledge. You will find out how concise the Go programming language is, and the beautiful design of the language. Programming can be very fun in Go. After we complete this chapter, you'll be familiar with the above keywords.
## Links