Compare Revisions

aide hyperliens comment

Cet article est une référence utile pour les personnes qui développent et qui veulent établir des liens vers les articles d’assistance de Sumo.

La création de liens vers les articles du portail d’assistance Mozilla (SUMO) est essentielle pour fournir à nos internautes un accès immédiat à l’aide dont ils ont besoin. Il y a deux façons principales de mettre en place ces liens. La méthode à choisir dépend de l’endroit où vous créez le lien. Ce guide vous présente ces deux méthodes afin que vous puissiez créer des liens pertinents et aider les internautes à trouver facilement les contenus les plus appropriés du portail d’assistance. __TOC__ =Liens ''in-product'' vers SUMO= Pour les liens situés au sein de l’interface du navigateur Firefox ou Firefox pour Android, vous devez utiliser une structure d’URL particulière. Cette structure permet à l’équipe ''CX'' chargée du contenu (''CX'' : expérience client) d’adapter la cible du lien sans altérer les fonctionnalités de Firefox. Nous avons défini des cibles spécifiques pour différents sujets, ce qui nous permet de rediriger les internautes vers les articles les plus pertinents en fonction de critères tels que le système d’exploitation ou la version de Firefox qu’ils utilisent. Cette structure flexible permet d’effectuer des mises à jour ou des modifications directement dans [https://wiki.mozilla.org/Support/Kitsune Kitsune], sans qu’il soit nécessaire de modifier le code de Firefox. Voici le format à utiliser pour créer des liens ''in-product'' vers des articles SUMO : <code> https://support.mozilla.<!-- -->org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC </code> {note}'''Note :''' les éléments de code <code>%VERSION%/%OS%/%LOCALE%/</code> sont des espaces réservés. Les membres de l’équipe d’ingénierie se chargent de les remplir dynamiquement dans le code source.{/note} Exemple : <code> https://support.mozilla.<!-- -->org/1/firefox/13.0a2/Darwin/fr/prefs-privacy </code> Dans cette structure : *<code>%VERSION%</code> désigne la version de Firefox. *<code>%OS%</code> correspond au système d’exploitation de l’internaute. *<code>%LOCALE%</code> précise les paramètres de langue et de région de l’internaute. *<code>TOPIC</code> indique le sujet de l’article d’assistance et peut être une chaîne textuelle quelconque. Pour les liens spécifiques à la version Firefox pour Android, l’URL doit inclure <code>/1/mobile</code> afin de les distinguer des liens destinés à la version pour ordinateur. {note}'''Note :''' lorsque vous créez un espace réservé SUMO pour tester un lien ''in-product'', l’espace réservé doit être publié et conservé en mode ''administration'' pour qu’il fonctionne correctement. Une fois le contenu finalisé et prêt à être publié, l’article doit quitter le mode administration pour être visible par les internautes.{/note} {warning}Pour la création de liens ''in-product'', il faut ouvrir un ticket [https://bugzilla.mozilla.org/enter_bug.cgi?product=support.mozilla.org&component=Knowledge+Base+Content Bugzilla], qui sera géré par l’équipe CX. N’essayez pas de créer manuellement ces liens par vous-même, car ils doivent être configurés dans [https://wiki.mozilla.org/Support/Kitsune Kitsune] avant de pouvoir fonctionner correctement.{/warning} =Liens de propriété web vers SUMO= Lorsque vous créez des liens à partir de propriétés web externes à Firefox, ignorez la partie locale de l’URL. Cette méthode permet au projet SUMO de détecter et de rediriger automatiquement l’internaute vers la version linguistique appropriée de l’article, selon les paramètres de son navigateur. Donc, par exemple, pour établir un lien vers l’article [[Update Firefox to the latest release]] : *'''Utilisez''' <code>https://support.mozilla<!-- -->.org/kb/update-firefox-latest-release</code> *'''N’utilisez pas''' <code>https://support.mozilla<!-- -->.org/en-US/kb/update-firefox-latest-release</code> =Liens depuis un autre emplacement= Si vous n’établissez pas un lien depuis Firefox ou un site web (peut-être depuis une application, un produit, un e-mail, etc.), vous préfèrerez probablement utiliser l’URL (sans la chaîne locale) et identifier la source. Exemple : <code>https://support.mozilla<!-- -->.org/kb/update-firefox-latest-release?utm_source=NomDeLaSource</code> =Créer un lien court mzl<!-- -->.la= Consultez l’article [[How to generate mzl.la link]] pour savoir comment créer un tel lien mzl.la. =Des questions ?= Si vous avez besoin de créer un lien ''in-product'', veuillez remplir en anglais un ticket [https://bugzilla.mozilla.org/enter_bug.cgi?product=support.mozilla.org&component=Knowledge+Base+Content Bugzilla]. Pour toute question, écrivez-nous également en anglais dans ce [https://support.mozilla.org/en-US/forums/contributors/716943?last=87470 fil de discussion]. ==En savoir plus== *[[About the Knowledge Base]] *[[Anatomy of a Knowledge Base article]]