Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add portuguese translation #96

Merged
merged 27 commits into from
Jan 15, 2021
Merged
Show file tree
Hide file tree
Changes from 9 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
cce8a99
homepage portuguese
kassane Jan 13, 2021
50f177b
more pages on portuguese
kassane Jan 13, 2021
d6bae62
Getting Started translated
kassane Jan 13, 2021
8097894
Zig name fixed
kassane Jan 13, 2021
5ffa16e
Don't to translate the foundation name - HomePage
kassane Jan 13, 2021
cdfe40c
Create pt.toml
kassane Jan 13, 2021
c3ffe00
more translation
kassane Jan 13, 2021
680df3e
loading the SVG
kassane Jan 13, 2021
ea6e287
loading the SVG in pt - fixed
kassane Jan 13, 2021
2c3c5af
Tools section - translated and fix
kassane Jan 13, 2021
4fddffb
Overview - missing translation
kassane Jan 13, 2021
62f208b
Words changed - build translation
kassane Jan 13, 2021
f6c94c5
tier-3 missing
kassane Jan 13, 2021
66969db
Merge pull request #1 from ziglang/master
kassane Jan 13, 2021
e5f6247
Corrections requested
kassane Jan 14, 2021
2a60e81
zsf-index_pt fixed
kassane Jan 14, 2021
5694366
Implicit translation - target
kassane Jan 14, 2021
0f637b3
Update content/zsf/index.pt.md
kassane Jan 14, 2021
6e9e789
Update content/_index.pt.md
kassane Jan 14, 2021
698036d
Update content/_index.pt.md
kassane Jan 14, 2021
2b06fc6
Update content/_index.pt.md
kassane Jan 14, 2021
2bb3627
Update content/learn/overview.pt.md
kassane Jan 14, 2021
8e75c27
Merge pull request #2 from ziglang/master
kassane Jan 14, 2021
38af1a3
i18n-pt - updated
kassane Jan 15, 2021
df3c497
i18n-pt - JSON file linked
kassane Jan 15, 2021
c77dd76
homepage title translated & more fix
kassane Jan 15, 2021
29c2ecd
ZSF - Vocabulary terms fixed
kassane Jan 15, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
155 changes: 155 additions & 0 deletions content/_index.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,155 @@
---
title: Home
mobile_menu_title: "Home"
---
{{< slogan get_started="COMECE AGORA" docs="Documentação" notes="Mudanças">}}
kassane marked this conversation as resolved.
Show resolved Hide resolved
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***.
kassane marked this conversation as resolved.
Show resolved Hide resolved
{{< /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 alvo.

# ⚡ 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="learn/overview/" class="button" style="display: inline;">Visão geral em profundidade</a>
kassane marked this conversation as resolved.
Show resolved Hide resolved
</h1>
{{% /div %}}
{{% div style="margin-left: 5px;" %}}
<h1>
<a href="learn/samples/" class="button" style="display: inline;">Mais exemplos de código</a>
kassane marked this conversation as resolved.
Show resolved Hide resolved
</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://raw.githubusercontent.com/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://raw.githubusercontent.com/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 sem fins lucrativos 501(c)(3).

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 " 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 em profundidade](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
- [Aprenda Zig](https://ziglearn.org)
kassane marked this conversation as resolved.
Show resolved Hide resolved
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 construçã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: Getting Started
mobile_menu_title: "Getting Started"
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](#building-from-source).
kassane marked this conversation as resolved.
Show resolved Hide resolved
{{% /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 [Downloads](/download),
kassane marked this conversation as resolved.
Show resolved Hide resolved
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 construçã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/).

## Run 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">.
kassane marked this conversation as resolved.
Show resolved Hide resolved
Loading