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

translating to portuguese #605

Open
wants to merge 7 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
29 changes: 12 additions & 17 deletions content/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,22 +3,19 @@

###openFrameworks development is collaborative. It thrives on the contributions of <a href="https://github.com/openframeworks/openFrameworks/contributors">many people</a>, who engage in frequent discussion on the <a href="http://forum.openframeworks.cc/">forums</a>, <a href="http://webchat.freenode.net/?channels=openframeworks&uio=MT1mYWxzZSY5PXRydWUmMTE9Mjk39">IRC</a>, and the <a href="http://dev.openframeworks.cc/listinfo.cgi/of-dev-openframeworks.cc">of-dev mailing list</a>.

We use git, a distributed versioning system, which means also that people can branch, experiment, and make suggestions. If you look at the network diagram on <a href="http://github.com/openframeworks/openFrameworks">GitHub</a>, it's looks like some alien diagram, full of weaving branches, code pulling apart and coming together. There's a huge community, all over the world, working on the core code: fixing bugs, submitting pull requests, and shaping the tool the way they want to see it.
We use git, a distributed versioning system, which means also that people can branch, experiment, and make suggestions. If you look at the network diagram on <a href="http://github.com/openframeworks/openFrameworks">GitHub</a>, it looks like some alien diagram, full of weaving branches, code pulling apart and coming together. There's a huge community, all over the world, working on the core code: fixing bugs, submitting pull requests, and shaping the tool the way they want to see it.

Visit the <a href="../community">community page</a> for other ways to contribute.</p>


<ul class="external_links" >
<li><a href="http://dev.openframeworks.cc/listinfo.cgi/of-dev-openframeworks.cc">of-dev mailing list</a></li>
<li><a href="http://webchat.freenode.net/?channels=openframeworks&uio=MT1mYWxzZSY5PXRydWUmMTE9Mjk39">IRC</a></li>
<li><a href="http://forum.openframeworks.cc/">forum</a></li>
<li><a href="http://github.com/openframeworks/openFrameworks">github</a></li>
</ul>


<hr>


<h2 id="documents">documents</h2>
<p><a href="https://github.com/openframeworks/openFrameworks/wiki">developer wiki</a> - central location for links to relevant openFrameworks developer docs</p>
<p><a href="https://github.com/openframeworks/openFrameworks/wiki/openFrameworks-git-workflow">git workflow</a> - the version control workflow followed by the openFrameworks community when dealing with the development of openFrameworks</p>
Expand Down Expand Up @@ -50,17 +47,17 @@ Visit the <a href="../community">community page</a> for other ways to contribute

<h3>openFrameworks codebase</h3>
<ul>
<li><b>2D-3D</b>: <a href="https://github.com/elliotwoods">Elliot Woods</a> (elliotwoods), <a href="https://github.com/tgfrerer">Tim Gfrerer</a> (tgfrerer)</li>
<li><b>Android</b>: <a href="https://github.com/arturoc">arturo</a> (arturoc), <a href="https://github.com/danthemellowman">Dan Moore</a> (danthemellowman)</li>
<li><b>Hardware</b>: <a href="https://github.com/joshuajnoble">joshua noble</a> (joshuajnoble)</li>
<li><b>iOS</b>: <a href="https://github.com/admsyn">Adam Carlucci</a> (admsyn), <a href="https://github.com/danoli3">Daniel Rosser</a> (danoli3), <a href="https://github.com/julapy">lukasz karluk</a> (julapy), <a href="https://github.com/ofTheo">Theodore Watson</a> (ofTheo)</li>
<li><b>Linux</b>: <a href="https://github.com/arturoc">arturo</a> (arturoc), <a href="https://github.com/bakercp">Christopher Baker</a> (bakercp), <a href="https://github.com/bilderbuchi">Christoph Buchner</a> (bilderbuchi), <a href="https://github.com/jvcleave">Jason Van Cleave</a> (jvcleave), <a href="https://github.com/underdoeg">Philip Whitfield</a> (underdoeg)</li>
<li><b>Linux ARM</b>: <a href="https://github.com/bakercp">Christopher Baker</a> (bakercp), <a href="https://github.com/jvcleave">Jason Van Cleave</a> (jvcleave)</li>
<li><b>OS X</b>: <a href="https://github.com/admsyn">Adam Carlucci</a> (admsyn), <a href="https://github.com/julapy">lukasz karluk</a> (julapy), <a href="https://github.com/ofTheo">Theodore Watson</a> (ofTheo), <a href="https://github.com/pizthewiz">pizthewiz</a></li>
<li><b>Sound</b>: <a href="https://github.com/admsyn">Adam Carlucci</a> (admsyn)</li>
<li><b>Typography</b>: <a href="https://github.com/bakercp">Christopher Baker</a> (bakercp)</li>
<li><b>Video</b>: <a href="https://github.com/obviousjim">James George</a> (obviousjim)</li>
<li><b>Windows</b>: <a href="https://github.com/elliotwoods">Elliot Woods</a> (elliotwoods), <a href="https://github.com/LeoColomb">Léo Colombaro</a> (LeoColomb), <a href="https://github.com/ofZach">ofZach</a></li>
<li><b>2D-3D</b>: <a href="https://github.com/elliotwoods">Elliot Woods</a> (elliotwoods), <a href="https://github.com/tgfrerer">Tim Gfrerer</a> (tgfrerer)</li>
<li><b>Android</b>: <a href="https://github.com/arturoc">arturo</a> (arturoc), <a href="https://github.com/danthemellowman">Dan Moore</a> (danthemellowman)</li>
<li><b>Hardware</b>: <a href="https://github.com/joshuajnoble">joshua noble</a> (joshuajnoble)</li>
<li><b>iOS</b>: <a href="https://github.com/admsyn">Adam Carlucci</a> (admsyn), <a href="https://github.com/danoli3">Daniel Rosser</a> (danoli3), <a href="https://github.com/julapy">lukasz karluk</a> (julapy), <a href="https://github.com/ofTheo">Theodore Watson</a> (ofTheo)</li>
<li><b>Linux</b>: <a href="https://github.com/arturoc">arturo</a> (arturoc), <a href="https://github.com/bakercp">Christopher Baker</a> (bakercp), <a href="https://github.com/bilderbuchi">Christoph Buchner</a> (bilderbuchi), <a href="https://github.com/jvcleave">Jason Van Cleave</a> (jvcleave), <a href="https://github.com/underdoeg">Philip Whitfield</a> (underdoeg)</li>
<li><b>Linux ARM</b>: <a href="https://github.com/bakercp">Christopher Baker</a> (bakercp), <a href="https://github.com/jvcleave">Jason Van Cleave</a> (jvcleave)</li>
<li><b>OS X</b>: <a href="https://github.com/admsyn">Adam Carlucci</a> (admsyn), <a href="https://github.com/julapy">lukasz karluk</a> (julapy), <a href="https://github.com/ofTheo">Theodore Watson</a> (ofTheo), <a href="https://github.com/pizthewiz">pizthewiz</a></li>
<li><b>Sound</b>: <a href="https://github.com/admsyn">Adam Carlucci</a> (admsyn)</li>
<li><b>Typography</b>: <a href="https://github.com/bakercp">Christopher Baker</a> (bakercp)</li>
<li><b>Video</b>: <a href="https://github.com/obviousjim">James George</a> (obviousjim)</li>
<li><b>Windows</b>: <a href="https://github.com/elliotwoods">Elliot Woods</a> (elliotwoods), <a href="https://github.com/LeoColomb">Léo Colombaro</a> (LeoColomb), <a href="https://github.com/ofZach">ofZach</a></li>
</ul>

<p>And previously:</p>
Expand All @@ -74,5 +71,3 @@ Visit the <a href="../community">community page</a> for other ways to contribute
<li><a href="http://www.vargatron.com/">Steve Varga</a> (vargatron) as typography leader</li>
<li><a href="http://justdayan.com/">Dayan Moisa</a> (justdayan) as documentation leader</li>
</ul>


2 changes: 1 addition & 1 deletion learning/08_other/system.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ void ofApp::keyPressed(int key){
}
```

Depending on your operating system there might be other things to consider. For example, on posix systems, you might want to use the & at the end of your command so that it runs in the background.
Depending on your operating system there might be other things to consider. For example, on POSIX systems, you might want to use the & at the end of your command so that it runs in the background.

The [systemSpeakExample](https://github.com/openframeworks/openFrameworks/tree/master/examples/input_output/systemSpeakExample) in examples/input_output has good information about this and more details per-platform.

74 changes: 74 additions & 0 deletions readme.pt.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@

# site do openframeworks

Este repositório armazena o conteúdo e código que gera a página de internet [openFrameworks](http://openFrameworks.cc/).

Para outras línguas, por favor ver os documentos abaixo enunciados.

- korean(한국어) : [readme.ko.md](readme.ko.md)
- japanese(日本語) : [readme.ja.md](readme.ja.md)
- traditional chinese(繁體中文) : [readme.zh_cn.md](readme.zh_cn.md)

## Contribuição

Para contribuir para a página de internet ou para a documentação, pode por exemplo fazer fork e enviar as contribuições directamente a partir da página do github.

A maior parte do conteúdo encontra-se na pasta `content` no directoria markdown.

A pasta  `tutorials` é estruturada com um primeiro nível de pastas que representam a categoria e, por conseguinte os ficheiros armazenados em markdown com a extensão `.markdown` e uma pasta para cada um deles com o mesmo nome que o ficheiro de texto que contém as imagens ou qualquer outro recurso. O ficheiro final html para cada tutorial é gerado com o mesmo nível que os seus recursos portanto os links têm que ser relativos a qualquer outra pasta como:

```md
![img](image.png)
```

A pasta `documentation` contém a referência da API do OF e encontra-se também em formato markdown. Estes documentos são gerados a partir do código mas o campo de descrição em todas as classes, funções ou variáveis, é editado directamente nos ficheiros markdown.

## Configurar o site para compilar localmente

O site é construido usando [nikola](https://getnikola.com). Há alguns scripts na mesma pasta que tornam mais fácil instalar e usá-los.

1. Primeiro, se instalar no Mac OS-X, garanta-se que as seguintes linhas de código foram instalads:

```bash
xcode-select --install
```
instale de seguida os seguintes pacote (se não tiver o homebrew instalado pode extrai-lo a partir de [brew.sh](http://brew.sh/)):

```bash
brew install python3
sudo easy_install pip
brew linkapps python3
```
2. A partir do código fonte do ofSite, corra o ./install.sh que instala o nikola e todas as dependências necessárias. (Isto foi testado apenas em linux e OS-X).

3. FInalmente adicione o seguinte ao seu ficheiro .basrc, .bash_profile out .zshrc:
`export XML_CATALOG_FILES="/usr/local/etc/xml/catalog"`

Há dois scripts incluidos no root do ofSite para ajudar com os documentos:

**./auto_build.sh** : Corre o nikola e compile o site todas as vezes que qualquer ficheiro for modificado.

Se, no osx, receber o seguinte errro: `FileNotFoundError: [Errno 2] No such file or directory: 'asciidoctor'`, irá precisar de instalar o asciidoctor tal como explicado [here](http://asciidoctor.org/docs/install-asciidoctor-macosx/), e depois correr o script novamente.

**./serve.sh** : Começa um novo web serve que serve como site e abre-o no seu browser.

Se planear fazer uma grande modificação como contribuir com uma tradução a forma mais fácil é deixar estes 2 últimos scripts a correr e fazer apenas uma edição ao conteúdo dos ficheiros e o site irá automaticamente ser actualizado.

## Markodw do estilo da documentação

Esta porção de documentação do site é escrita em Markdown, uma syntax estilo wiki. Ver os detalhes em [Daringfireball](http://daringfireball.net/projects/markdown/).

A forma mais fácil de verificar a sintaxe é dar uma olhada nas várias páginas já existentes no site, mas aqui estão algumas dicas úteis:

Para inserir exemplos de código use 4 tiles seguidos de curly braces com ".cpp" dentro, e acabe com quatro tildes:

```cpp
for(int i = 0; i < 16; i++) {
ofLog() << i;
}
```
As images são adicionadas no formato normal de markdown:

![Image Title](filename.png "alt text")

Para uma descrição mais completa de como contribuir para a documentação, por favor ver o tutorial [Contribuir para a documentação ](http://openframeworks.cc/learning/08_other/contributing/) .