Difference between pages "Coding Standards/pt-br" and "Package:Sublime Text Editor"

From Funtoo
< Coding Standards(Difference between pages)
Jump to navigation Jump to search
 
 
Line 1: Line 1:
== Padrão de Codificação Básica Em Um Nutshell ==
{{Ebuild
|Summary=Sublime Text is an advanced commercial text editor.
|CatPkg=app-editors/sublime-text
|Maintainer=Oleg,
|Homepage=http://sublimetext.com
}}
Sublime Text is a very complete text editor with lots of features, and support for plugins. It's free, but often shows a popup showing that's unregistered, so you can purchase the license for USD$70.


* empacotamento de palavra (word wrap) de até 160 caracteres
== Install ==
* utilize tabs, não espaços, para endentação
First, you must have installed [[Package:Layman|Layman]] with Git support. Then, add the overlay ''sublime-text'':
* utilize um tamanho de tab de 4 caracteres (o tamanho de tab pode ser ajustado, mas isso afeta quando você alcançar o limite de empacotamento mágico de 160 caracteres)
* comentários em linhas separadas, no mesmo nível de recuo como código (seções podem ser marcadas por comentários 'outdented')


== Empacotamento de Palavra (Word Wrap) ==
<console>###i## layman -a sublime-text</console>


Editores modernos fazem um bom trabalho exibindo linhas de texto muito longas, e exibições modernas tem resolução o suficiente para exibições muito superior do que 80 caracteres por linha, mesmo em resolução 1024x768. Você não deve definitivamente dividir pedaço de código elegante de linha única somente pelo argumento de manter a coisa toda sob 80 caracteres. Isso é especialmente ruim se você pegar, digamos, uma linha de 100 caracteres e dividi-la em ''mais'' do que duas linhas somente pelo argumento de mantê-lo sob 80 caracteres de largura. Mas você precisa ou quer usar múltiplas linhas para manter seu código legível, mais poder para você. Somente não faça isso para manter "com compatibilidade com cartão de 80 colunas Apple IIe" por qualquer rasão. Isso é simplesmente bobagem.
Now, install the version you want. For the version 2:
<console>###i## emerge -av sublime-text:2</console>


== Tabulações vs. Espaços ==
For the version 3 (default):
<console>###i## emerge -av sublime-text:3</console>


Tabulações e espaços tinham uma luta. Tabulações venciam. Eles são mais fáceis de lidar e permite endentação configurável para aqueles que necessitam disso. Eu não me importo com o que alguns outro grupo ou organização diga que convenção seja. Se você não quiser utilizar tabs por que você quer que todos os seus comentários de final de linha apareçam bonitos belamente, então eu tenho uma solução: não utilize comentários de final de linha (veja a próxima seção) e você ficará bem.
You can have installed both versions, so you must install it with the USE flag ''multislot'', that also brings the package eselect-sublime.
 
{{EbuildFooter}}
== Comments ==
 
Adicione comentários que proporcionam alguma ideia sobre seu código, e que ajude a proporcionar contexto. Também, por que nós utilizamos tabs, posicionam comentários em suas próprias linhas, separam do código fonte, idealmente separados por uma linha em branco acima e abaixo ao menos que você esteja comentando em verboso cada linha de código. Isso também encoraja a comentários mais longos, mais descritivos que possam abranger múltiplas linhas. Se você abranger múltiplas linhas, utilize uma margem direita consistente de 160 caracteres. Comentários lhe ajudam a entender seu código quando você voltar a ele um ano depois, então está adicionando comentários descritivos para si mesmo o tanto o quanto para outros. Inclua informação que você acharia prestativa se você tivesse um caso repentino de amnésia. Eles são especialmente importantes para o software livre e de código aberto que precisam ser mantidos por várias pessoas ao longo dos anos.
 
== Profanity ==
 
Do not place any profanity in source code comments or variable names. It just makes you look unprofessional, silly and incompetent.
 
 
[[Category:QA]]

Latest revision as of 04:52, January 3, 2015

Sublime Text Editor

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Sublime Text is a very complete text editor with lots of features, and support for plugins. It's free, but often shows a popup showing that's unregistered, so you can purchase the license for USD$70.

Install

First, you must have installed Layman with Git support. Then, add the overlay sublime-text: 

root # layman -a sublime-text

Now, install the version you want. For the version 2: 

root # emerge -av sublime-text:2

For the version 3 (default): 

root # emerge -av sublime-text:3

You can have installed both versions, so you must install it with the USE flag multislot, that also brings the package eselect-sublime.


Retrieved from "https://www.funtoo.org/index.php?title=Coding_Standards/pt-br&oldid=8259"