Mostrar código-fonte de Como formatar o artigo

<span data-link_translate_fr_title="Comment formater son article"  data-link_translate_fr_url="Comment_formater_son_article"></span>[[:fr:Comment formater son article]][[fr:Comment formater son article]]
<br />

Este artigo foi traduzido por um sistema de tradução automática. Você pode visualizar a fonte do artigo [[:fr:Comment formater son article|aqui]].<br /><span data-translate="fr"></span>





<!--T:1-->
Este artigo descreve como formatar o seu tutorial. Seguindo este guia e um o [[:fr:Comment rédiger un article pour la communauté iKoula | estilo de escrita]], seu tutorial aplicará as recomendações de {{iKoula}}.


==Sintaxe wiki == <!--T:2-->

<!--T:3-->
TUTORIAIS {{iKoula}} deve ser formatada usando o [http://www.mediawiki.org/wiki/Help:Formatting sintaxe wiki].
Este artigo vai lhe dar os exemplos mais comuns desta sintaxe. Você pode encontrar mais detalhes no [http://www.mediawiki.org/wiki/Help:Formatting seção de ajuda do MediaWiki] Quanto a formatação do wiki.


==Capítulos == <!--T:4-->
Para cortar seus tutoriais em capítulos, você pode usar os níveis de título. Assim que você coloca um título na página, todos os seguintes itens serão considerados como parte do novo capítulo, até o próximo título do mesmo nível.<br />
Isso pode ser muito útil para melhorar a legibilidade do seu artigo cortando as diferentes fases de realização.<br />

===Os diferentes níveis de título === <!--T:5-->

<!--T:6-->
O título do nível 1 corresponde ao título do artigo. Ele é criado automaticamente quando você criar sua página. As faixas são construídas em torno de seu título por sinais "'''='''". O título do nível 2 corresponde ao primeiro título de capítulo ou seção. <br />
Exemplo para o título desta seção :<br />
 <nowiki             >==Capítulos ==</nowiki><br />

Mais você vai assinar em torno de seu título, quanto mais você descer da árvore.<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >===Nível de título 3===</nowiki>
 <nowiki             >====Nível de título 4====</nowiki>
 <nowiki             >=====Nível de título 5=====</nowiki>
| style="estofamento : 5PX ;"|
===Nível de título 3=== <!--T:7-->
====Nível de título 4====
=====Nível de título 5=====
|}
<br />
É interessante notar que uma tabela de conteúdo aparece automaticamente na cabeça do artigo, assim como existem pelo menos 4 capítulos ou subcapítulos.
<br /><br />

==Estilos == <!--T:56-->

Você pode formatar o texto usando a sintaxe wiki e algumas tags HTML.
<br />
===Bold (realce) === <!--T:8-->

<!--T:9-->
Aqui está como acabar em negrito em seu artigo.
<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >'''texto bold (realce) '''</nowiki>
| style="estofamento : 5PX ;"|
'''texto bold (realce) '''
|}
<br />
Aqui está uma lista de itens que devem ser em negrito.
* Texto visível de uma GUI 
* Mudança de contexto para um controle, como alterar o usuário ou servidor 
* Hostnames como '''Servidor - 1'''
* Como usuários '''ikoula '''
* Rápida 
* Lista de termos, como :
** '''MySQL ''': mecanismo de banco de dados 
** '''Apache ''': webserver 
* Elementos que o jogador não deve perder, fazê-lo sem muita coisa.
<br />

===Italic === <!--T:10-->

<!--T:11-->
Itálico só deve ser usado para introduzir termos técnicos. Por exemplo : o nginx servidor será usado como ''proxy reverso ''.
<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >''em itálico texto ''</nowiki>
| style="estofamento : 5PX ;"|
''em itálico texto ''
|}
<br />

===Notas e avisos === <!--T:12-->

<!--T:13-->
O uso de algumas tags HTML pode ser necessário destacar certos elementos, tais como notas ou avisos.
<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
<syntaxhighlight lang="html4strict">
<div style="background-color: #FFCC99;"> '''Note''': Ceci est une note.</div>
</syntaxhighlight>
<br />
<syntaxhighlight lang="html4strict">
<div style="background-color: #FF9999;"> '''Warning''': Ceci est un avertissement.</div>
</syntaxhighlight>
| style="estofamento : 5PX ;"|
<div style="background-color: #FFCC99;">'''Note''': Ceci est une note.</div>
<br />
<div style="background-color: #FF9999;">'''Warning''': Ceci est un avertissement.</div>
|}
<br /><br />

===Blockquotes === <!--T:14-->

<!--T:15-->
O ''Blockquotes '' são blocos onde seu texto é formatado de forma diferente. Para fazer isso, basta colocar um espaço no início da frase, ou coloque seu texto das tags <nowiki             ><pre></nowiki>. Votre texte sera alors formaté dans un cadre avec une police différente.
<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
<nowiki             > Importante texto ''em itálico ''</nowiki><br />
ou <br />
<nowiki             ><pre>Texte important ''em itálico ''</pre></nowiki>
| style="estofamento : 5PX ;"|
 Importante texto ''em itálico ''
ou <br />
<pre>Texte important ''em itálico ''</pre>
|}
Como você observou, o uso da tag <nowiki             ><pre></nowiki> fait que tout autre formatage à l'intérieur du bloc sera ignoré et considéré comme du texte à afficher. Si vous utilisez la première méthode, avec l'espace en début de ligne, sachez qu'un retour à la ligne fermera le cadre.<br />
Nous préconisons d'Use a tag [[#Code_source|GeSHi]] ou la méthode des [[#Notes_et_avertissements|notes et avertissements]] pour afficher du code source ou des informations importantes.
<br />

===Code source=== <!--T:16-->

<!--T:17-->
Lorsque vous publiez un code source, vous devez appliquer la balise <nowiki             ><syntaxhighlight></nowiki>. Cela permettra à votre code de bénéficier d'une coloration syntaxique, le rendant plus lisible. Afin d'adapter la coloration au langage utilisé, ajoutez l'option ''lang="langage"'' dans la balise.
<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
<nowiki             ><syntaxhighlight lang="php"></nowiki><br />
<nowiki             ><?</nowiki><br />
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki             >    $hello = "Hello World";</nowiki><br />
&nbsp;&nbsp;&nbsp;&nbsp;<nowiki             >    echo $hello;         // comment</nowiki><br />
<nowiki             >?></nowiki><br />
<nowiki             ></syntaxhighlight></nowiki>
| style="estofamento : 5PX ;"|
<syntaxhighlight lang="php">
<?
    $hello = "Hello World";
    echo $hello;         // comment
?>
</syntaxhighlight>
|}
<br />
Vous trouverez sur le site de l'extension [http://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi GeSHi] la liste des langages supportés et quelques options supplémentaires, telle l'ajout de numéros de ligne ou la mise en évidence d'une ligne dans le code.
<br /><br />

==Référence à une application== <!--T:18-->

<!--T:19-->
Lorsque vous mentionnez une application, préférez utiliser la capitalisation du site officiel. Si le site web n'est pas consistent, choisissez une forme et essayez de l'être dans votre article.
<br />
Par contre, ne capitalisez pas les noms de paquets ou des commandes, si ces derniers ne le sont pas.
<br />
Exemplo  :<br />
 A MySQL  database vs. the mysql command or the mysql-server package.
<br /><br />

==Listes== <!--T:20-->

A chaque type de liste son utilisation.
<br />
===Listes non-ordonnées=== <!--T:21-->

<!--T:22-->
Ces listes sont utiles pour :
* les prérequis
* les checklists
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >* élément 1
* élément 2</nowiki>
| style="estofamento : 5PX ;"|
* élément 1
* élément 2
|}
<br />

===Listes de définitions=== <!--T:23-->

<!--T:24-->
Ces listes sont utiles pour :
* les termes et explications
* explications pour les variables dans une ligne de commande ou un fichier
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >;mot 1
: définition 1
;mot 2
: définition 2-1
: définition 2-2</nowiki>
| style="estofamento : 5PX ;"|
;mot 1
: définition 1
;mot 2
: définition 2-1
: définition 2-2
|}
<br />

===Listes ordonnées=== <!--T:25-->

<!--T:26-->
O listes ordonnées sont à utiliser avec parcimonie. Elles peuvent s'avérer pratiques pour lister l'ordre d'un processus, tel que le traitement d'une requête DNS.
<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             ># élément 1
# élément 2</nowiki>
| style="estofamento : 5PX ;"|
# élément 1
# élément 2
|}
<br />
Ces listes sont utiles pour :
* décrire un processus de traitement
Dans certains cas, l’utilisation d'un tableau sera préférable aux listes.
<br /><br />

===Tableaux=== <!--T:27-->

<!--T:28-->
Voici un exemple simple de tableau. Cela peut être utile pour présenter plus facilement un code exemple et son résultat. O tableaux sont structurés comme suit.

<!--T:57-->
{|cellestofamento ="5" border="1" style="border-collapse:collapse;"
|'''<nowiki             >{|</nowiki>''' || début de '''tableau'''
|-
|'''<nowiki             >|+</nowiki>''' || '''descriptif''' du contenu, ''optionnel;'' un seul par tableau positionné entre le début du tableau et la première ligne
|-
|'''<nowiki             >|-</nowiki>''' || '''début de ligne''', ''optionnel sur la première ligne'' -- le moteur de wiki prend en charge la première ligne
|-
|'''<nowiki             >!</nowiki>'''  || cellule '''entête''', ''optionnel.'' O entêtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit sur des lignes séparées, chacune ayant son unique point d'exclamation (!).
|- 
|'''<nowiki             >|</nowiki>'''  || cellule de '''donnée''' , ''requis!'' O cellules de données consécutives d'un tableau peuvent être soit mises sur la même ligne séparées par une double barre verticale (<nowiki             >||</nowiki>), soit sur des lignes séparées, chacune ayant son unique barre verticale (<nowiki             >|</nowiki>).
|-
|'''<nowiki             >|}</nowiki>''' || '''fin de tableau'''
|}

<!--T:58-->
<br />
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
<pre>
{|
|Orange 
|Apple 
|-
|Pão 
|Torta 
|-
|Manteiga 
|Sorvete 
|}
</pre>
| style="estofamento : 5PX ;"|
{|
|Orange 
|Apple 
|-
|Pão 
|Torta 
|-
|Manteiga 
|Sorvete 
|}
|}

<!--T:29-->
Para obter mais informações sobre tabelas, favor consultar o [https://www.mediawiki.org/wiki/Help:Tables/fr Manual wikimedia]<br />

==Scripts  e arquivos == <!--T:30-->

<!--T:59-->
Certifique-se de descrever o papel dos arquivos ou scripts que você menciona. Desta forma, o leitor terá o mesmo nível de informações que você e será mais capaz de entender a sua abordagem.
<br />

===Scripts === <!--T:31-->
Quando você dá o conteúdo de um script ou um arquivo de configuração, certifique-se que é comentado, de preferência a nível das linhas em questão. O objetivo é que o leitor compreender todas as ações descritas, por isso é importante ser mais educativo quanto possível. Desta forma, será mais capaz de personalizar, actualizar ou diagnosticar problemas com o seu servidor a longo prazo.
<br /><br />
Se os arquivos que você postar tem peças longas e /ou não é interessante para o seu tutorial, você pode omitir estas festas com a elipse '''(...)'''.
<br />
Recomendamos o uso da [[:fr:#Code_sourceGeSHi |Balise]] para exibir o conteúdo dos scripts ou arquivos. Este último lhe permitirá, além do realce de sintaxe, basta indicar os números das linhas e destacar o mais importante. É recomendável que você usar o realce para indicar as linhas onde existem alterações para executar.
<br />

<!--T:60-->
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             ><syntaxhighlight lang="apache" line start="10" highlight="5">
<VirtualHost *:80>
    DocumentRoot /www/example1
    ServerName www.example.com
    # Other directives here
</VirtualHost>
</syntaxhighlight></nowiki>
| style="estofamento : 5PX ;"|
<syntaxhighlight lang="apache" line start="10" highlight="5">
<VirtualHost *:80>
    DocumentRoot /www/example1
    ServerName www.example.com
    # Other directives here
</VirtualHost>
</syntaxhighlight>
|}
<br />

===Arquivo === <!--T:36-->

<!--T:37-->
Você tem a possibilidade de inserir um arquivo ou uma imagem no seu tutorial. A maneira mais simples de conseguir a coisa é mencionar o documento em seu artigo, depois de colocar online uma vez concluída a escrita. Se o arquivo não existir, ele será ser apontado por um link vermelho. Clicando neste link, você chegará a uma página que lhe permite fazer upload de seu arquivo.
<br />

<!--T:38-->
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >[[Media:mon_fichier.txt]]</nowiki>
| style="estofamento : 5PX ;"|
[[Media:mon_fichier.txt]]
|}

<!--T:39-->
É interessante notar que o link para o arquivo depende exclusivamente o nome do arquivo. É recomendável que você use nomes como descritivos como arquivos possíveis. Não se esqueça de incluir uma descrição do arquivo quando você colocá-lo on-line.
<br /><br />

===Imagens === <!--T:40-->

<!--T:41-->
O images sont considérées comme des fichiers. Vous pouvez donc les inclure et les mettre en ligne de la même manière que les fichiers.<br />
A única diferença com um arquivo é que a imagem será exibida no texto. O que lhe dá mais opções para exibir.
<br /><br />
A sintaxe para cumprir é :
 <nowiki             >[[File:sample_image.jpg|options|description]]</nowiki>
O options et la description sont facultatives.
<br />

<!--T:61-->
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >[[File:sample_image.jpg|200px|thumb|right|modèle image]]</nowiki>
* '''200PX ''' : tamanho para exibir 
*<span class="notranslate"> '''thumb'''</span> : a imagem é com tinta em um cenário que irá mostrar a descrição <br />
* <span class="notranslate">'''right'''</span> : alinhamento da imagem certa 
| style="estofamento : 5PX ;"| [[File:sample_image.jpg|200px|thumb|right|modèle image]]
|}

<!--T:62-->
<br />
Você pode encontrar mais informações sobre as diferentes opções disponíveis sobre a manipulação de imagem sobre o [http://www.mediawiki.org/wiki/Help:Images/fr manual do MediaWiki].<br />
Evite usar imagens muito pesadas e preferem usar formatos jpg, jpeg e png.
<br /><br />

==Chaves de teclado == <!--T:42-->

<!--T:43-->
Para descrever as teclas do teclado, siga estas recomendações :
* escrevê-los em letras maiúsculas 
* Use a tag <nowiki             ><span></nowiki>
* utiliser le symbole '''+''' si elles doivent être pressées simultanément

<!--T:44-->
{| style="largura :100%"
! style="largura : 50%;"|Exemplo 
! style="largura : 50%;"|Resultado 
|-
| style="estofamento : 5PX ;"|
 <nowiki             >Suporte na <span style="background-color: #E6E6E6;">CTRL</span>+<span style="background-color: #E6E6E6;">ALT</span>+<span style="background-color: #E6E6E6;">SUPP</span> Então '''Gerenciador de tarefas '''</nowiki>
| style="estofamento : 5PX ;"|
Suporte na <span style="background-color: #E6E6E6;">CTRL</span>+<span style="background-color: #E6E6E6;">ALT</span>+<span style="background-color: #E6E6E6;">SUPP</span> Então '''Gerenciador de tarefas '''
|}
<br />

==Nomes de host == <!--T:45-->

<!--T:46-->
É recomendável que você usar nomes de host o mais específico possível, que é em relação ao papel do servidor.<br />
Exemplo  :
* dns_serveur 
* bdd_master 
* proxy_nginx 
* etc.
<br />

==Nomes de domínio == <!--T:47-->

<!--T:48-->
Quando você está lidando com nomes de domínio, prefiro usar o campo '''Domain.TLD ''' como o domínio padrão.
Se você tiver vários nomes de domínio para mencionar, você pode escolher usar nomes como '''domínio - 1TLD ''', '''domínio - 2TLD '''etc. |
<br /><br />
Para subdomínios, recomendamos que você use um nome em conexão com o papel para o qual será anexado este subdomínio, como '''master.Domain.TLD ''', '''slave.Domain.TLD ''', '''bdd.Domain.TLD '''etc. |
<br /><br />

==Endereços IP == <!--T:49-->

<!--T:50-->
Para evitar para divulgar seu IP em seus tutoriais e ser o mais claro possível, nós convidamos você a conhecer o [https://en.wikipedia.org/wiki/Reserved_IP_addresses endereços reservados] a documentação. No nosso caso, nós preferimos usar o bloco de endereços '''203.0.113.0/24''' por tudo o que é o endereço público. Qualquer '''203.0.113.0''' à '''203.0.113.255'''.
<br /><br />
Para os endereços de redes locais e localhost, você pode manter o IP que você costuma usar. Significa :
* '''10.0.0.0/8''' - 10.0.0.0 – 10.255.255.255
* '''172.16.0.0/12''' - 172.16.0.0 – 172.31.255.255
* '''192.168.0.0/16''' - 192.168.0.0 – 192.168.255.255
* '''127.0.0.0/8''' - 127.0.0.0 – 127.255.255.255
<br /><br />

==Ligações == <!--T:51-->
{{:Créer_un_lien}}

==Screenshots == <!--T:52-->

<!--T:53-->
Se seu tutorial descreve as acções a realizar em uma interface gráfica, é melhor incluir capturas de tela para torná-la mais clara.
Tenha cuidado, porém não ser também. Não é questão de ter uma imagem para cada botão, texto ou link caixa, mas apenas o que é preciso para drive bem sucedido para segui-lo.
<br />
Se você deseja capturar destacar itens, por favor, sinta-se livre para adicionar setas ou frames para o ponto. Isto só será o tutorial só abrangente.
<br /><br />
Nous vous recommandons de mettre en gras les éléments que vous mentionnez et qui sont dans l'interface graphique, que ce soit un bouton, un lien, une case à cocheretc. |
<br />
Não se esqueça de adicionar uma descrição, quando você virar a imagem on-line.
<br /><br />

==Conclusão == <!--T:54-->
Por favor, inclua uma conclusão curta para o seu tutorial que irá resumir o que foi feito e apresentar o que pode ser feito posteriormente.
<br />
Você tem tudo que você precisa para criar seus próprios artigos ! Além disso, você também pode consultar o nosso artigo sobre o [[:fr:Comment rédiger un article pour la communauté iKoula | estilo iKoula]]e boa escrita !


<!--T:55-->
Este artigo pareceu-lhe ser útil ? <vote />

[[Category:Contribuir]]
<br />
<comments />