Outils pour utilisateurs

Outils du site


wiki:conseils_de_bon_style

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
wiki:conseils_de_bon_style [29.03.2020 @ 12:36] Adminwiki:conseils_de_bon_style [03.04.2026 @ 12:46] (Version actuelle) – Espace inécable devant ":" Admin
Ligne 15: Ligne 15:
 ===== Formatage des textes ===== ===== Formatage des textes =====
  
-    * Les mots seuls peuvent être mis en évidence en les __soulignants__. Préférez mettre en //italique// ou en **gras** les court passages de textes.+    * Les mots seuls peuvent être mis en évidence soit en les __soulignants__, soit en les mettant **gras**, soit en les écrivant en lettres CAPITALESLes court passages de textes peuvent être mis en évidence soit en //italique//, soit en **gras**.
     * Choisissez un style pour afficher la sortie du texte à l’écran comme des boutons ou des étiquettes de menu et utilisez-le uniformément. Ce pourrait être une bonne idée d'ajouter une page avec une explication de vos conventions de styles propres à votre wiki.     * Choisissez un style pour afficher la sortie du texte à l’écran comme des boutons ou des étiquettes de menu et utilisez-le uniformément. Ce pourrait être une bonne idée d'ajouter une page avec une explication de vos conventions de styles propres à votre wiki.
     * Utilisez les [[/wiki:syntaxe#listes|listes non triées]] pour les éléments qui sont indépendants les uns des autres. Si vous développez une explication, écrivez les phrases dans un ordre continu.     * Utilisez les [[/wiki:syntaxe#listes|listes non triées]] pour les éléments qui sont indépendants les uns des autres. Si vous développez une explication, écrivez les phrases dans un ordre continu.
     * Utilisez avec parcimonie les [[/wiki/syntaxe#notes de pied de page|notes de pied de page]] et seulement pour des remarques complémentaires très courtes. S'il y a beaucoup plus à dire sur un sujet spécifique, mettez-le sur une nouvelle page du wiki. Si vous voulez vous référer à d'autres sources d'informations (extérieures), utilisez plutôt des [[/wiki/syntaxe#liens|liens]].     * Utilisez avec parcimonie les [[/wiki/syntaxe#notes de pied de page|notes de pied de page]] et seulement pour des remarques complémentaires très courtes. S'il y a beaucoup plus à dire sur un sujet spécifique, mettez-le sur une nouvelle page du wiki. Si vous voulez vous référer à d'autres sources d'informations (extérieures), utilisez plutôt des [[/wiki/syntaxe#liens|liens]].
-    * Les Tableaux peuvent améliorer considérablement la lisibilité de données structurées. Si vous insérez un tableau, assurez-vous qu'il ait des en-têtes significatifs pour chaque cellule et mettez une légende qui énonce clairement le contenu du tableau (par exemple "Tableau 1.2 : Distances moyennes entre les planètes").+    * Les Tableaux peuvent améliorer considérablement la lisibilité de données structurées. Si vous insérez un tableau, assurez-vous qu'il ait des en-têtes significatifs pour chaque cellule et mettez une légende qui énonce clairement le contenu du tableau (par exemple "Tableau 1.2(nbsp): Distances moyennes entre les planètes").
  
  
Ligne 27: Ligne 27:
     * Commencez chaque phrase par une majuscule et terminez-la avec un point ou toute autre ponctuation appropriée.     * Commencez chaque phrase par une majuscule et terminez-la avec un point ou toute autre ponctuation appropriée.
     * Essayez d'écrire court, des phrases claires sans trop avoir recours à des explications de moindre importance. Quand vous pensez que vous avez terminé votre page, relisez-la encore et corrigez les phrases qui ont une structure excessivement compliquée.     * Essayez d'écrire court, des phrases claires sans trop avoir recours à des explications de moindre importance. Quand vous pensez que vous avez terminé votre page, relisez-la encore et corrigez les phrases qui ont une structure excessivement compliquée.
-    * Décidez de la façon dont vous voulez vous adresser au lecteur. Puisque DokuWiki est orienté vers l’écriture de documentation, vous devrez souvent donner des explications aux lecteurs, comment faire certaines choses. Vous pouvez utiliser la forme impérative ("faites ceci !"), la forme nous/vous ("puis nous/vous cliquons(ez) sur...") ou la forme je ("j'ajoute alors le point à la barre, en utilisant..."). Ne mélangez pas ces formes.+    * Décidez de la façon dont vous voulez vous adresser au lecteur. Puisque DokuWiki est orienté vers l’écriture de documentation, vous devrez souvent donner des explications aux lecteurs, comment faire certaines choses. Vous pouvez utiliser la forme impérative ("faites ceci(nbsp)!"), la forme nous/vous ("puis nous/vous cliquons(ez) sur...") ou la forme je ("j'ajoute alors le point à la barre, en utilisant..."). Ne mélangez pas ces formes.
     * Avant la sauvegarde examinez votre page pour déceler les fautes de grammaire ou d'orthographe. Si votre texte comporte beaucoup d'erreurs, il affaiblira la crédibilité de vos rapports, indépendamment de l’intérêt qu’ils peuvent avoir.     * Avant la sauvegarde examinez votre page pour déceler les fautes de grammaire ou d'orthographe. Si votre texte comporte beaucoup d'erreurs, il affaiblira la crédibilité de vos rapports, indépendamment de l’intérêt qu’ils peuvent avoir.
     * Développez votre propre style. Ne vous forcez pas à écrire avec un style qui ne vous convient pas. Il en résulterait un texte artificiel et désagréable à lire.     * Développez votre propre style. Ne vous forcez pas à écrire avec un style qui ne vous convient pas. Il en résulterait un texte artificiel et désagréable à lire.
Ligne 44: Ligne 44:
  
     * "Une image dit plus que mille mots." Elle peut même dire plus que ce que l’on aurait souhaité. Les humains ont moins tendance à remettre en cause l'authenticité des images que du langage. Une description textuelle courte est meilleure que rien du tout ou qu'une image imprécise.     * "Une image dit plus que mille mots." Elle peut même dire plus que ce que l’on aurait souhaité. Les humains ont moins tendance à remettre en cause l'authenticité des images que du langage. Une description textuelle courte est meilleure que rien du tout ou qu'une image imprécise.
-    * Comme pour les tableaux, indiquez toujours une légende pour les images, qui énonce ce que vous voulez montrer avec l'image (par exemple "Image 3.2 : Photographie d'amateur montrant la reproduction des coccinelles.")+    * Comme pour les tableaux, indiquez toujours une légende pour les images, qui énonce ce que vous voulez montrer avec l'image (par exemple "Image 3.2(nbsp): Photographie d'amateur montrant la reproduction des coccinelles.")
     * Si vous n’êtes pas l’auteur de l'image, indiquez la source (probablement avec un lien) et le copyright.     * Si vous n’êtes pas l’auteur de l'image, indiquez la source (probablement avec un lien) et le copyright.
     * Ne liez pas d'images de sites externes, à moins que vous ne soyez autorisé à le faire. En effet ceci vole de la largeur de bande au site accueillant l'image. Téléchargez plutôt l'image dans le wiki, si vous le pouvez.     * Ne liez pas d'images de sites externes, à moins que vous ne soyez autorisé à le faire. En effet ceci vole de la largeur de bande au site accueillant l'image. Téléchargez plutôt l'image dans le wiki, si vous le pouvez.
wiki/conseils_de_bon_style.1585478185.txt.gz · Dernière modification : de Admin