Différences entre les versions de « Aide:Organiser le texte »

Le WikiHalo rappelle à ses contributeurs que toute information ajoutée doit être officielle et vérifiable. Les contributions sans sources et les théories sur Halo Infinite seront rejetées.

(Position du texte)
 
(13 versions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
__NOEDITSECTION__
__NOEDITSECTION__
Le Wikihalo utilise un système de codage par balises proche de l'HTML appelé ''Syntaxe Wiki''. Cette syntaxe remplace les fonctions de base du HTML et permet ainsi de simplifier la mise en page et la mise en forme du texte.
Le WikiHalo utilise un système de codage par balises proche du HTML appelé ''Syntaxe Wiki''. Cette syntaxe remplace les fonctions de base du HTML et permet ainsi de simplifier la mise en page et la mise en forme du texte.
 
 
Ci-dessous sont indiqués les balises utilisées sur le Wiki, en syntaxe Wiki ou en HTML. Le code entré dans la page de modification se trouve à gauche, le résultat à droite. Les notes à propos de l'utilisation de la syntaxe sont en-dessous des exemples.


Ci-dessous sont indiquées les balises utilisées sur le Wiki, en syntaxe Wiki ou en HTML. Le code entré dans la page de modification se trouve à gauche, le résultat à droite. Les notes à propos de l'utilisation de la syntaxe sont en-dessous des exemples.


==Titre==
==Titre==
Les titres servent à démarquer différentes parties dans la page, et ainsi à l'organiser par thèmes. Une telle organisation facilite à la fois la recherche dans la page, et offre un plus grand confort de lecture qu'un seul bloc de texte.
Les titres servent à démarquer différentes parties dans la page, et ainsi à l'organiser par thèmes. Une telle organisation facilite à la fois la recherche dans la page, et offre un plus grand confort de lecture qu'un seul bloc de texte.


Chaque titre de partie, quelle que soit son importance, s'affichent dans le sommaire de la page.
Chaque titre de partie, quelle que soit son importance, s'affiche dans le sommaire de la page.


Le titre est encadré par au moins deux signes "égal" (<nowiki>=</nowiki>). Plus le nombre de signes encadrant le titre est grand, moins le titre est important.
Le titre est encadré par au moins deux signes "égal" (<nowiki>=</nowiki>). Plus le nombre de signes encadrant le titre est grand, moins le titre est important.


Les titres importants correspondent à des grandes parties, et les titres moins importants constituent des sous-parties. De même, les titres encore moins important constituent des sous-partie des titres moins importants. Cette hiérarchisation des partie doit toujours être appliquée (il ne faut pas mettre de titre moins important si il n'y a pas de titre important au-dessus).
Les titres importants correspondent à de grandes parties, et les titres moins importants constituent des sous-parties. De même, les titres encore moins importants constituent des sous-parties des titres moins importants. Cette hiérarchisation des parties doit toujours être appliquée (il ne faut pas mettre de titre moins important s’il n'y a pas de titre important au-dessus).


Laissez deux lignes entre la dernière ligne de texte d'un paragraphe et un titre important, et une seule ligne entre la dernière ligne de texte d'un paragraphe et un titre de niveau inférieur. cette organisation facilite la séparation visuelle des paragraphe par importance.
Laissez deux lignes entre la dernière ligne de texte d'un paragraphe et un titre important, et une seule ligne entre la dernière ligne de texte d'un paragraphe et un titre de niveau inférieur. Cette organisation facilite la séparation visuelle des paragraphes par importance.


{| class="wikitable" width=100%
{| class="wikitable" width=100%
Ligne 36 : Ligne 34 :
*La balise <nowiki>=Titre=</nowiki> (équivalent <nowiki><h1></nowiki>) est réservée au titre de la page, et ne doit pas être utilisée.
*La balise <nowiki>=Titre=</nowiki> (équivalent <nowiki><h1></nowiki>) est réservée au titre de la page, et ne doit pas être utilisée.
*Il est possible de mettre un lien dans un titre (<nowiki>==[[Titre avec lien]]==</nowiki>).
*Il est possible de mettre un lien dans un titre (<nowiki>==[[Titre avec lien]]==</nowiki>).
*Il ne doit rien y avoir à droite et à gauche du titre (texte, image, …), où il ne sera pas mis en page.
*Il ne doit rien y avoir à droite et à gauche du titre (texte, image…), où il ne sera pas mis en page.




Ligne 47 : Ligne 45 :
|}
|}
*Le texte écrit entre les balises ''ref'' est celui qui sera affiché à la place de la balise ''references''.
*Le texte écrit entre les balises ''ref'' est celui qui sera affiché à la place de la balise ''references''.
*Si il existe des notes dans une page, la balise ''references'' devra être placée dans une section ''Notes''.
*S’il existe des notes dans une page, la balise ''references'' devra être placée dans une section ''Notes''.
 
*Il n'est pas possible en temps normal de mettre une source avec la balise ''ref'' dans une note. Il est possible de contourner le problème en utilisant le [[Modèle:NestedRef]].
 
 
==Position du texte==
Par défaut, le texte écrit se retrouvera sur la partie gauche de la page finale.
 
Afin de mettre en valeur une partie du texte ou bien d'isoler un propos particulier du reste du texte, il est possible de placer un paragraphe au centre ou à droite de la page.
 
Le centrage du texte se réalise à l'aide des balises <nowiki><center> en ouverture et </center></nowiki> en fermeture. Le texte à centrer doit se trouver entre ces deux balises.
 
Pour afficher un texte à droite, les balises <nowiki><div style="text-align: right"> en ouverture et </div></nowiki> en fermeture sont nécessaires.
 
{| class="wikitable" width=100%
| width="50%" |
<nowiki>
<center>Ce texte s'affichera au centre</center></nowiki><br><br><nowiki>
<div style="text-align: right">Ce texte s'affichera à droite</div>
</nowiki>
|
<center>Ce texte s'affichera au centre</center><br>
<div style="text-align: right">Ce texte s'affichera à droite</div>
|}
 
*Le placement au centre ou à droite peut être avantageux mais doit être utilisé avec parcimonie afin de conserver la lisibilité globale du texte.
 
 


==Listes==
==Listes==
Ligne 84 : Ligne 57 :
* Les listes sont bien pratiques :</nowiki><br><nowiki>
* Les listes sont bien pratiques :</nowiki><br><nowiki>
** Elles permettent d'organiser les données</nowiki><br><nowiki>
** Elles permettent d'organiser les données</nowiki><br><nowiki>
** Mais il ne faut pas en abuser</nowiki><br><nowiki>
**, Mais il ne faut pas en abuser</nowiki><br><nowiki>
</nowiki>
</nowiki>
|
|
* Les listes sont bien pratiques :
* Les listes sont bien pratiques :
** Elles permettent d'organiser les données
** Elles permettent d'organiser les données
** Mais il ne faut pas en abuser
**, Mais il ne faut pas en abuser
|}
|}


*Les listes sont à utiliser dans les sections Divers et Sources des pages.
*Les listes sont à utiliser dans les sections Divers et Sources des pages.
*Il n'y a aucune limite de niveau de liste, mais il est rarement nécessaire d'utiliser plus de deux niveaux.
*Il n'y a aucune limite de niveau de liste, mais il est rarement nécessaire d'utiliser plus de deux niveaux.
*Dans un tableau, il faut commencer la liste sur une nouvelle ligne et pas sur la même ligne que le symbole |


===Listes numérotées===
===Listes numérotées===
Ligne 151 : Ligne 125 :
*Peut être utilisé pour créer une liste avec un titre.
*Peut être utilisé pour créer une liste avec un titre.


==Texte masqué==
Les modèles [[:Modèle:Collapse|Collapse]] et [[:Modèle:Collapse-end|Collapse-end]] sont utilisés pour n'afficher une partie d'un article que si l'utilisateur le demande. Par exemple, pour cacher une transcription volumineuse. Consulter l'article sur [[:Modèle:Collapse|Collapse]] pour les détails d'utilisation.


==Syntaxe spéciale==
===Texte masqué===
{| class="wikitable" width=100%
{| class="wikitable" width=100%
| width="50%" |<nowiki><toggledisplay showtext="Texte affiché si non déroulé" hidetext="Texte affiché si déroulé"></nowiki><br><br><nowiki>
| width=50% |
<nowiki>{{Collapse}}</nowiki><br><nowiki>
Texte masqué</nowiki><br><nowiki>
{{Collapse-end}}</nowiki>
| width="50%" |
{{Collapse}}
Texte masqué
{{Collapse-end}}
|}
*Les vidéos ne se chargent pas correctement sur tous les navigateurs lorsqu'elles sont masquées, il ne faut donc pas les inclure.
*Si le texte masqué est une transcription, considérez de créer une sous-page dédiée au [[:Catégorie:Texte brut|texte brut]] pour faciliter la recherche dans le texte.
 
==Boîte==
Les boîtes permettent de mettre en évidence du texte dans un modèle ou certains articles bénéficiant d'une présentation non standard, comme les articles des [[succès]]. Le code utilisé est en fait un [[Aide:Tableaux|tableau]] avec une classe préconstruite.


Texte masqué</nowiki><br><br><nowiki>
{| class="wikitable" width=100%
| width="50%" |<poem><nowiki>
{| class="alerte"
|Texte en boîte.
|}
</nowiki></poem>
|
{| class="alerte"
|Texte en boîte.
|}
|}


</toggledisplay></nowiki>
==Onglets==
{| class="wikitable" width=100%
| width="50%" |<poem><nowiki>
<tabs>
<tab name="Onglet 1">
Contenu 1
</tab>
<tab name="Onglet 2">
Contenu 2
</tab>
</tabs></nowiki></poem>
|
|
<toggledisplay showtext="Texte affiché si non déroulé" hidetext="Texte affiché si déroulé">
<tabs>
<tab name="Onglet 1">
Contenu 1
</tab>
<tab name="Onglet 2">
Contenu 2
</tab>
</tabs>
|}
*Le paramètre ''style'' peut être utilisé pour modifier l'aspect des onglets.
*Les fonctions du parseur ne fonctionnent pas dans les paramètres des onglets.


Texte masqué
==Syntaxe avancée==
Les codes de mise en page avancée modifient l'organisation et l'affichage standard des articles. Pour conserver une présentation unifiée du Wiki, ces codes doivent être utilisée uniquement dans des cas particuliers.
 
{{Collapse}}
===Position du texte===
Par défaut, le texte écrit se retrouvera sur la partie gauche de la page finale.
 
Afin de mettre en valeur une partie du texte ou bien d'isoler un propos particulier du reste du texte, il est possible de placer un paragraphe au centre ou à droite de la page.
 
Le centrage du texte se réalise à l'aide des balises <nowiki><center> en ouverture et </center></nowiki> en fermeture. Le texte à centrer doit se trouver entre ces deux balises.
 
Pour afficher un texte à droite, les balises <nowiki><div style="text-align: right"> en ouverture et </div></nowiki> en fermeture sont nécessaires.


</toggledisplay>
{| class="wikitable" width=100%
| width="50%" |
<nowiki>
<center>Ce texte s'affichera au centre</center></nowiki><br><br><nowiki>
<div style="text-align: right">Ce texte s'affichera à droite</div>
</nowiki>
|
<center>Ce texte s'affichera au centre</center><br>
<div style="text-align: right">Ce texte s'affichera à droite</div>
|}
|}


*L'option showtext n'est pas obligatoire.
*Le placement au centre ou à droite peut être avantageux, mais doit être utilisé avec parcimonie afin de conserver la lisibilité globale du texte.
*L'option hidetext est obligatoire si le texte masqué est conséquent.
*Les textes affichés avec showtext et hidetext ne doivent contenir aucune apostrophe, ou le texte masqué ne pourra pas s'afficher.
*Cette balise n'est pas imbriquable, c'est-à-dire qu'on ne peut pas utiliser de texte masqué dans un autre texte masqué.


<toggledisplay hidetext=[Masquer]>
===Sommaire===
===Sommaire===
Le sommaire est un cadre blanc contenant chacun des titres contenus dans la page. En règle générale, aucune manipulation de cet élément n'est nécessaire.
Le sommaire est un cadre blanc contenant chacun des titres contenus dans la page. En règle générale, aucune manipulation de cet élément n'est nécessaire.
Ligne 226 : Ligne 258 :
*La balise <nowiki><br></nowiki> peut aussi s'écrire <nowiki><br /></nowiki>.
*La balise <nowiki><br></nowiki> peut aussi s'écrire <nowiki><br /></nowiki>.
*Préférez utiliser le double saut de ligne plutôt que la balise <nowiki><br></nowiki>, afin d'aérer le texte.
*Préférez utiliser le double saut de ligne plutôt que la balise <nowiki><br></nowiki>, afin d'aérer le texte.
*Le retour à la ligne ne doit pas être utilisé dans les modèles de navigation pour éviter d'introduire des incohérences dans l'affichage.


===Texte préformaté===
{| class="wikitable" width=100%
| width="50%" |<nowiki><poem></nowiki><poem>
S'il s'agit
    de texte préformaté
on utilise la balise poem
  qui respecte sauts de ligne et espaces</poem>
<nowiki></poem></nowiki>
|
<poem>S'il s'agit
    de texte préformaté
on utilise la balise poem
  qui respecte sauts de ligne et espaces</poem>
|}


===Texte préformaté===
{| class="wikitable" width=100%
{| class="wikitable" width=100%
| width="50%" |
| width="50%" |<poem>
<nowiki>
<nowiki>
<pre></nowiki><br><nowiki>
<pre>
S'il s'agit</nowiki><br><nowiki>
S'il s'agit
     de texte préformaté</nowiki><br><nowiki>
     de texte préformaté
on utilise la balise <pre></nowiki><br><nowiki>
        mais que vous voulez ignorer la ''syntaxe'' Wiki
  qui respecte sauts de ligne et espaces</nowiki><br><nowiki>
on utilise la balise <pre>
  et ne prend pas en compte la ''syntaxe'' Wiki</nowiki><br><nowiki>
</pre>
</pre>
</nowiki>
</nowiki></poem>
|
|
<pre>
<pre>
S'il s'agit
S'il s'agit
     de texte préformaté
     de texte préformaté
        mais que vous voulez ignorer la ''syntaxe'' Wiki
on utilise la balise <pre>
on utilise la balise <pre>
  qui respecte sauts de ligne et espaces
  et ne prend pas en compte la ''syntaxe'' Wiki
</pre>
</pre>
|}
|}


*Le même effet est obtenu en laissant une ou plusieurs espaces devant les lignes de texte concernées.
*Le même effet est obtenu sur une ligne unique en laissant une ou plusieurs espaces devant les lignes de texte concernées.
*Peu utilisé.
*Utilisé dans les citations et les transcriptions.
 
 
===Aligner du texte===
{| class="wikitable" width=100%
| width="50%" |
<nowiki><center>Le texte est affiché au centre</center></nowiki>
|<center>Le texte est affiché au centre</center>
|}
 
*Ne dois pas être utilisé dans le texte des articles. Réservé aux modèles.
 


===Ligne séparatrice===
===Ligne séparatrice===
Ligne 276 : Ligne 309 :
|}
|}


*Les lignes séparatrices n'ont pas à être utilisées dans les pages. Elle peuvent être utilisées dans les modèles ou les pages d'utilisateur.
*Les lignes séparatrices n'ont pas à être utilisées dans les pages. Elles peuvent être utilisées dans les modèles ou les pages d'utilisateur.
</toggledisplay>
{{Collapse-end}}
 


{{Aide}}


[[Catégorie:Aide]]
{{Modèle:Aide}}

Version actuelle datée du 27 mars 2021 à 09:31

Le WikiHalo utilise un système de codage par balises proche du HTML appelé Syntaxe Wiki. Cette syntaxe remplace les fonctions de base du HTML et permet ainsi de simplifier la mise en page et la mise en forme du texte.

Ci-dessous sont indiquées les balises utilisées sur le Wiki, en syntaxe Wiki ou en HTML. Le code entré dans la page de modification se trouve à gauche, le résultat à droite. Les notes à propos de l'utilisation de la syntaxe sont en-dessous des exemples.

Titre

Les titres servent à démarquer différentes parties dans la page, et ainsi à l'organiser par thèmes. Une telle organisation facilite à la fois la recherche dans la page, et offre un plus grand confort de lecture qu'un seul bloc de texte.

Chaque titre de partie, quelle que soit son importance, s'affiche dans le sommaire de la page.

Le titre est encadré par au moins deux signes "égal" (=). Plus le nombre de signes encadrant le titre est grand, moins le titre est important.

Les titres importants correspondent à de grandes parties, et les titres moins importants constituent des sous-parties. De même, les titres encore moins importants constituent des sous-parties des titres moins importants. Cette hiérarchisation des parties doit toujours être appliquée (il ne faut pas mettre de titre moins important s’il n'y a pas de titre important au-dessus).

Laissez deux lignes entre la dernière ligne de texte d'un paragraphe et un titre important, et une seule ligne entre la dernière ligne de texte d'un paragraphe et un titre de niveau inférieur. Cette organisation facilite la séparation visuelle des paragraphes par importance.

==Titre de section==

===Titre de sous-section===

====Titre de sous-sous-section====

Titre de section

Titre de sous-section

Titre de sous-sous-section

  • Ces notations sont l'équivalent des balises <h2>, <h3> et <h4> en HTML.
  • La balise =Titre= (équivalent <h1>) est réservée au titre de la page, et ne doit pas être utilisée.
  • Il est possible de mettre un lien dans un titre (==[[Titre avec lien]]==).
  • Il ne doit rien y avoir à droite et à gauche du titre (texte, image…), où il ne sera pas mis en page.


Notes

<ref group=Notes>Note</ref>

<references group=Notes />
[Notes 1]

  1. Note
  • Le texte écrit entre les balises ref est celui qui sera affiché à la place de la balise references.
  • S’il existe des notes dans une page, la balise references devra être placée dans une section Notes.
  • Il n'est pas possible en temps normal de mettre une source avec la balise ref dans une note. Il est possible de contourner le problème en utilisant le Modèle:NestedRef.

Listes

Il est inutile de rajouter un espace entre le symbole signalant la liste et le contenu de la ligne, l'affichage sera le même (« *Liste » et « * Liste » ont le même effet).

Listes à puce

* Les listes sont bien pratiques :
** Elles permettent d'organiser les données
**, Mais il ne faut pas en abuser

  • Les listes sont bien pratiques :
    • Elles permettent d'organiser les données
    • , Mais il ne faut pas en abuser
  • Les listes sont à utiliser dans les sections Divers et Sources des pages.
  • Il n'y a aucune limite de niveau de liste, mais il est rarement nécessaire d'utiliser plus de deux niveaux.
  • Dans un tableau, il faut commencer la liste sur une nouvelle ligne et pas sur la même ligne que le symbole |

Listes numérotées

# Les listes numérotées
## Sont également bien pratiques
## Bien organisées
### Faciles à lire !

  1. Les listes numérotées
    1. Sont également bien pratiques
    2. Bien organisées
      1. Faciles à lire !
  • Peu utilisé.

Listes hybrides

De plus, il est possible de mélanger les types de listes :
*Une liste numérotée :
*#Premier élément
*#Second élément
*D'autres branches à l'arborescence

De plus, il est possible de mélanger les types de listes :

  • Une liste numérotée :
    1. Premier élément
    2. Second élément
  • D'autres branches à l'arborescence
  • Peu utilisé

Listes de définition

; Listes de définitions
: Et leur définition
; Terme à expliquer
: explication du terme

Listes de définitions
Et leur définition
Terme à expliquer
explication du terme
  • Peut être utilisé pour créer une liste avec un titre.

Texte masqué

Les modèles Collapse et Collapse-end sont utilisés pour n'afficher une partie d'un article que si l'utilisateur le demande. Par exemple, pour cacher une transcription volumineuse. Consulter l'article sur Collapse pour les détails d'utilisation.

{{Collapse}}
Texte masqué
{{Collapse-end}}

Texte masqué

  • Les vidéos ne se chargent pas correctement sur tous les navigateurs lorsqu'elles sont masquées, il ne faut donc pas les inclure.
  • Si le texte masqué est une transcription, considérez de créer une sous-page dédiée au texte brut pour faciliter la recherche dans le texte.

Boîte

Les boîtes permettent de mettre en évidence du texte dans un modèle ou certains articles bénéficiant d'une présentation non standard, comme les articles des succès. Le code utilisé est en fait un tableau avec une classe préconstruite.


{| class="alerte"
|Texte en boîte.
|}

Texte en boîte.

Onglets


<tabs>
<tab name="Onglet 1">
Contenu 1
</tab>
<tab name="Onglet 2">
Contenu 2
</tab>
</tabs>

Contenu 1

Contenu 2

  • Le paramètre style peut être utilisé pour modifier l'aspect des onglets.
  • Les fonctions du parseur ne fonctionnent pas dans les paramètres des onglets.

Syntaxe avancée

Les codes de mise en page avancée modifient l'organisation et l'affichage standard des articles. Pour conserver une présentation unifiée du Wiki, ces codes doivent être utilisée uniquement dans des cas particuliers.

Position du texte

Par défaut, le texte écrit se retrouvera sur la partie gauche de la page finale.

Afin de mettre en valeur une partie du texte ou bien d'isoler un propos particulier du reste du texte, il est possible de placer un paragraphe au centre ou à droite de la page.

Le centrage du texte se réalise à l'aide des balises <center> en ouverture et </center> en fermeture. Le texte à centrer doit se trouver entre ces deux balises.

Pour afficher un texte à droite, les balises <div style="text-align: right"> en ouverture et </div> en fermeture sont nécessaires.

<center>Ce texte s'affichera au centre</center>

<div style="text-align: right">Ce texte s'affichera à droite</div>

Ce texte s'affichera au centre

Ce texte s'affichera à droite
  • Le placement au centre ou à droite peut être avantageux, mais doit être utilisé avec parcimonie afin de conserver la lisibilité globale du texte.

Sommaire

Le sommaire est un cadre blanc contenant chacun des titres contenus dans la page. En règle générale, aucune manipulation de cet élément n'est nécessaire.

Le sommaire apparaît automatiquement dès que la page contient trois titres, et se place de lui-même au-dessus du premier titre de la page.

Dans les grosses pages, il est nécessaire que le ou les paragraphe(s) introductif(s) soi(en)t placé(s) avant le sommaire pour remplir leur rôle. C'est pourquoi il ne faut pas créer un paragraphe appelé Introduction ou Présentation pour contenir ces éléments, afin qu'ils soient affichés avant le sommaire.

Codes : Il peut arriver qu'une manipulation du sommaire soit nécessaire. Voici les codes associés :

  • Masquer le sommaire :

__NOTOC__

Ce code peut être placé n'importe où dans la page, mais il doit être affiché de préférence à l'endroit où il est supposé apparaître pour plus d'organisation du code.

  • Modifier l'emplacement :

__TOC__

L'emplacement de ce code dans le code de la page définira l'endroit où il apparaît. Cet élément ne doit pas être utilisé dans les pages du Wiki, l'emplacement automatique du sommaire étant le plus pratique d'utilisation.


Retour à la ligne

Un simple saut à la ligne
n'a aucun effet.

Un simple saut à la ligne n'a aucun effet.

Une ligne vide

permet de séparer des paragraphes.

Mais une ligne vide

permet de séparer les paragraphes.

Voilà comment forcer<br>
un retour à la ligne.

Voilà comment forcer
un retour à la ligne.

  • La balise <br> peut aussi s'écrire <br />.
  • Préférez utiliser le double saut de ligne plutôt que la balise <br>, afin d'aérer le texte.
  • Le retour à la ligne ne doit pas être utilisé dans les modèles de navigation pour éviter d'introduire des incohérences dans l'affichage.

Texte préformaté

<poem>

S'il s'agit
     de texte préformaté
on utilise la balise poem
   qui respecte sauts de ligne et espaces

</poem>

S'il s'agit
     de texte préformaté
on utilise la balise poem
   qui respecte sauts de ligne et espaces


<pre>
S'il s'agit
     de texte préformaté
        mais que vous voulez ignorer la ''syntaxe'' Wiki
on utilise la balise <pre>
</pre>

S'il s'agit
     de texte préformaté
        mais que vous voulez ignorer la ''syntaxe'' Wiki
on utilise la balise <pre>
  • Le même effet est obtenu sur une ligne unique en laissant une ou plusieurs espaces devant les lignes de texte concernées.
  • Utilisé dans les citations et les transcriptions.

Ligne séparatrice

Ligne séparatrice

----

Ligne séparatrice :


  • Les lignes séparatrices n'ont pas à être utilisées dans les pages. Elles peuvent être utilisées dans les modèles ou les pages d'utilisateur.