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

== 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>. }}