Editando Como escrever artigos na wiki (seção)

= Visual dos artigos =
{{tip|As seções a seguir documentam como usar os templates wikitext na nossa wiki.}}



== Parágrafos ==

Para criar um novo parágrafo, insira uma linha em branco entre duas linhas de texto. Se não existir uma linha em branco entre duas linhas de wikitexto, elas serão combinadas em um único parágrafo fluente. Assim:


foobar


Se você deixar espaços em branco iniciais no início de uma linha, nossa wiki os processará como texto pré-formatado {{c|<nowiki><pre></nowiki>}}. Cuidado com isso. Isso irá cagar o visual ao especificar parâmetros de templates, então você obterá isso:


 foobar



== Hierarquia nos artigos ==

Use cabeçalhos de seção para criar uma hierarquia de documentos para sua página. Estes irão definir o índice que aparece no topo da página wiki. Crie capítulos, seções e subseções da seguinte maneira:

<pre>= Título da página =

== Título do capítulo ==

=== Título da seção ===

==== Título da subseção ====

</pre>

{{Note|Por padrão, o índice está desativado no wiki. Se você gostaria de ativar o TOC, você pode colocar um<code><nowiki>__TOC__</nowiki></code> em uma linha em branco onde você gostaria que o Sumário fosse exibido ou colocado <code><nowiki>__FORCETOC__</nowiki></code> em uma linha em branco em qualquer lugar do wikitexto para forçar o TOC a aparecer no topo da página.}}

Em geral, ao criar novos documentos, é melhor usar Títulos da Seção do nível 3 (três "=") para dividir o conteúdo. Títulos de seção de nível 2 são melhor usados para seções principais de documentos maiores. Use-os com pouca frequência. Títulos da Seção de Nível 1 geralmente não precisam ser usados.


== Links ==

Links internos para outras páginas wiki podem ser especificados como <tt><nowiki>[[pagename]]</nowiki></tt>. Para especificar um nome alternativo para o link, use <tt><nowiki>[[pagename|my link name]]</nowiki></tt>.

Para links externos, use <tt><nowiki>[https://funtoo.org funtoo.org]</nowiki></tt> para especificar um URL. Se você quiser que o URL apareça no wikitexto, você pode especificá-lo também sem colchetes: https://funtoo.org/


== Listas ==
O MediaWiki suporta vários formatos de lista:

* Lista não ordenada
* Item não ordenado 2
** Subitem não ordenado

# Lista ordenada
# Item pedido 2
## sub-item solicitado

; Termo: Isso é chamado de "lista de definição". É usado ao definir vários termos.

{{Note|Sempre use [[#Tabelas|Tabelas]] em vez de listas de definição, quando possível. Elas são mais fáceis de ler.}}



== Blockquotes ==
Se você precisar citar uma parte do texto de outro site, use <tt><nowiki><blockquote></nowiki></tt> do seguinte modo:

<blockquote>
Wikipedia (ˌwɪkɨˈpiːdiə / ou wɪkiˈpiːdiə / wik-i-pee-dee-ə) é uma enciclopédia de conteúdo livre editada de forma colaborativa, multilíngüe, gratuita e gratuita, que é suportada e hospedada pela Fundação Wikimedia sem fins lucrativos. Voluntários de todo o mundo escrevem colaborativamente os 30 milhões de artigos da Wikipedia em 287 idiomas, incluindo mais de 4,5 milhões na Wikipédia em inglês. Qualquer pessoa que consiga acessar o site pode editar quase todos os seus artigos, que na Internet constituem [4] o maior e mais popular trabalho de referência geral. [5] [6] [7] [8] [9] Em fevereiro de 2014, o The New York Times informou que a Wikipédia está em quinto lugar mundial entre todos os sites, "Com 18 bilhões de visualizações de página e quase 500 milhões de visitantes únicos por mês ..., a Wikipedia apenas Yahoo, Facebook, Microsoft e Google maior com 1,2 bilhão de visitantes únicos. "[10]
</blockquote>


== Texto Literal e Símbolos HTML ==
Aqui está o wikitexto para a seção acima, que estou exibindo colocando o wikitexto literal entre um &#60;pre&#62; e &#60;/pre&#62; tag. Se você quiser desabilitar o processamento de wikitexto para um intervalo de texto em linha, use &#60;nowiki&#62; e &#60;/nowiki&#62;. Se você quiser imprimir uma tag literalmente, use &amp;#60; e &amp;#62; (No wikitexto, eu usei &amp;amp;#60; e &amp;amp;#62 para mostrar isso!)

<pre>
* Lista não ordenada
* Item não ordenado 2
** Subitem não ordenado

# Lista ordenada
# Item pedido 2
## sub-item solicitado

; Termo: Isso é chamado de "lista de definição". É usado ao definir vários termos.

Se você precisar citar uma parte do texto de outro site, use <tt> <nowiki> <blockquote> </ nowiki> </ tt> da seguinte forma:
<blockquote>
Wikipedia (ˌwɪkɨˈpiːdiə / ou wɪkiˈpiːdiə / wik-i-pee-dee-ə) é um acesso livre, multilingue, editado e colaborativo,
enciclopédia de conteúdo livre na Internet que é suportada e hospedada pela Fundação Wikimedia sem fins lucrativos. Voluntários
em todo o mundo colaborativamente escrever 30 milhões de artigos da Wikipedia em 287 idiomas, incluindo mais de 4,5 milhões no
Wikipédia em inglês. Qualquer pessoa que possa acessar o site pode editar quase todos os seus artigos, que na Internet
compreende [4] o maior e mais popular trabalho de referência geral. [5] [6] [7] [8] [9] Em fevereiro de 2014, The New York
Times informou que a Wikipedia está em quinto lugar mundial entre todos os sites, afirmando: "Com 18 bilhões de page views
e quase 500 milhões de visitantes únicos por mês ..., a Wikipédia encalça apenas Yahoo, Facebook, Microsoft e Google,
o maior com 1,2 bilhão de visitantes únicos."[10]
</blockquote>
</pre>


== Exibindo código fonte ==
Para exibir o código-fonte, use o template '''FILE''', especificando a linguagem de programação via parâmetro <tt>lang=</tt>:
=== Exemplo python ===
<pre>
{{file|name=foobar|lang=python|desc=foobarosity|body=
import system
}}
</pre>


Este exemplo produz a seguinte saída:
{{file|name=foobar|lang=python|desc=foobarosity|body=
import system
}}



=== Exemplo Perl ===
<pre>
{{file|name=hello_world.pl|lang=perl|desc=Hello World in Perl|body=
print "Hello World\n";
}}
</pre>


Este exemplo produz a seguinte saída:
{{file|name=hello_world.pl|lang=perl|desc=Hello World in Perl|body=
print "Hello World\n";
}}


'''OBS:''' Os parametros {{c|name}} (filename), {{c|lang}} (linguagem para realce de sintaxe) e {{c|desc}} (Descrição, aparecendo como legenda) são opcionais. 


{{note|'''Até o momento, suportamos em nossa wiki as seguintes linguagens de programação e marcações:'''
ActionScript * Ada * ANTLR * AppleScript * Assembly * Asymptote * Awk * Befunge * Boo * BrainFuck * C / C++ * C# * Clojure *  offeeScript * ColdFusion * Common Lisp * Coq * Cryptol * Crystal * Cython * D * Dart * Delphi * Dylan * Elm * Erlang * Ezhil * Factor * Fancy * Fortran * F# * GAP * Gherkin (Cucumber) * GL shaders * Groovy * Haskell * IDL * Io * Java * JavaScript * Lasso * LLVM * Logtalk * Lua * Matlab * MiniD * Modelica * Modula-2 * MuPad * Nemerle * Nimrod * Objective-C * Objective-J * Octave * OCaml * PHP * Perl * PovRay * PostScript * PowerShell * Prolog * Python 2.x and 3.x  * REBOL * Red * Redcode * Ruby * Rust * S, S-Plus and R * Scala * Scheme * Scilab * Smalltalk * SNOBOL * Tcl * Vala * Verilog * VHDL * Visual Basic.NET * Visual FoxPro * XQuery * Zephir * Apache config files * Bash shell scripts * BBCode * CMake * CSS * Diff files * DTD * Gettext catalogs * Gnuplot script * Groff markup * HTML * HTTP sessions * INI-style config files * IRC logs (irssi style) * Lighttpd config files * Makefiles * MoinMoin/Trac Wiki markup * MySQL * Nginx config files * POV-Ray scenes * Ragel * Redcode * ReST * Robot Framework * RPM spec files * SQL * Squid configuration * TeX * tcsh * Vim Script * Windows batch files * XML * XSLT * YAML * Cheetah templates * Django / Jinja templates * ERB * Genshi * JSP * Myghty * Mako * Smarty templates * Tea }}


== Exibição do caractere pipe em nossa wiki ==
{{important|Se você precisar exibir um pipe ("{{!}}") dentro do campo do tipo arquivo ou console, substitua cada "{{!}}" (pipe) por <nowiki>{{!}}</nowiki> -- Caso contrário, o conteúdo do arquivo não será exibido corretamente. Isso é necessário porque <nowiki>{{file}}</nowiki> é um template e o caractere pipe ("{{!}}") é usado como um delimitador de argumentos para o template.}}



=== Exibindo o conteúdo do arquivo de texto ou de configuração ===
Para exibir o conteúdo de arquivos de texto em linguagem que não sejam de programação (como arquivos de configuração), você tem duas opções. Você pode colocar suas linhas dentro de tags <tt>&#60;pre&#62;</tt>, ou usar o novo [[Template:File|file template]]. O template '''FILE''' é usado assim:

<pre>
{{file|name=/etc/foo.conf|desc=My foo.conf file|body=
# /etc/host.conf:
# $Header: /var/cvsroot/gentoo/src/patchsets/glibc/extra/etc/host.conf,v 1.1 2006/09/29
}}
</pre>



Este exemplo produz a seguinte saída:
{{file|name=/etc/foo.conf|desc=My foo.conf file|body=
# /etc/host.conf:
# $Header: /var/cvsroot/gentoo/src/patchsets/glibc/extra/etc/host.conf,v 1.1 2006/09/29
}}

=== Console ===
Para exibir a saída do console, use o template <nowiki>{{console}}</nowiki>:


Comandos como usuário root:
<pre>
{{console|body=
###i## run a command as root
}}
</pre>


Este exemplo produz a seguinte saída:
{{console|body=
###i## run a command as root
}}





Para um console não-root:
<pre>
{{console|body=
$ ##i##run a command as user
}}
</pre>


Este exemplo produz a seguinte saída:
{{console|body=
$ ##i##run a command as user
}}

{{important|1=
Note que nós usamos um <tt>#</tt> prompt para <tt>root</tt> e o <tt>$</tt> prompt para denotar um usuário não-root.}}

{{important|A tag de texto <tt>##i##</tt> marca o resto da linha como sendo "entrada do usuário" ("i" é para "entrada"). Em seguida, é destacado em uma cor perceptível, de modo que se destaca do texto que não é digitado pelo usuário.}}

Se você precisar finalizar o destaque da entrada do usuário antes do final de uma linha, use <code>##!i##</code> para marcar o final da área realçada.

As seguintes sequências especiais de caracteres também estão disponíveis:
* <code>##g##</code> - Verde
* <code>##y##</code> - Amarelo
* <code>##bl##</code> - Azul
* <code>##r##</code> - Vermelho
* <code>##b##</code> - Negrito



Por favor, use as opções de coloração acima com moderação. Às vezes é bom usá-los para obter a saída do console do wiki para corresponder às cores exibidas em um console do Linux. Observe também que, para cada cor acima, há uma opção de correspondência <code>##!(colorcode)##</code> para desligar a cor antes do final da linha.

Aqui está um exemplo de seu uso:{{console|body=
# ##i##bluetoothctl 
[##g##NEW##!g##] Controller 00:02:72:C9:62:65 antec [default]
##bl##[bluetooth]##!bl### ##i##power on
Changing power on succeeded
##bl##[bluetooth]##!bl### ##i##agent on
Agent registered
##bl##[bluetooth]##!bl### ##i##scan on
Discovery started
##bl##[bluetooth]##!bl### ##i##devices
Device 00:1F:20:3D:1E:75 Logitech K760
##bl##[bluetooth]##!bl### ##i##pair 00:1F:20:3D:1E:75
Attempting to pair with 00:1F:20:3D:1E:75
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Connected: yes
##r##[agent]##!r## Passkey: 454358
##r##[agent]##!r## Passkey: ##i##4##!i##54358
##r##[agent]##!r## Passkey: ##i##45##!i##4358
##r##[agent]##!r## Passkey: ##i##454##!i##358
##r##[agent]##!r## Passkey: ##i##4543##!i##58
##r##[agent]##!r## Passkey: ##i##45435##!i##8
##r##[agent]##!r## Passkey: ##i##454358##!i##
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Paired: yes
Pairing successful
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Connected: no
##bl##[bluetooth]##!bl### ##i##connect 00:1F:20:3D:1E:75
Attempting to connect to 00:1F:20:3D:1E:75
[##y##CHG##!y##] Device 00:1F:20:3D:1E:75 Connected: yes
Connection successful
##bl##[bluetooth]##!bl### ##i##quit
[##r##DEL##!r##] Controller 00:02:72:C9:62:65 antec [default]
#
}}

=== Mensagens informativas ===
Notas, avisos, dicas e modelos importantes podem ser usados para mensagens informativas que precisam ser deslocadas do fluxo de texto regular:

<pre>{{note|Isso é uma nota}}</pre>
{{note|Isso é uma nota}}

<pre>{{important|Isso é importante}}</pre>
{{important|Isso é importante}}

<pre>{{warning|Isso é um alerta}}</pre>
{{warning|Isso é um alerta}}

<pre>{{tip|Isso é uma dica}}</pre>
{{tip|Isso é uma dica}}

Observe que esses templates costumavam ser chamados<code>fancynote</code>, <code>fancytip</code>, etc. Os "fancy" foram descontinuados, mas continuarão a ser suportados no futuro previsível.


=== Kernelop ===
Para exibir as opções de configuração do kernel, nós encorajamos você a usar o template <tt>kernelop</tt>. Para usar o template <tt>kernelop</tt>, crie uma entrada semelhante ao exemplo a seguir:

<pre>
{{kernelop|title=foo,bar|desc=
kernel options pasted from "make menuconfig"
}} 
</pre>

{{note|O kernel é de cor azul para lembrar ligeiramente o fundo azulado do <tt>make menuconfig</tt>.}}

Adicionar esta entrada lhe dará a seguinte saída:
{{kernelop|title=foo,bar|desc=
kernel options
}}

Aqui está um exemplo mais concreto:
{{kernelop|title=File systems|desc=
<M> Second extended fs support          
[ ]   Ext2 extended attributes          
[ ]   Ext2 execute in place support     
<M> Ext3 journalling file system support
}}


=== Código Inline ===

Para enfatizar comandos e outros jargões técnicos quando aparecem em linha em um parágrafo, use o template <nowiki>{{c}}</nowiki>. Ao referenciar arquivos, use o template <nowiki>{{f}}</nowiki>.

<pre>
The {{f|/etc/fstab}} O arquivo é importante. Outro arquivo importante é {{f|/boot/grub/grub.cfg}}. O comando {{c|emerge}} é realmente bacana.
</pre>

Este exemplo produz a seguinte saída:

The {{f|/etc/fstab}} O arquivo é importante. Outro arquivo importante é {{f|/boot/grub/grub.cfg}}. O comando {{c|emerge}} é realmente bacana.

{{important|1=
A tag &#60;tt&#62; foi descontinuada para fins de codificação de código embutido, para estar em conformidade com HTML5 e o uso anterior da tag  &#60;code&#62; é desencorajado. É mais fácil usar o template <nowiki>{{c}}</nowiki>. }}






== Frames ==
Para incluir outras páginas externas, utilize o template '''IFRAME'''. Crie uma entrada semelhante ao exemplo a seguir:
<pre>
{{#widget:Iframe
|url=https://www.google.com/calendar/embed?src=agenda%40area31.net.br&ctz=America/Sao_Paulo
|width=400
|height=300
|border=0
}}
</pre>




Este exemplo produz a seguinte saída:

{{#widget:Iframe
|url=https://www.google.com/calendar/embed?src=agenda%40area31.net.br&ctz=America/Sao_Paulo
|width=400
|height=300
|border=0
}}


== Tabelas ==

Em vez de usar o wikitexto tradicional da tabela do MediaWiki, use o seguinte formato:

<pre>
{{TableStart}}
<tr class="info"><th>Header 1</th><th>Header 2</th></tr>
<tr><td>Value 1</td><td>Value 2</td></tr>
<tr><td>Value 3</td><td>Value 4</td></tr>
{{TableEnd}}
</pre>

Isso renderizará da seguinte maneira:

{{TableStart}}
<tr class="info"><th>Header 1</th><th>Header 2</th></tr>
<tr><td>Value 1</td><td>Value 2</td></tr>
<tr><td>Value 3</td><td>Value 4</td></tr>
{{TableEnd}}

Algumas macros auxiliares estão agora disponíveis, o que facilita a definição de tabelas de duas e três colunas. Use {{c|2Col}} para linha normal de duas colunas, {{c|2ColHead}} para cabeçalho de 2 colunas e{{c|3Col}} para linha de 3 colunas e {{c|3ColHead}} para cabeçalho de 3 colunas:

<pre>
{{TableStart}}
{{2ColHead|Sub-Profile|Description}}
{{2Col|{{c|arch}}|One arch profile is enabled, at build time, and is not changed. This defines CPU architecture-specific settings.}}
{{2Col|{{c|subarch}}|One subarch profile is typically enabled at build time, and defines the CPU optimizations in use.}}
{{2Col|{{c|build}}|One build profile is enabled, at build time, and is generally not changed. It defines the type of build, such as {{c|current}} or {{c|stable}}, and associated settings.}}
{{2Col|{{c|flavor}}|One flavor is enabled per system, and can be changed by the user. This defines the general use of the system, such as {{c|minimal}}, {{c|core}}, {{c|workstation}} or {{c|desktop}}}}
{{2Col|{{c|mix-ins}}|Zero or more mix-ins can be enabled that enable settings specific to a particular subset of features, such as {{c|gnome}}, {{c|kde}}, {{c|media}}, {{c|mate}}, {{c|X}}, {{c|hardened}}.}}
{{TableEnd}}
</pre>

Qual é o seguinte:

{{TableStart}}
{{2ColHead|Sub-Profile|Description}}
{{2Col|{{c|arch}}|One arch profile is enabled, at build time, and is not changed. This defines CPU architecture-specific settings.}}
{{2Col|{{c|subarch}}|One subarch profile is typically enabled at build time, and defines the CPU optimizations in use.}}
{{2Col|{{c|build}}|One build profile is enabled, at build time, and is generally not changed. It defines the type of build, such as {{c|current}} or {{c|stable}}, and associated settings.}}
{{2Col|{{c|flavor}}|One flavor is enabled per system, and can be changed by the user. This defines the general use of the system, such as {{c|minimal}}, {{c|core}}, {{c|workstation}} or {{c|desktop}}}}
{{2Col|{{c|mix-ins}}|Zero or more mix-ins can be enabled that enable settings specific to a particular subset of features, such as {{c|gnome}}, {{c|kde}}, {{c|media}}, {{c|mate}}, {{c|X}}, {{c|hardened}}.}}
{{TableEnd}}



{{tip|Essa sintaxe de tabela tem um benefício adicional de criar uma tabela responsiva que renderiza adequadamente em dispositivos móveis.}}

É possível usar as seguintes classes CSS com <code>tr</code> (linhas) e <code>td/th</code> elementos para colori-los como desejado:


{{TableStart}}
<tr class="active"><td>Class Name</td></tr>
<tr class="success"><td>success</td></tr>
<tr class="info"><td>info</td></tr>
<tr class="warning"><td>warning</td></tr>
<tr class="active"><td>active</td></tr>
<tr class="danger"><td>danger</td></tr>
{{TableEnd}}