Skip to content

Commit

Permalink
add portuguese translation (#96)
Browse files Browse the repository at this point in the history
  • Loading branch information
kassane authored Jan 15, 2021
1 parent 72de571 commit 369d4a3
Show file tree
Hide file tree
Showing 13 changed files with 1,235 additions and 0 deletions.
2 changes: 2 additions & 0 deletions config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -49,3 +49,5 @@ DefaultContentLanguage = "en"
weight = 1
[languages.it]
weight = 2
[languages.pt]
weight = 2
152 changes: 152 additions & 0 deletions content/_index.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,152 @@
---
title: Página Inicial
mobile_menu_title: "Inicial"
---
{{< slogan get_started="COMECE AGORA" docs="Documentação" notes="Mudanças" lang="pt">}}
Zig é uma linguagem de programação de propósito geral e um conjunto de ferramentas para manter o seu software **robusto**, **otimizado**, e **usável**.
{{< /slogan >}}

{{< flexrow class="container" style="padding: 20px 0; justify-content: space-between;" >}}
{{% div class="features" %}}

# ⚡ Uma linguagem simples
Concentre-se na depuração de sua aplicação em vez de depurar seus conhecimentos em uma linguagem de programação.

- Sem fluxos de controle ocultas.
- Sem alocações de memórias ocultas.
- Sem preprocessador, nem macros.

# ⚡ Tempo de Compilação (Comptime)
Uma nova abordagem de metaprogramação baseada na execução do código em tempo de compilação e avaliação preguiçosa.

- Chame qualquer função em tempo de compilação.
- Manipular tipos como valores sem sobrecarga de tempo de execução.
- O Comptime emula a arquitetura de saida.

# ⚡ Desempenho que se enquadra na segurança
Escreva um código rápido e claro, capaz de lidar com todas as condições de erro.

- A linguagem guia graciosamente sua lógica de tratamento de erros.
- As verificações configuráveis de tempo de execução ajudam a encontrar um equilíbrio entre desempenho e garantias de segurança.
- Aproveite os tipos vetoriais para expressar as instruções SIMD de forma portátil.

{{% flexrow style="justify-content:center;" %}}
{{% div %}}
<h1>
<a href="{{< ref path="learn/overview.md">}}" class="button" style="display: inline;">Visão Geral</a>
</h1>
{{% /div %}}
{{% div style="margin-left: 5px;" %}}
<h1>
<a href="{{< ref path="learn/samples.md">}}" class="button" style="display: inline;">Mais exemplos de código</a>
</h1>
{{% /div %}}
{{% /flexrow %}}
{{% /div %}}
{{< div class="codesample" >}}

{{% zigdoctest "assets/zig-code/index.zig" %}}

{{< /div >}}
{{< /flexrow >}}


{{% div class="alt-background" %}}
{{% div class="container" style="display:flex;flex-direction:column;justify-content:center;text-align:center; padding: 20px 0;" title="Community" %}}

{{< flexrow class="container" style="justify-content: center;" >}}
{{% div style="width:25%" %}}
<img src="https://github.com/raw/ziglang/logo/master/ziggy.svg" style="max-height: 200px">
{{% /div %}}

{{% div class="community-message" %}}
# A comunidade Zig é descentralizada
Qualquer pessoa é livre para começar e manter seu próprio espaço para que a comunidade se reúna.
Não existe o conceito de "oficial" ou "não-oficial", entretanto, cada local de reunião tem seus próprios moderadores e regras.

<div style="">
<h1>
<a href="https://github.com/ziglang/zig/wiki/Community" class="button" style="display: inline;">Veja todas as comunidades</a>
</h1>
</div>
{{% /div %}}
{{< /flexrow >}}
<div style="height: 50px;"></div>

{{< flexrow class="container" style="justify-content: center;" >}}
{{% div class="main-development-message" %}}
# Principal desenvolvimento
O repositório Zig pode ser encontrado em [https://github.com/ziglang/zig](https://github.com/ziglang/zig), onde também discutimos sobre os problemas e propostas.
Espera-se que os contribuidores sigam o Zig [Código de Conduta](https://github.com/ziglang/zig/blob/master/CODE_OF_CONDUCT.md).
{{% /div %}}
{{% div style="width:40%" %}}
<img src="https://github.com/raw/ziglang/logo/master/zero.svg" style="max-height: 200px">
{{% /div %}}
{{< /flexrow >}}
{{% /div %}}
{{% /div %}}


{{% div class="container" style="display:flex;flex-direction:column;justify-content:center;text-align:center; padding: 20px 0;" title="Zig Software Foundation" %}}
## A ZSF é uma corporação 501(c)(3) sem fins lucrativos.

A Zig Software Foundation é uma corporação sem fins lucrativos fundada em 2020 por Andrew Kelley, o criador do Zig, com o objetivo de apoiar o desenvolvimento da linguagem. Atualmente, a ZSF é capaz de oferecer trabalho remunerado a taxas competitivas para um pequeno número de colaboradores principais. Esperamos ser capazes de estender esta oferta a mais colaboradores centrais no futuro.

A Zig Software Foundation é sustentada por doações.

<h1>
<a href="zsf/" class="button" style="display:inline;">Mais informações</a>
</h1>
{{% /div %}}


{{< div class="alt-background" style="padding: 20px 0;">}}
{{% div class="container" title="Sponsors" %}}
# Patrocinadores corporativos
As seguintes empresas estão fornecendo suporte financeiro direto para a Zig Software Foundation.

{{% sponsor-logos "monetary" %}}
<a href="https://pex.com" rel="noopener nofollow" target="_blank"><picture>
<picture>
<source srcset="/pex-white.svg" media="(prefers-color-scheme: dark)">
<img src="/pex-dark.svg">
</picture>
</a>
{{% /sponsor-logos %}}

# Patrocinadores GitHub
Graças a pessoas que [Patrocine Zig](zsf/), o projeto é responsável perante a comunidade de código aberto e não perante os acionistas corporativos. Em particular, essas pessoas de boa reputação patrocinam o Zig por US$ 200/mês ou mais:

- [Karrick McDermott](https://github.com/karrick)
- [Raph Levien](https://raphlinus.github.io/)
- [ryanworl](https://github.com/ryanworl)
- [Stevie Hryciw](https://www.hryx.net/)
- [Josh Wolfe](https://github.com/thejoshwolfe)
- [SkunkWerks, GmbH](https://skunkwerks.at/)
- [drfuchs](https://github.com/drfuchs)
- Eleanor Bartle

Esta seção é atualizada no início de cada mês.
{{% /div %}}
{{< /div >}}





















6 changes: 6 additions & 0 deletions content/download/_index.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: "Baixar"
menu_title: "Baixar"
mobile_menu_title: "Baixar"
layout: downloads
---
56 changes: 56 additions & 0 deletions content/learn/_index.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: "Aprender"
menu_title: "Aprender"
mobile_menu_title: "Aprender"
toc: false
layout: single
---

# Aprender
Esta seção lista recursos úteis para ir desde não saber nada sobre Zig até a compreensão de sua filosofia.

## Introdução
Todas estas páginas são introduções ao Zig destinadas a programadores com diferentes formações.

- [Visão Geral](overview/)
Aqui está uma visão aprofundada do Zig do ponto de vista da programação de sistemas.
- [Por que Zig quando já existe C++, D, e Rust?](why_zig_rust_d_cpp/)
Uma introdução a Zig para programadores de C++, D, e Rust.
- [Exemplos de Código](samples/)
Uma lista de trechos para ter uma idéia de como o código Zig se parece.
- [Ferramentas](tools/)
Uma lista de ferramentas úteis que podem ajudá-lo a escrever o código Zig.


## Começando
Se você estiver pronto para começar a programar em Zig, este guia o ajudará a configurar seu ambiente.

- [Comece Agora]({{< ref "getting-started.md" >}})

## Recursos de aprendizado online
- [Zig Learn](https://ziglearn.org)
Uma introdução estruturada ao Zig, por [Sobeston](https://github.com/sobeston).

## Vídeos e posts relevantes no blog
- [Zig a caminho do 1.0 (inglês)](https://www.youtube.com/watch?v=Gv2I7qTux7g) [video]
Vídeo de [Andrew Kelley](https://andrewkelley.me) apresentando Zig e sua filosofia.
- [Nova relação de Zig com a LLVM (inglês)](https://kristoff.it/blog/zig-new-relationship-llvm/)
Um post no blog sobre o trabalho para a compilação do compilador auto-hospedado Zig, também apresentado em [um artigo no lwn.net (inglês)](https://lwn.net/Articles/833400/).


















141 changes: 141 additions & 0 deletions content/learn/getting-started.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,141 @@
---
title: Começando
mobile_menu_title: "Começando"
toc: true
---

{{% div class="box thin"%}}
**<center>Nota para usuários do Apple Silicon</center>**
Zig tem suporte experimental para a assinatura de códigos. Você poderá usar Zig com seu M1 Mac,
mas a única maneira de conseguir Zig para macOS em ARM64 é compilá-lo você mesmo.
Certifique-se de verificar a seção [Compilando da Fonte](#compilando-da-fonte).
{{% /div %}}


## Marcar (Tags) as versões de lançamento e nightly?
Zig ainda não atingiu a v1.0 e o atual ciclo de liberação está ligado a novas liberações de LLVM, que têm uma cadência de ~6 meses.
Em termos práticos, **As versões Zig tendem a ser muito distantes e eventualmente se tornam obsoletas, dada a velocidade atual de desenvolvimento**.

É bom avaliar o Zig usando uma versão com tags, mas se você decidir que gosta do Zig e quer mergulhar mais fundo, **nós o encorajamos a atualizar para versão nightly**, principalmente porque dessa forma será mais fácil para você obter ajuda: a maioria da comunidade e sites como
[ziglearn.org](https://ziglearn.org) se baseiam no *master branch* pelas razões acima expostas.

A boa notícia é que é muito fácil mudar de uma versão Zig para outra, ou mesmo ter várias versões presentes no sistema ao mesmo tempo: As versões Zig são arquivos autocontidos que podem ser colocados em qualquer lugar em seu sistema.


## Instalando Zig
### Baixar diretamente
Esta é a maneira mais direta de obter o Zig: pegue um pacote Zig para sua plataforma a partir da página [Baixar](../../download),
extrair em um diretório qualquer e adicioná-lo ao seu `PATH` para poder utilizar o executável `zig` de qualquer lugar.

#### Configurando PATH no Windows
Para configurar seu caminho no Windows, execute **um** dos seguintes trechos de código em uma instância Powershell.
Escolha se você deseja aplicar esta mudança em nível de sistema (requer a execução de Powershell com privilégios administrativos) ou apenas para seu usuário, e ** certifique-se de mudar o trecho para apontar para o local onde se encontra sua cópia do Zig***.
O `;` antes do `C:` não é um erro de tipo.

Modo privilegiado do sistema (**admin** no Powershell):
```
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\your-path\zig-windows-x86_64-your-version",
"Machine"
)
```

Modo usuário (**sem privilégio** no Powershell):
```
[Environment]::SetEnvironmentVariable(
"Path",
[Environment]::GetEnvironmentVariable("Path", "User") + ";C:\your-path\zig-windows-x86_64-your-version",
"User"
)
```
Depois de terminar, reinicie sua instância do Powershell.

#### Configurando PATH no Linux, macOS, BSD
Adicione a localização de seu binário zig à sua variável de ambiente `PATH`.

Isso geralmente é feito adicionando uma linha de exportação ao seu script de inicialização do shell. (`.profile`, `.zshrc`, ...)
```bash
export PATH=$PATH:~/path/to/zig
```
Depois de feito, seu arquivo inicial ou `source`, reinicie o shell.




### Gerenciadores de pacotes
#### Windows
Zig está disponível no [Chocolatey](https://chocolatey.org/packages/zig).
```
choco install zig
```

#### macOS

**Homebrew**
NOTA: Homebrew ainda não possui os pacotes para Apple Silicon. Se você tem um M1 Mac, você deve compilar o Zig a partir da fonte.

Última versão de lançamento:
```
brew install zig
```

Última compilação do *master branch* de Git:
```
brew install zig --HEAD
```

**MacPorts**
```
port install zig
```
#### Linux
Zig também está presente em muitos gerentes de pacotes para Linux. [Aqui](https://github.com/ziglang/zig/wiki/Install-Zig-from-a-Package-Manager)
você pode encontrar uma lista atualizada, mas tenha em mente que alguns pacotes podem conter versões desatualizadas do Zig.

### Compilando da Fonte
[Aqui](https://github.com/ziglang/zig/wiki/Building-Zig-From-Source)
você pode encontrar mais informações sobre como construir Zig a partir da fonte para Linux, MacOS e Windows.

## Ferramentas recomendadas
### Sintaxe dos Higlighters e LSP
Todos os principais editores de texto têm suporte de destaque de sintaxe para Zig.
Alguns o empacotam, outros requerem a instalação de um plugin.

Se você estiver interessado em uma integração mais profunda entre o Zig e seu editor, confira [zigtools/zls](https://github.com/zigtools/zls).

Se você estiver interessado no que mais está disponível, confira a seção [Tools](../tools/).

## Executar Hello World
Se você completou o processo de instalação corretamente, agora você deverá ser capaz de invocar o compilador Zig a partir do shell.
Vamos testar isso criando seu primeiro programa Zig!

Navegue até o diretório de seus projetos e execute:
```bash
mkdir hello-world
cd hello-world
zig init-exe
```

Isto deve sair:
```
info: Created build.zig
info: Created src/main.zig
info: Next, try `zig build --help` or `zig build run`
```

Executando `zig build run` deve então compilar o executável e executá-lo, resultando em última instância:
```
info: All your codebase are belong to us.
```

Parabéns, você tem uma instalação Zig funcionando!

## Próximos passos
**Verifique outros recursos presentes na seção** [Aprender](../), certifique-se de encontrar a Documentação de sua versão do Zig (nota: as construções nightly devem utilizar documentação `master`) e considerar dar uma lida no [ziglearn.org](https://ziglearn.org) também.

Zig é um projeto jovem e infelizmente ainda não temos a capacidade de produzir extensa documentação e materiais de aprendizagem para tudo, portanto, você deve considerar [juntando-se a uma das comunidades Zig existentes](https://github.com/ziglang/zig/wiki/Community)
para obter ajuda quando você ficar confuso, bem como para verificar iniciativas como [Zig SHOWTIME](https://zig.show).

Finalmente, se você gosta de Zig e quer ajudar a acelerar o desenvolvimento, [considere fazer uma doação para a Zig Software Foundation](../../zsf)
<img src="/heart.svg" style="vertical-align:middle; margin-right: 5px">.
Loading

0 comments on commit 369d4a3

Please sign in to comment.