Convention:Wikicode
Conventions de présentation du wikicode
Cette page présente les principales conventions de présentation du wikicode utilisées dans le Wiktionnaire. Voir aussi la page d’aide sur le wikicode.
Principes généraux
L’harmonisation de la présentation du code facilite la collaboration et l’intégration de nouvelles personnes souhaitant contribuer au Wiktionnaire. Les principes ci-dessous visent donc à statuer sur des possibilités de variation qui peuvent exister et invitent à se conformer à la manière de faire actuelle. Si vous souhaitez faire évoluer certains de ces principes, n’hésitez pas à le proposer dans la Wikidémie.
Espaces et caractères de syntaxe wiki de début de ligne
Pour faciliter la lecture par les wiktionnaristes, il est recommandé de séparer les caractères de syntaxe wiki de début de ligne (par exemple « # », « * » ou « : ») du reste de la ligne par une espace (unique).
Par exemple, mettre une espace après le # de début de définition, utiliser pour une citation #* {{exemple|, plutôt que #*{{exemple|, ou encore, pour un mot dérivé, * ] plutôt que *]
Espaces autour du changement de casse
Pour faciliter la lecture par les wiktionnaristes, il est conseillé d’utiliser les caractères destinés à mettre en gras ou en italiques autour du texte concerné sans y ajouter d’espace.
Par exemple, utiliser pour une définition # ''Pluriel de'' ]. plutôt que # ''Pluriel de ''].
Ordre des paramètres des modèles
Les modèles ont des paramètres, qui peuvent être positionnels (leur interprétation est alors liée à leur position) ou nommés (leur interprétation est alors liée à leur nom). Pour faciliter la lecture du code, il est conseillé de toujours placer les paramètres positionnels à leur position normale d’après leur définition, et donc de mettre les paramètres nommés à la fin.
Par exemple, utiliser dans la page lois : {{fr-rég|lwa|s=loi}}, plutôt que {{fr-rég|s=loi|lwa}}.
Utilisation des lignes vides dans les entrées
Dans les pages de l’espace principal, une ligne vide (et une seule) sépare les sections. Les sections sont principalement : 1. une section avec titre de section (la première sous-section d’une section pouvant ne pas avoir de titre). 2. l’ensemble des modèles de début de page, avant la première section de langue (en particulier le modèle « {{voir}} »). 3. le modèle « {{clé de tri}} ». 4. un bloc de catégorisation.
Deux titres de section consécutifs (section et sous-section) ne sont donc pas séparés par une ligne vide. Cela a les avantages suivants : 1. c’est conforme aux habitudes des wiktionnaristes qui utilisent des logiciels de traitement de texte. 2. Cela permet un repérage visuel facile des sections de langue. Cet avantage est particulièrement spectaculaire dans les pages comprenant de nombreuses sections de langue courtes, comme la page Nepal, presque illisible sinon.
Cas particulier : on peut mettre une fin de ligne à la dernière ligne de texte de la page, pour faciliter les ajouts et parce que c’est apparemment la norme sur les wikis.
Utilisation d’espaces inutiles
Tous les espaces inutiles à l’intérieur des lignes doivent être évités, ainsi que les espaces inutiles (invisibles) en fin de ligne.
Voir aussi
- Certaines de ces conventions ont été élaborées collectivement dans la Wikidémie de janvier 2021.
- Aide:Bases de la syntaxe du Wiktionnaire
- Wiktionnaire:Syntaxe du Wiktionnaire