Aide:Section

This page is a translated version of the page Help:Section and the translation is 100% complete.
PD Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur le projet Aide dans le domaine public. PD

La syntaxe du titre de section permet à une page d'être divisée en sections.

Créer des sections et les numéroter

Pour créer une section définissez son titre de la manière suivante :

== Section ==

=== Sous-section ===

==== Sous-sous-section ====

Instructions pour utiliser le titre des sections

  • Les entêtes avec un signe égal seulement sur le côté (=texte ici=) génèrent un titre qui a la taille du nom de la page.
  • Le titre de section ne peut pas être combiné avec un autre contenu sur la même ligne. Par exemple, le ==Titre de section==<br> ne sera pas représenté comme un entête mais come un paragraphe.
  • Les noms des sections doivent être uniques dans une page, y compris les noms des sous-sections. Les inconvénients de dupliquer les noms de section comprennent :
    • Confusion dans les modifications - Plusieurs sections ayant le même titre peuvent causer une confusion d'édition, entraînant des erreurs et rendant difficile pour les contributeurs de modifier avec précision le contenu
    • Résumés de modification ambigus - MediaWiki génère des résumés de modification pour les modifications de pages, mais si plusieurs sections ont le même titre, ils peuvent devenir ambigus. Par exemple, le résumé de l'édition de deux sections Diète pourrait être "J'ai édité la section Diète", confondant les contributeurs et rendant difficile l'examen des changements modifications récentes efficacement.
  • Vous pouvez créer des sections séparées sur différentes pages avec leurs propres historiques de modification en utilisant un modèle/page. Chaque modèle/page peut être inséré dans une page principale, en ajoutant le contenu sans changer l'apparence globale. Cette configuration facilite le suivi des modifications et la gestion de parties spécifiques d'une page. (Voir les Utilisations possibles des modèles).
  • Un modèle avec des sections dans une nouvelle page conserve l'ordre d'origine, fusionnant le contenu avant et après le modèle. Cela garantit une numérotation adéquate des sections du modèle, sans affecter la numérotation des sections de la page principale.
    Cette fonctionnalité n'est pas prise en charge dans les habillages qui affichent un tableau de contenu en dehors du contenu de l'article, comme l'habillage Vector 2022.
  • Une entête de section en wikicode sur MediaWiki vérifie l'expression régulière /(^={1,6}.*?={1,6}\s*?$)/m (m fait référence au mode multilignes).

Table des matières

Cette fonctionnalité n'est pas prise en charge dans les habillages qui affichent un tableau de contenu en dehors du contenu de l'article, comme l'habillage Vector 2022. Dans l'habillage Vector 2022, le sommaire est même généré avec une seule section.

Un sommaire (TOC)[1] est automatiquement généré pour les pages qui contiennent plus de trois entêtes de sections. Néanmoins les éditeurs peuvent choisir de ne pas afficher le sommaire en ajoutant le mot magique __NOTOC__ (entouré de chaque côté par des doubles caractères de soulignement) dans la boîte d'édition de l'article.

Instructions pour utiliser le sommaire

  • Une TOC est ajoutée au wikicode, redéfinissant __NOTOC__ lorsque soit __FORCETOC__ ou __TOC__ (avec les deux caractères de soulignement de chaque côté du terme) est ajouté même si la page a moins de quatre titres.
  • L'utilisation de __FORCETOC__ force l'affichage de la TOC[1] avant le titre de la première section tandis que __TOC__ la met là où voulez qu'elle commence permettant ainsi un positionnement plus souple comme par exemple alignée à droite, ou bien à l'intérieur d'une cellule de tableau.
  • __TOC__ conditionne le positionnement de la TOC dans un article. Placez __TOC__ où vous souhaitez que la TOC apparaîsse, comme après l'introduction ou à la fin de la page. Cela vous assure que la TOC sera au bon endroit sans lui ajouter de titre.
  • En utilisant __NOTOC__ vous supprimez l'affichage automatique de la TOC sur la page. Si vous souhaiter construire manuellement votre propre TOC, vous devez créer les liens vers les diverses sections de la page en utilisant les titres comme == A ==, puis les référencer en utilisant les liens de section tels que [[#A|A]]".

Résumé :

Mot Explication
__NOTOC__ La TOC[1] de la page actuelle est masquée.
__FORCETOC__ rendre le sommaire affichable.
__TOC__ Ajoute la TOC quelque part sur la page, redéfinissant ainsi toute déclaration de __NOTOC__. Si le mot magique __TOC__ figure plusieurs fois, seul le premier est interprété.

Déplacer la table des matières

Le code ci-dessous permet que la TOC soit placée comme une table flottante alignée sur le côté droit de l'écran.

  {| align="right"
  | __TOC__
  |}

Limiter la profondeur globale du sommaire

Vous pouvez contrôler la profondeur de la TOC en ajustant la valeur de $wgMaxTocLevel dans le fichier LocalSettings.php . Par exemple, en le fixant à 3, la TOC sera affichée qu'avec trois niveaux de profondeur au maximum.

Lier une section

Les entêtes de section vont générer le HTML directement avec l'attribut id, et pourront être directement référencées soit à partir de la page elle-même ou des autres pages.

Par exemple, le code HTML qui a été créé au début de cette section pour la version anglaise de cette page est :

<h2><span class="mw-headline" id="Linking_to_a_section">Linking to a section</span></h2>

Un lien vers cette (section) apparaîtra comme :

[[Help:Section/fr#Linking to a section|Lier une section]]

Vous pouvez pointer sur une section à l'intérieur d'une même page en utilisant [[#lien de section|texte affiché]], et dans une page différente en utilisant [[nom de la page#nom de la section|texte affiché]].

Un lien vers une sous-section, une sous-sous-section, etc. sera [[#nom de la sous-section]] et [[#nom de la sous-sous-section]] etc. car les ancres ne tiennent pas compte du niveau d'indentation de la section.

Les noms de sections dupliquées sont désignés en ajoutant un caractère de soulignement avec un numéro. Par exemple, s'il y a trois sections nommées Exemple, elles seront étiquetées Exemple, Example_2 et Example__3. Cependant, lors de la modification des sections Example_2 ou Example__3, le résumé de la modification se rapportera confusément à Exemple. Une espace commençant le titre d'une section déforme la TOC.

Lier une section à l'aide d'un identifiant arbitraire

Les ancres des liens de section peuvent changer sans préavis, surtout lorsqu'un article contient plusieurs sections portant le même nom. Des identifiants supplémentaires tels que " 2", " 3 ", etc., sont ajoutés pour distinguer ces sections. Si une section est ajoutée, supprimée ou renommée, elle peut modifier la destination du lien, ce qui peut diriger vers des sections incorrectes ou inexistantes. Cela peut être évité en utilisant la balise HTML ‎<span> avec l'attribut id :

<span id="nonDeLancre"></span>

Veuillez veiller à ce que le nom choisi soit unique en incorporant des titres abrégés provenant de sections de niveau supérieur, comme Ontario-Natural_features pour la sous-section "Caractéristiques de la nature" dans la section "Ontario" d'un article sur les provinces canadiennes. Cette méthode peut ne pas fonctionner avec les anciens navigateurs, en particulier ceux d'avant MediaWiki 1.4.10, et elle peut ne pas même fonctionner avec les navigateurs modernes si id contient des espaces. Par exemple :

<span id="Caractéristiques de la nature en Ontario">(texte facultatif)</span> [ne fonctionnera pas]
<span id="Caractéristiques naturelles de Terre-Neuve">(texte facultatif)</span> [va fonctionner]
...
Voir [[#Caractéristiques naturelles de l'Ontario|caractéristiques naturelles de l'Ontario]] et [[#Caractéristiques naturelles de Terre-Neuve|caractéristiques naturelles de Terre-Neuve]]

Remplacer toutes les espaces dans id par des caractères de soulignement pour s'assurer que les liens fonctionneront de la même manière à la fois avec des caractères de soulignement qu'avec des espaces.

Voir l'ancrage manuel pour lier toute section d'une page.

Lier les sections et les redirections

Le lien vers une section spécifique d'une page par l'intermédiaire de Help:redirect fonctionne généralement de la même manière que le lien direct vers cette section.

Le renommage d'une page génère un redirection, mais le renommage d'une section ne le fait pas. De plus il n'existe pas de fonctionnalités particulières des liens arrière pour les sections ; les pages qui pointent vers une section sont listées parmi les pages qui pointent vers la page entière.Pour corriger ces problèmes :

  • Au lieu de pointer directement sur une section, utilisez une page qui redirige vers la section. Cette approche facilite le suivi des modifications des noms de section et fournit une fonctionnalité Pages liées pour les sections. Pour identifier les liens de section, vérifiez les redirections pointant sur la page et sélectionnez la page qui correspond.
  • Insérer une ancre dans la section et pointez-la en conséquence.
  • Ajoutez un commentaire au début d'une section du wikicode, en listant les pages qui pointent vers cette section.
  • Créer une page ou un modèle séparé pour la section et soit vous la transcluez dans la page parent ou vous y créez un lien vers elle. Ensuite, au lieu de pointer directement sur la section, pointez sur page séparée ou le modèle.

Les pages de redirection peuvent être classées en ajoutant la balise de catégorie après la commande de redirection. Si le redirection mène à une section, cela catégorise aussi cette section. Toutefois, la section à l'inverse ne renvoie pas à la catégorie à moins de faire cela spécifiquement. Sur les pages des catégories, les redirections sont affichées en italiques. Pour plus de détails, voir Catégoriser les redirections.

Modifier des sections

Pour modifier des sections spécifiques d'une page, vous pouvez cliquer sur le lien "[modifier]" à côté de l'entête de la section correspondante. En cliquant sur ces liens, vous allez aller sur une page de modification avec une URL structurée ainsi :

https://www.mediawiki.org/w/index.php?title=Help:Advanced_editing&action=edit&section=9

Au lieu d'utiliser les titres des sections, la modification des sections utilise le numéro des sections. Les sous-sections sont représentées avec un seul numéro (par exemple, dans le lien ci-dessus, la section 2 de la TOC est numérotée 9 dans le lien. Cela permet une édition axée sans avoir besoin de voir le texte entier de la page. C'est particulièrement utile pour les longues pages, car cela simplifie le processus d'édition et réduit le désordre. L'ajout de la modification de la section __NOEDITSECTION__ via une URL que vous avez déjà fonctionne toujours.

Lors de l'insertion d'une section, modifiez la section précédente ou la suivante, fusionnez en supprimant l'entête si nécessaire et ajustez le résumé de la modification en conséquence.

Ajouter une section à la fin

Pour ajouter une nouvelle section à la fin d'une page, vous pouvez utiliser une URL comme :

https://www.mediawiki.org/w/index.php?title=Project:Sandbox&action=edit&section=new

Sur les pages de discussion et sur les pages où il y a du wikicode, vous pouvez utiliser le code __NEWSECTIONLINK__ pour générer un lien spécial à côté de l'onglet de modification intitulé ⧼skin-action-newsection⧽. En cliquant sur ce lien, une boîte de texte s'ouvre où vous pouvez saisir un titre pour la nouvelle section. Le résumé des modifications est généré automatiquement. Le résumé de la modification qui sera produit sera /* Nome de section */ /* Nome de section */ nouvelle section, qui est rendu automatiquement par une flèche droite. Cela ne laisse aucune option pour fournir un résumé de modification personnalisé.

Si la case du sujet est laissée vide, aucun délimiteur == ==  vide n'est inséré, et le contenu est concaténé à la dernière section de la page. Cette approche ne permet pas de créer une nouvelle section sans titre ni de fournir un résumé des modifications. Le paramètre "Preloadtitle" détermine le premier texte affiché dans le champ "Objet / titre" :

https://www.mediawiki.org/w/index.php?title=Project:Sandbox&action=edit&section=new&preloadtitle=pqr

Le préchargement peut être modifié avant de le sauvegarder.

Modifier avant la première section

Généralement, il n'y a pas de lien désigné pour la modification du texte d'introduction avant le titre de la première section (phab:T2156). Cependant, vous pouvez appliquer la fonction d'édition de section à cette partie en utilisant zéro (0) comme numéro de section dans le lien, de cette manière :

https://www.mediawiki.org/w/index.php?title=Help:Advanced_editing&action=edit&section=0

Alternativement, vous pouvez modifier n'importe quel lien de modification de section sur la page en changeant le numéro de la section.

Pour générer la même URLen utilisant JavaScript, voir w:Wikipedia:WikiProject User scripts/Scripts/Edit Top.

Voir Help:Section editing demo .

Aperçu

L'aperçu de la modification de section peut différer de la page complète si une image d'une section précédente vient chevaucher la section actuelle.

La page de modification affiche tous les modèles utilisés sur l'ensemble de la page, y compris ceux des autres sections.

Travailler avec les sous-sections

Lorsque vous modifiez une section, les sous-sections sont incluses et numérotées relativement à la partie modifiée en commençant par 1. Les sous-sections sont numérotées avec des chiffres tels que 1.1, 1.2, etc. Le format de l'entête suit le niveau absolu avec les sous-sections numérotées en conséquence. Par exemple, une sous-section de 3.2 serait numérotée 3.2.1, 3.2.2

Modifier une page avec de grandes sections

Si une page a de grandes sections ou n'est pas divisée en sections, les utilisateurs peuvent toujours modifier son contenu avec :

  • Commencer par une ligne vide avant le titre de la nouvelle section, et ajouter une section en fournissant un grand numéro de section.
  • Ajouter du contenu à la dernière section sans titre, mais ne pas pouvoir revenir en arrière ou modifier le nouveau texte en raison des limitations de navigateur ou de la connexion.

Modifier les sections des modèles inclus

Vous pouvez modifier les sections dans les pages ou les modèles inclus. Cliquer sur le lien de modification d'une section vous amène sur une page de modification séparée. Cette section (transcluse de Help:Section/Modifier les sections des modèles inclus ) montre comment cela fonctionne.

La taille de la section à l'intérieur de la page ou du modèle inclus est déterminée par les rubriques de la page principale où elle est incluse. En outre, les textes avant le premier titre de la page séparée font partie de la section, mais en cliquant sur son lien de modification, le texte ne sera pas affiché. De même, s'il y a des textes après la balise du modèle sans titre, vous devez cliquer sur les titres avant le modèle pour les modifier. Cette section en décrit le fonctionnement. Pour assurer la clarté et la cohérence des pages parentes traduites, suivez ces recommandations :

  • Structure du modèle - Évitez de placer le texte avant le premier titre dans un modèle.
  • Gestion des sections - Après avoir utilisé un modèle avec des sections, commencez une nouvelle section sur la page parente. Cela empêche les conflits entre les sections du modèle et les sections page parente.

En outre, considérez les pratiques suivantes pour gérer efficacement les modèles :

  • Titre du modèle - Parfois, il est utile de commencer un modèle par un titre, même s'il n'y a qu'une seule section. Ceci rend l'édition plus facile.
  • Utilisation des paramètres - Lorsque vous modifiez des modèles, rappelez-vous que les paramètres, tels que {{{1}}}, sont modifiés dans la page d'appel, et non directement dans le modèle. Bien que cela ne soit pas immédiatement évident dans la page rendue, fournir un texte explicatif ou un lien de modification supplémentaire peut améliorer la compréhension de l'utilisateur.
  • balise NOEDITSECTION - La balise __NOEDITSECTION__ affecte le modèle et les pages auxquelles il est ajouté, ainsi que les autres modèles de la même page. Sinon essayez de remplacer le balisage du titre de section MediaWiki par le balisage HTML du titre dans le modèle, afin que les titres restent visuellement cohérents tout en évitant d'être reconnus comme des sections modifiables. Cette approche supprime le besoin de __NOEDITSECTION__ dans le modèle.

Par exemple, pensez à un modèle structuré ainsi :

==Titre du modèle 1==
Contenu
===Titre du modèle 2===
Contenu

Pour éviter que les liens Modifier la section n'apparaissent lors de la transclusion d'un modèle, ajoutez NOEDITSECTION dans le code du modèle. Cependant, cela supprime tous les liens Modifer la section sur les pages où le modèle est utilisé. Alternativement, structurer le modèle avec des balises d'entête HTML (‎<h2>, ‎<h3>, etc.) permet d'obtenir le même effet visuel sans affecter les liens de modification des autres sections sur les pages qui transcluent.

<h2>Titre du modèle 1</h2>
Contenu
<h3>Titre du modèle 2</h3>
Contenu

Sections dans une fonction d'analyse syntaxique

Lorsqu'un modèle est transclus conditionnellement avec des sections en utilisant une fonction d'analyse syntaxique , les liens de modification de ces sections peuvent pointer vers la mauvaise section ou afficher un message d'erreur disant que cette section n'existe pas. Cela se produit parce que le contenu des modèles inclus conditionnellement est considéré comme faisant partie de la page elle-même, ce qui fait que les sections ne sont comptées qu'après l'expansion.

En conséquence, les liens de modification des sections du modèle inclus renvoient à la page plutôt qu'au modèle, et les liens d'édition ultérieurs se réfèrent à la page correcte mais avec des numéros de section incorrects. Ce problème ne se pose pas lors de la transclusion d'un modèle avec un nom conditionnel, ce qui offre des avantages supplémentaires.

Modifier les notes de bas de page

Pour modifier une note de bas de page dans une section en utilisant ‎<references />, cherchez la section avec la marque du pied de page et modifiez-la. Voir Help:Footnotes pour plus d'aide.

Afficher une section

Vous pouvez utiliser la fonctionnalité de modification de section pour afficher une section spécifique sans avoir à charger la page complète.

Sections ou pages séparées avec des transclusions

Chacune a ses avantages :

Avantages d'une grande page avec des sections :

  • Accès plus rapide et recherche plus simple par rapport à devoir accèder à plusieurs pages plus petites.
  • Conserve la cohésion conceptuelle pour les sujets complexes.

Avantages des pages séparées :

  • Navigation facile et édition avec des liens et des historiques séparés en utilisant la fonctionnalité des pages liées .
  • Temps de chargement plus rapides grâce à la taille réduite des pages.
  • Redirection automatique suite au renommage.
  • Amélioration de l'organisation et de la gestion des données par la catégorisation et l'annotation indépendantes.
  • Seuls quelques modèles limitent leur application par page.

Avantages des documents composés par Transclusion  :

  • Transclusion implique l'inclusion du contenu d'une page dans une autre, souvent réalisée au travers de modèles.
  • Les utilisateurs peuvent naviguer et chercher dans la page rendue combinée, ce qui améliore la convivialité.

Inconvénients :

  • Les utilisateurs ne peuvent pas rechercher directement dans le wikicode combiné.
  • Il peut être difficile de fournir un titre pour chaque page incluse.
  • Il existe une limitation liée à la taille des inclusions développées après coup, pouvant créer des problèmes techniques potentiels, particulièrement si les pages incluses sont trop longues ou que le nombre d'inclusions est trop grand.

Sections et sommaire (ToC)

Ajouter du texte hors section au sommaire

Vous pouvez marquer un texte pour qu'il devienne une entrée de la TOC en utilisant les balises d'entête ‎<h4>...‎</h4>. Personnalisez la mise en forme comme d'habitude à l'intérieur de ces balises. Un exemple d'utilisation (le second est mieux formaté pour la clarté) :

{| class="collapsible collapsed" style="text-align:left; border:0px; margin-top:0.2em"
|-
! style="background-color:#f2dfce" | <h4>sujet</h4>
|-
| contenu du sujet
|}

{| class="collapsible collapsed" style="text-align:left; border:0px; margin-top:0.2em"
|-
! style="background-color:#f2dfce; padding-top:0; padding-bottom:0" |
 <h4 style="margin:0; padding:0;font-size:95%">d'autres sujets</h4>
|-
| contenu des autres sujets
|}

Pour clarifier, vous voulez que les entêtes des boîtes repliables soient traitées comme des titres de section et inclus dans la TOC, sans avoir besoin de titres de section formels sur la page elle-même.

Bien que cela ne soit pas recommandé, il est possible de créer une entrée du sommaire qui ne soit pas dans le texte mais qui sert d'ancre pour relier une entête de section avec une formulation légèrement différente :

<h4 style="display:none">votre titre ici</h4>

Démonstration de sections

Démonstration abc

Cette section est liée vers #Linking to a section.

Voir aussi

Notes

  1. 1.0 1.1 1.2 TOC — table of contents