You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
carbon/docs/README.br.pt.md

97 lines
22 KiB
Markdown

<p align="center"><img width=100% src="https://user-images.githubusercontent.com/10369094/31211729-591d059c-a950-11e7-86af-fa5ea3d7dbac.png"></p>
<!--[![Dependencies](https://img.shields.io/david/dawnlabs/carbon.svg)](https://github.com/dawnlabs/carbon/blob/readme-badges/package.json)-->
[![All Contributors](https://img.shields.io/badge/all_contributors-50-orange.svg?style=flat-square)](#contributors)
[![styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
[![MIT License](https://img.shields.io/github/license/dawnlabs/carbon.svg)](https://github.com/dawnlabs/carbon/blob/master/LICENSE)
[![Greenkeeper badge](https://badges.greenkeeper.io/dawnlabs/carbon.svg)](https://greenkeeper.io/)
[![Join the community on Spectrum](https://withspectrum.github.io/badge/badge.svg)](https://spectrum.chat/carbon-now)
<br></br>
[![Deploy to now](https://deploy.now.sh/static/button.svg)](https://deploy.now.sh/?repo=https://github.com/dawnlabs/carbon&env=TWITTER_CONSUMER_KEY&env=TWITTER_CONSUMER_SECRET&env=TWITTER_ACCESS_TOKEN_KEY&env=TWITTER_ACCESS_TOKEN_SECRET&env=LOGS_SECRET_PREFIX)
## Introdução
Sabe [todos](https://twitter.com/dan_abramov/status/890191815567175680) [aqueles](https://twitter.com/reactjs/status/890511993261654017) [prints](https://twitter.com/notquiteleo/status/873483329345028096) [de código](https://twitter.com/zeithq/status/805779711154647040) que você vê no Twitter? Apesar do código geralmente ser impressionante, nós vimos que a parte estética podia ser melhorada. Carbon facilita bastante criar e compartilhar imagens muito boas do seu código fonte. Então o que você está esperando? Vai lá impressionar todos os seus seguidores com esse design foda que você conseguiu aqui!
Visite [carbon.now.sh](https://carbon.now.sh) ou leia [nosso post (em inglês)](https://dawnlabs.io/case-studies/carbon/) para aprender mais sobre o nosso projeto.
## Funcionalidades
- **Importar de um gist do GitHub**. É só colocar o id de um gist do GitHub no fim da url;
- **Customização**. Personalize coisas como o tema usado no editor de acordo com a sintaxe da linguagem, o estilo de janela e mais;
- **Compartilhe rapidamente**. Salve sua imagem ou tweet o link com a imagem em um clique.
## Exemplo
<p align="center"><img width=100% src="https://user-images.githubusercontent.com/10369094/30791512-cb001438-a167-11e7-952b-f0f0e5c4499e.png"></p>
## Uso
#### Importar
Existem alguns jeitos diferentes de importar código fonte para o Carbon:
- Arraste um arquivo para o editor;
- Cole o id de um gist do GitHub no fim da url (e.g. `carbon.now.sh/ID_DO_GIST_AQUI`);
- Copie e cole o trecho de código diretamente no editor.
#### Customização
Assim que você colocar o trecho de código no editor do Carbon, você pode personalizar a imagem mudando o tema e sintaxe, cor de fundo, tema da janela, e o espaçamento entre a imagem do editor e as bordas.
#### Exportar/Compartilhar
Depois que você customizar a sua imagem, você pode tweetar um link para a imagem ou salvá-la diretamente.
## Comunidade
Confira os projetos top da nossa comunidade:
##### Plugins para editores de texto
- [IntelliJ IDEA `carbon-now-sh`](https://plugins.jetbrains.com/plugin/10469-carbon-now-sh) - Selecione o trecho de código aberto no seu IntelliJ IDEA e o use o botão direito para abrir o menu de opções onde você pode acionar o Carbon;
- [Atom `carbon-now-sh`](https://atom.io/packages/carbon-now-sh) - Abra o arquivo atual do seu Atom no Carbon com o comando `shift-cmd-A`;
- [VS Code `carbon-now-sh`](https://marketplace.visualstudio.com/items?itemName=ericadamski.carbon-now-sh) - Abra seu arquivo do VS Code no Carbon usando o comando `carbon`;
- [Sublime Text 3 `carbon-now-sh`](https://github.com/molnarmark/carbonSublime) - Selecione o trecho de código aberto no seu Sublime Text 3 com um atalho de teclado customizado;
- [Vim `carbon-now-sh`](https://github.com/kristijanhusak/vim-carbon-now-sh) - Selecione o trecho de código aberto no seu Vim/Neovim usando a função `CarbonNowSh()`;
- [Emacs `carbon-now-sh`](https://github.com/veelenga/carbon-now-sh.el) - Selecione o trecho de código aberto no seu Emacs usando a função interativa `carbon-now-sh`.
##### CLIs
- [CLI `carbon-now-cli`](https://github.com/mixn/carbon-now-cli) - Abra um arquivo no Carbon ou faça download da imagem diretamente com `carbon-now`, apresentando um modo interativo, seleção destacada e muito mais.
##### Bibliotecas
- [R `carbonate`](https://yonicd.github.io/carbonate/) - Manipule iterativamente a estética da imagem em `R` e abra no Carbon ou faça download diretamente.
##### Livros Didáticos
- ["CS 101 - An Introduction to Computational Thinking"](https://itunes.apple.com/us/book/id1435714196) - um livro didático de ciência da computação escrito por Sarbo Roy.
## Contribua
PRs são bem vindos! Por favor leia nosso [CONTRIBUTING.md](https://github.com/dawnlabs/carbon/blob/master/.github/CONTRIBUTING.md) para mais detalhes.
## Agradecimentos
[ ▲ ZEIT ](https://zeit.co/) por patrocinar a hospedagem do Carbon.
## Autores
Carbon é um projeto feito pela <a href="http://dawnlabs.io/"><img width=8% src="https://cloud.githubusercontent.com/assets/10369094/25406306/dacebd4c-29cb-11e7-8e1c-468687cde495.png"></a>
- Mike Fix ([@mfix22](https://github.com/mfix22))
- Brian Dennis ([@briandennis](https://github.com/briandennis))
- Jake Dexheimer ([@jakedex](https://github.com/jakedex))
## Contribuidores
Agradecemos imensamente a todas essas pessoas maravilhosas pela grande ajuda ([emoji key](https://github.com/kentcdodds/all-contributors#emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore -->
<table cellspacing="0" cellpadding="1"><tr><td><a href="https://github.com/briandennis"><img src="https://avatars0.githubusercontent.com/u/10078572?v=4" width="100px;" height="100px;" alt="briandennis"/><br /><sub><b>briandennis</b></sub></a><br /><a href="https://github.com/dawnlabs/carbon/commits?author=briandennis" title="Code">💻</a> <a href="https://github.com/dawnlabs/carbon/commits?author=briandennis" title="Documentation">📖</a> <a href="#infra-briandennis" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#review-briandennis" title="Reviewed Pull Requests">👀</a></td><td><a href="https://github.com/mfix22"><img src="https://avatars0.githubusercontent.com/u/8397708?v=4" width="100px;" height="100px;" alt="mfix22"/><br /><sub><b>mfix22</b></sub></a><br /><a href="#question-mfix22" title="Answering Questions">💬</a> <a href="https://github.com/dawnlabs/carbon/commits?author=mfix22" title="Code">💻</a> <a href="#ideas-mfix22" title="Ideas, Planning, & Feedback">🤔</a></td><td><a href="https://github.com/jakedex"><img src="https://avatars1.githubusercontent.com/u/10369094?v=4" width="100px;" height="100px;" alt="jakedex"/><br /><sub><b>jakedex</b></sub></a><br /><a href="#question-jakedex" title="Answering Questions">💬</a> <a href="https://github.com/dawnlabs/carbon/commits?author=jakedex" title="Code">💻</a> <a href="#design-jakedex" title="Design">🎨</a> <a href="#video-jakedex" title="Videos">📹</a></td><td><a href="https://github.com/andrewda"><img src="https://avatars1.githubusercontent.com/u/10191084?v=4" width="100px;" height="100px;" alt="andrewda"/><br /><sub><b>andrewda</b></sub></a><br /><a href="#question-andrewda" title="Answering Questions">💬</a> <a href="https://github.com/dawnlabs/carbon/commits?author=andrewda" title="Code">💻</a> <a href="https://github.com/dawnlabs/carbon/issues?q=author%3Aandrewda" title="Bug reports">🐛</a> <a href="#review-andrewda" title="Reviewed Pull Requests">👀</a></td><td><a href="https://github.com/yeskunall"><img src="https://avatars2.githubusercontent.com/u/14703164?v=4" width="100px;" height="100px;" alt="yeskunall"/><br /><sub><b>yeskunall</b></sub></a><br /><a href="https://github.com/dawnlabs/carbon/commits?author=yeskunall" title="Code">💻</a> <a href="https://github.com/dawnlabs/carbon/commits?author=yeskunall" title="Documentation">📖</a> <a href="#tool-yeskunall" title="Tools">🔧</a> <a href="https://github.com/dawnlabs/carbon/issues?q=author%3Ayeskunall" title="Bug reports">🐛</a></td><td><a href="https://github.com/stoshfabricius"><img src="https://avatars1.githubusercontent.com/u/2652676?v=4" width="100px;" height="100px;" alt="stoshfabricius"/><br /><sub><b>stoshfabricius</b></sub></a><br /><a href="https://github.com/dawnlabs/carbon/commits?author=stoshfabricius" title="Code">💻</a></td><td><a href="https://github.com/jkling38"><img src="https://avatars1.githubusercontent.com/u/11639896?v=4" width="100px;" height="100px;" alt="jkling38"/><br /><sub><b>jkling38</b></sub></a><br /><a href="https://github.com/dawnlabs/carbon/commits?author=jkling38" title="Documentation">📖</a></td></tr><tr><td><a href="https://github.com/otobrglez"><img src="https://avatars1.githubusercontent.com/u/225946?v=4" width="100px;" height="100px;" alt="otobrglez"/><br /><sub><b>otobrglez</b></sub></a><br /><a href="https://github.com/dawnlabs/carbon/commits?author=otobrglez" title="Code">💻</a></td><td><a href="https://github.com/darahak"><img src="https://avatars3.githubusercontent.com/u/11488612?v=4" width="100px;" height="100px;" alt="darahak"/><br /><sub><b>darahak</b></sub></a><br /><a href="https://github.com/dawnlabs/carbon/commits?author=darahak" title="Documentation">📖</a></td><td><a href="https://github.com/dom96"><img src="https://avatars0.githubusercontent.com/u/246651?v=4" width="100px;" height="100px;" alt="dom96"/><br /><sub><b>dom96</b></sub></a><br /><a href="https://github.com/dawnlabs/carbon/commits?author=dom96" title="Code">💻</a></td><td><a href="https://github.com/elrumordelaluz"><img src="ht
<!-- ALL-CONTRIBUTORS-LIST:END -->