변경사항 비교
Anatomie d’un article de la base de connaissances
변경 사항 62023:
변경 사항 62023 제공자: Goofy_BZ 수정일:
변경 사항 278945:
변경 사항 278945 제공자: Mozinet 수정일:
키워드:
검색 결과 요약
Vous avez 160 caractères en plus du titre pour expliquer aux personnes le sujet de l'article. C'est comme un tweet ou une petite annonce. Plus d'info ici http://mzl.la/QNLUN5
Cet article détaille les différentes parties d’un article d’assistance, telles que ce résumé de recherche qui vous présente le sujet d’un article.
내용:
[[Video:http://youtu.be/glEfWcibcy0]]
Ceci est une introduction qui vous donne le contexte de l'article et vous donne un aperçu du contenu. En faisant cela vous pouvez rapidement déterminer si c'est le bon article pour vous.
Dans le cas où vous souhaitez apprendre comment écrire des articles d'aide pour le support Mozilla. Cet article va vous montrer les techniques les plus courantes et le balisage wiki que nous utilisons. Vous pouvez aussi suivre cet article c'est le guide de la[https://support.mozilla.org/en-US/kb/anatomy-of-a-knowledge-base-article/edit source wiki] que nous utilisons pour écrire.
<!-- CECI EST UN COMMENTAIRE. IL N'EST PAS VISIBLE AU LECTEUR CAR IL A DES CARACTÈRES SPÉCIAUX AU DEBUT ET À LA FIN. Occasionnellement les auteurs y mettre des notes pour d'autres personnes de cette manière. Dans cet article c'est utilisé pour vous montrer comment utiliser le balisage wiki. -->
Généralement, il y a deux types d'articles avec deux types d'introduction :
*Introduction d'article tutoriel ou Comment-Faire (How-to) : Un bref sommaire des fonctionnalités ou tâches et les choses pouvant être apprises ([[Use tabs to organize lots of websites in a single window|(exemple)]]).
*Introduction d'article de résolutions de problème : Un bref sommaire des symptôme et la solution([[Flash 11.3 crashes|exemple]]).
<!-- NOTE: Dans le paragraphe précédent, les astérisques, *, sont utilisés pour créer une liste non ordonnée (liste à puces). Les liens vers un autre article ressemblent à cela [[Nom de l'article]] mais dans ce cas il faut ajouter un pipe, |, et le nouveau nom de l'article ressemblera à [[Nom de l'article|le nom de l'article que je veux afficher pour le lecteur]] -->
__TOC__
<!-- NOTE: Ceci va vous faire un sommaire -->
=Comment structurer un article=
<!-- NOTE: Ceci est un titre de niveau 1 -->
L'idée générale ici est d'essayer de construire des compétences des plus simples aux plus complexes qui va essayer de garder l'information que la majorité des personnes veulent tout en haut.
Pour cet exemple, dans cet article [[Use Tab Groups to organize a lot of tabs|Groupes d'onglets]] nous avons commencé par pourquoi utiliser cette fonctionnalité, puis comment faire un groupe et à la fin les tâches les plus compliquées comme chercher et organiser.
<!-- NOTE: Il y a un autre exemple dans ce paragraphe de lien vers un article qui change l'affichage texte du lien -->
==Rédiger une section description que les lecteurs peuvent survoler==
<!-- NOTE: Ceci est un titre de niveau 2. Vous devinez comment faire un titre de niveau 3 ? -->
En nommant la section après une tâche ou une solution cela autorise les personnes à chercher rapidement dans l'article ou utiliser le sommaire pour voir une partie de l'article. Dans certains cas cela va envoyer les utilisateurs vers une information et ils ne vont jamais lire le reste de l'article.
=Créer des instructions étape par étape=
Il n'y a rien de plus frustrant que de finalement trouver l'information dont vous avez besoin sans arriver à suivre les instructions, car l'auteur connaît quelque chose que vous ne connaissez pas. Ceci est la raison pour laquelle il faut faire des instructions par étapes complètes et numérotées. Même s'il y a seulement à cliquer sur "OK" à un moment il faut considérer que c'est une étape.
Vous pouvez voir un exemple d'article [[How to set the home page]]:
<!-- Cette précédente phrase est un autre exemple d'un lien classique vers un article. -->
#Ouvre le site web que vous souhaitez avoir en page d'accueil.
#Cliquez sur l'icône à gauche de l'adresse de la page, déplacez-la sur le bouton d'accueil et c'est bon.
#Cliquez sur {button Oui} pour la paramètrer comme votre page d'accueil <!-- NOTE: Regarder le balisage wiki dans cette étape cela crée un style spécial pour indiquer un bouton sur l'écran. -->
==Créer des instructions pour différents systèmes d'exploitation ou versions de Firefox==
Souvent les instructions de Firefox sont différentes selon les systèmes d'exploitation. Nous avez un balisage spécial qui permet d'afficher les instructions pour Windows aux utilisateurs de Windows et les instructions Mac pour les utilisateurs de Mac. Si vous changez de système d'exploitation au haut de l'article le reste de l'article changera.
{note}'''Astuce :''' Regardez [https://support.mozilla.org/en-US/kb/anatomy-of-a-knowledge-base-article/edit la source du wiki] pour voir comme cela est fait (merci de ne pas changer l'article).{/note}
<!-- NOTE: Les Notes n'ont pas besoin d'être appelées Notes tout le temps. Occasionnellement ce sont plus des astuces, donc nous les appelons des "Astuces". -->
{for win}
<!-- NOTE: Ces instructions sont "pour" windows uniquement. -->
#Dans le haut de la fenêtre Windows, cliquez sur le bouton {button Firefox} ({menu Outils} menu dans Windows XP) puis cliquez sur {menu Options}.
# Séléctionnez le panneau {menu Général} .
# Dans la boite qui s'ouvre, cliquez sur {button Remettre à zéro}.
#:[[Image:Home page Win3]]
#Cliquez sur {button OK} pour fermer la fenêtre Options.
{/for}
{for mac}
<!-- NOTE: Ces instructions sont "pour" Mac uniquement. -->
#Sur la barre de menu, cliquez sur le menu {menu Firefox} et sélectionnez {menu Préferences...}
# Sélectionner le panneau {menu Général} .
# Dans la boite qui s'ouvre, cliquez sur {button Remettre à zéro}.
#:[[Image:Home page Mac3]]
#Fermer la fenêtre Préferences.
{/for}
{for linux}
<!-- NOTE: Ces instructions sont "pour" Linux uniquement. -->
#Dans le haut de la fenêtre Windows, cliquez sur le menu {menu Édition} puis sélectionnez {menu Préférences}.
# Sélectionnez le panneau {menu Generale}.
# Dans la boite qui s'ouvre, cliquez sur {button Remettre à zero}.
#:[[Image:Home page Lin3]]
#Cliquez sur {button Fermer} pour fermer la fenêtre Préférences.
{/for}
===Utilisez un templates (modèle) pour vos instructions étapes par étapes===
Il y a de nombreuses étapes similaires dans les articles de Firefox. Pour cela nous avons créé des "templates" (vous n'avez donc pas besoin d'écrire et traduire) encore et encore. Habituellement les templates ont des instructions pour tous les systèmes d'exploitation pour lesquels nous avons écrit des étapes précédemment. Vous pouvez voir les étapes similaires en dessous, mais écrivez avec des templates.
{note}'''Astuce:''' Assurez-vous de regarder le [https://support.mozilla.org/en-US/kb/anatomy-of-a-knowledge-base-article/edit balisage wiki] pour voir comment cela est fait (merci de ne rien modifier).{/note}
# [[T:optionspreferences]]
# Sélectionnez le panneau {menu Général}.
# Dans la boite qui s'ouvre, cliquez sur {button Remettre à zéro}.
#:{for win}[[Image:Home page Win3]]{/for}{for mac}[[Image:Home page Mac3]]{/for}{for linux}[[Image:Home page Lin3]]{/for}
# [[T:closeOptionsPreferences]]
<!-- NOTE: Dans cette section le template inclut les instructions pour tous les systèmes d'exploitation. Vous ne devez vous inquiéter que des captures d'écran. C'est important de se souvenir que lorsque vous utilisez le balisage "for" dans une liste vous ne pouvez UTLISER UNIQUEMENT UNE ÉTAPE À LA FOIS. VOUS NE POUVEZ PAS FAIRE UNE ÉTAPE POUR UN SYSTÈME D'EXPLOITATION ET PAS POUR LES AUTRES. LE NUMEROTAGE ET LES ESPACES SERAIENT CASSÉS. DANS LE CAS OÙ VOUS SOUAHITEZ AVOIR UNE LISTE SÉPARÉE COMME DANS L'EXEMPLE DANS LA SECTION PRÉCEDENTE. Plus d'informations dans cet article http://support.mozilla.org/kb/how-to-use-for -->
{note}'''Note :''' [https://support.mozilla.org/en-US/kb/category/60 Ceci est une liste de nos templates] et vous pouvez en apprendre plus en utilisant <nowiki>{</nowiki>for<nowiki>}</nowiki> le balisage dans [[How to use For|cet article]].{/note}
[[Video:http://youtu.be/glEfWcibcy0]]
Cette vidéo d’introduction vous donne le contexte de l’article suivant et vous donne un aperçu du contenu. En regardant la vidéo, vous pouvez rapidement déterminer si c’est le bon article pour vous.
'''Vous souhaitez apprendre comment écrire des articles d’aide pour l’assistance de Mozilla ?''' Cet article vous montre nos techniques les plus courantes et les balises wiki importantes. Vous pouvez aussi vous servir de cet article et de son [https://support.mozilla.org/fr/kb/anatomie-base-de-connaissance/edit code source wiki] en tant que guide lorsque vous rédigez un article.
<!-- CECI EST UN COMMENTAIRE. IL N’EST PAS VISIBLE PAR LES LECTEURS ET LECTRICES, CAR IL A DES CARACTÈRES SPÉCIAUX AU DEBUT ET À LA FIN. Occasionnellement, les autrices et les auteurs y mettre des notes pour d’autres personnes de cette manière. Dans cet article, c’est pour vous montrer comment utiliser le balisage wiki. -->
Généralement, il y a deux types d’articles avec deux types d’introductions :
*articles tutoriels ou « Comment faire ? » (''How-to'') : un bref résumé des fonctionnalités ou tâches et les choses pouvant être apprises ([[Use tabs to organize lots of websites in a single window|exemple]]) ;
*articles de résolutions de problème : un bref résumé des symptômes et des solutions possibles ([[Firefox keeps crashing at startup|exemple]]).
<!-- NOTE : dans le paragraphe précédent, les astérisques « * » sont utilisés pour créer une liste non ordonnée (liste à puces). Les liens vers un autre article ressemblent à cela « [[Nom de l’article]] », mais, dans ce cas, il faut ajouter une barre verticale « | » et le nouveau nom de l’article ressemble à « [[Nom de l’article|ce que je veux afficher pour la lectrice ou le lecteur]] ». -->
__TOC__
<!-- NOTE : c’est la façon de créer une table des matières (Table of Contents). -->
=Comment structurer un article=
<!-- NOTE : ceci est un titre de niveau 1. -->
L’idée générale ici est d’essayer et de développer des compétences des plus simples aux plus complexes, tout en essayant de garder l’information nécessaire à la majorité des personnes tout en haut. Une solution simple et courante précède généralement une solution complexe ou un cas particulier.
==Rédiger des titres de section descriptifs afin que lecteurs et lectrices puissent les scanner rapidement==
<!-- NOTE : ceci est un titre de niveau 2. Vous devinez comment faire un titre de niveau 3 ? -->
Le fait de nommer l’en-tête de la section d’après la tâche ou la solution permet au lecteur ou à la lectrice de parcourir rapidement l’article ou de parcourir la table des matières pour apprécier la portée de l’article. Dans certains cas, cela peut déjà fournir suffisamment d’informations à nombre d’utilisateurs et d’utilisatrice qui n’auront même pas besoin de lire le reste de l’article.
=Créer des instructions pas à pas=
Il n’y a rien de plus frustrant que de finalement trouver les instructions dont vous avez besoin sans arriver à les suivre, car la personne ayant rédigé l’article connaît quelque chose que vous ne connaissez pas. C’est pourquoi nous décomposons nos instructions en étapes complètes et numérotées. Même s’il est nécessaire de cliquer sur « OK » à un moment donné, nous considérons cela comme une étape.
Vous pouvez voir un exemple d’article [[How to set the home page]] :
<!-- Cette précédente phrase est un autre exemple d’un lien classique vers un article. -->
#Ouvrez la page web que vous souhaitez avoir en page d’accueil.
#Glissez-déposez cet onglet sur le bouton d’accueil [[Image:Fx89HomeButton]] de votre barre d’outils.
#;[[Image:Fx89 Set homepage drag-and-drop]]
#Cliquez sur {button Oui} dans l’invite pour faire de cette page votre page d’accueil.
<!-- Regardez le balisage wiki dans cette étape. Il crée un style spécial pour indiquer un bouton sur l’écran. -->
{note}'''Astuce :''' regardez [https://support.mozilla.org/fr/kb/anatomie-base-de-connaissance/edit la source wiki] pour voir comme cela est fait (merci de ne pas changer l’article).{/note}
<!-- Les notes n’ont pas besoin d’être appelées « Note » tout le temps. Occasionnellement, ce sont plus des astuces. Nous donc les appelons des « Astuce ». -->
==Créer des instructions pour différents systèmes d’exploitation ou versions de Firefox==
Les instructions de Firefox sont souvent différentes selon les systèmes d’exploitation. Nous avons un balisage spécial qui affiche les instructions pour Windows aux utilisateurs et utilisatrices de Windows et les instructions pour Mac pour les personnes utilisant Mac. Si vous changez de système d’exploitation dans la boîte sous ''Personnaliser cet article'' à droite, les instructions ci-dessous sont modifiées en fonction du système d’exploitation sélectionné. Cet exemple est tiré de l’article [[Find what version of Firefox you are using]].
{for win,linux}<!-- Ces instructions sont « pour » Windows et Linux uniquement. -->Cliquez sur le bouton de menu [[Image:Fx89menuButton]] puis sur {menu Aide} et sélectionnez enfin {menu À propos de Firefox}{/for}{for mac}<!--Ces instructions sont « pour » Mac uniquement. -->Dans la barre de menu, cliquez sur le menu {menu Firefox} et sélectionnez {menu À propos de Firefox}{/for}. La fenêtre ''À propos de Firefox'' apparaît. Le numéro de version est inscrit sous le nom Firefox.
{note}'''Astuce :''' regardez [https://support.mozilla.org/fr/kb/anatomie-base-de-connaissance/edit la source wiki] pour voir comment cela est fait (merci de ne rien modifier). Vous pouvez en apprendre davantage à propos de l’utilisation des balises « <nowiki>{</nowiki>for<nowiki>}</nowiki> » dans [[How to use For|cet article]].{/note}
=Utilisez un ''template'' (modèle) dans vos instructions=
Il y a de nombreuses étapes similaires dans les articles de Firefox. Pour cela nous avons créé des ''templates'' pour que vous n’ayez ni besoin d’écrire ni de traduire encore et encore. Habituellement, les modèles contiennent des instructions pour tous les systèmes d’exploitation afin de simplifier et d’accélérer grandement la rédaction des étapes.
Cet exemple tiré de l’article [[How to set the home page]] comprend un modèle qui donne des instructions pour ouvrir le panneau des paramètres de Firefox.
#<!-- Ceci est un modèle. -->[[T:optionspreferences]]
#Cliquez sur le panneau {menu Accueil}<br>[[Image:Fx91HomePanel]]
#Cliquez sur le menu à côté de '''Page d’accueil et nouvelles fenêtres''' et choisissez la page d’accueil de Firefox (par défaut), les adresses web personnalisées ou une page vide.
<!-- NOTE : dans cette section, le modèle comprend des instructions pour tous les systèmes d’exploitation (la seule partie dont nous devrions nous préoccuper est la capture d’écran). -->
{note}'''Astuce :''' regardez [https://support.mozilla.org/fr/kb/anatomie-base-de-connaissance/edit la source wiki] pour voir comment cela est fait (merci de ne rien modifier). Consultez l’article [[Using Templates]] pour en apprendre davantage sur les modèles.{/note}
=Guides pour la base de connaissances=
Pour davantage de guides pour la contribution à la base de connaissances, consultez [https://support.mozilla.org/products/contributor/kb cette page].