Outils pour utilisateurs

Outils du site


aide: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
aide:conseils_de_bon_style [22.12.2022 @ 23:59] Chewbaccaaide:conseils_de_bon_style [17.04.2023 @ 17:42] (Version actuelle) Chewbacca
Ligne 1: Ligne 1:
 +<- Aide:Accueil|Aide:Accueil ^ Aide:Syntaxe:Accueil|Aide syntaxique ^  ->
 ====== Aide:Conseils de bon style ====== ====== Aide:Conseils de bon style ======
  
-Voici quelques conseils sur la façon d’écrire une bonne page de wiki. Utilisez la page de [[:discussion:aide:conseils_de_bon_style|discussion]] pour vos commentaires à ce sujet.+{{howhard>2}} Voici quelques conseils sur la façon d’écrire une bonne page de wiki. Utilise la page de [[:discussion:aide:conseils_de_bon_style|discussion]] pour tes commentaires à ce sujet.
  
  
 ===== Structure de page ===== ===== Structure de page =====
  
-  * Commences ta page par une en-tête de premier niveau avec un titre significatif.+  * Commence ta page par une en-tête de premier niveau avec un titre significatif.
   * Sépares ton texte en paragraphes en laissant une ligne vide entre eux. Un paragraphe moyen ne devrait pas avoir plus de 10 à 20 lignes.   * Sépares ton texte en paragraphes en laissant une ligne vide entre eux. Un paragraphe moyen ne devrait pas avoir plus de 10 à 20 lignes.
   * Si ton texte fait plus que quelques paragraphes (de 3 à 5), coupez-le en sections en ajoutant des entêtes de niveau 2 à 5.   * Si ton texte fait plus que quelques paragraphes (de 3 à 5), coupez-le en sections en ajoutant des entêtes de niveau 2 à 5.
-  * Quand ton texte fait plus de 2 ou 3 pages d’écran, mettez un court résumé du contenu de la page après le premier en-tête. +  * Quand ton texte fait plus de 2 ou 3 pages d’écran, met un court résumé du contenu de la page après le premier en-tête. 
-  * Si tu as beaucoup de liens vers d’autres pages wiki ou vers des ressources externes, ajoutez une section spéciale avec d'autres références (voir [[#références|ci-dessous]]).+  * Si tu as beaucoup de liens vers d’autres pages wiki ou vers des ressources externes, ajoute une section spéciale avec d'autres références (voir [[#références|ci-dessous]]).
  
  
Ligne 26: Ligne 27:
   * Utilise des phrases bien construites et utilise les articles pour les noms.   * Utilise des phrases bien construites et utilise les articles pour les noms.
   * Commence chaque phrase par une majuscule et termine-la avec un point ou toute autre ponctuation appropriée.   * Commence chaque phrase par une majuscule et termine-la avec un point ou toute autre ponctuation appropriée.
 +  * N'utilise pas de langage SMS et évite les anglicismes et les acronymes qui peuvent altérer la compréhension de ton texte.
   * Essaye d'écrire court, des phrases claires sans trop avoir recours à des explications de moindre importance. Quand tu penses que tu as terminé ta page, relie-la encore et corrige les phrases qui ont une structure excessivement compliquée.   * Essaye d'écrire court, des phrases claires sans trop avoir recours à des explications de moindre importance. Quand tu penses que tu as terminé ta page, relie-la encore et corrige les phrases qui ont une structure excessivement compliquée.
   * Décide de la façon dont tu veux t'adresser au lecteur. Puisque DokuWiki est orienté vers l’écriture de documentation, tu devrais souvent donner des explications aux lecteurs, comment faire certaines choses. Tu peux 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élange pas ces formes.   * Décide de la façon dont tu veux t'adresser au lecteur. Puisque DokuWiki est orienté vers l’écriture de documentation, tu devrais souvent donner des explications aux lecteurs, comment faire certaines choses. Tu peux 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élange pas ces formes.
-  * Avant la sauvegarde examine ta page pour déceler les fautes de grammaire ou d'orthographe. Si ton texte comporte beaucoup d'erreurs, il affaiblira la crédibilité de tes rapports, indépendamment de l’intérêt qu’ils peuvent avoir.+  * Avant la sauvegarde examine ta page pour déceler les fautes de grammaire ou d'orthographe. Si ton texte comporte beaucoup d'erreurs, il affaiblira la crédibilité de tes propos, indépendamment de l’intérêt qu’ils peuvent avoir.
   * Développe ton propre style. Ne te force pas à écrire avec un style qui ne te convient pas. Il en résulterait un texte artificiel et désagréable à lire.   * Développe ton propre style. Ne te force pas à écrire avec un style qui ne te convient pas. Il en résulterait un texte artificiel et désagréable à lire.
  
Ligne 38: Ligne 40:
   * N'ajoute pas un lien à chaque occurrence d'un terme spécifique. Fait-le sur la première occurrence rencontrée et ajoute éventuellement un lien à la section de référence du terme.   * N'ajoute pas un lien à chaque occurrence d'un terme spécifique. Fait-le sur la première occurrence rencontrée et ajoute éventuellement un lien à la section de référence du terme.
   * Si tu ajoutes une ligne "Voir aussi :"  à la fin de ta page. Fait des liens uniquement vers les pages du wiki qui sont étroitement liées au sujet de ta page.   * Si tu ajoutes une ligne "Voir aussi :"  à la fin de ta page. Fait des liens uniquement vers les pages du wiki qui sont étroitement liées au sujet de ta page.
-  * Si tu veux te référer à des ressources externes qui donnent davantage d'informations à ton sujet ou que tu as utilisés en écrivant ta page, ajoutez une section appelée  "Références" ou "Plus d'informations" et fourni une liste de liens. Indique dans ton lien l’objet du site auquel tu faits référence (par exemple "[site] d’autres conseils sur la reproduction des coccinelles.").+  * Si tu veux te référer à des ressources externes qui donnent davantage d'informations à ton sujet ou que tu as utilisés en écrivant ta page, ajoute une section appelée "Références" ou "Plus d'informations" et fourni une liste de liens. Indique dans ton lien l’objet du site auquel tu faits référence (par exemple "[site] d’autres conseils sur la reproduction des coccinelles.").
  
  
Ligne 47: Ligne 49:
   * Si tu n’es pas l’auteur de l'image, indique la source (probablement avec un lien) et le copyright.   * Si tu n’es pas l’auteur de l'image, indique la source (probablement avec un lien) et le copyright.
   * Ne lie pas d'images de sites externes, à moins que tu ne sois autorisé à le faire. En effet ceci vole de la largeur de bande au site accueillant l'image. Télécharge plutôt l'image dans le wiki, si tu le peux.   * Ne lie pas d'images de sites externes, à moins que tu ne sois autorisé à le faire. En effet ceci vole de la largeur de bande au site accueillant l'image. Télécharge plutôt l'image dans le wiki, si tu le peux.
-  * Si l'image est plus grande que le tiers d'une page d'écran, utilisez [[:aide:syntaxe:Images et autres fichiers|un lien de redimensionnement]] pour afficher une vignette.+  * Si l'image est plus grande que le tiers d'une page d'écran, utilise [[:aide:syntaxe:Images et autres fichiers|un lien de redimensionnement]] pour afficher une vignette.
  
  
aide/conseils_de_bon_style.1671749960.txt.gz · Dernière modification : 22.12.2022 @ 23:59 de Chewbacca