Compare Revisions
Een handleiding voor het verwijzen naar ondersteuningsartikelen
Revision 81100:
Revision 81100 by Tonnes on
Revision 292458:
Revision 292458 by markh2 on
Keywords:
Search results summary:
Dit artikel is een ontwikkelaarsreferentie voor het verwijzen naar ondersteuningsartikelen.
Dit artikel is een ontwikkelaarsreferentie voor het verwijzen naar ondersteuningsartikelen.
Content:
Er zijn twee manieren om naar Mozilla Support-artikelen te verwijzen. Welke methode u gebruikt hangt af van waarvandaan u verwijst. Als dit vanuit de chrome van Firefox of Firefox voor Android is, zult u de “in-product”-methode willen gebruiken. Als u vanaf een webtoepassing verwijst, gebruikt u de URL minus de locale-string. Ze werken als volgt.
__TOC__
=In-product-koppelingen naar SUMO aanmaken=
Doelen voor knoppen of koppelingen binnen de browserchrome dienen dit patroon te volgen:
<code>
https://support.mozilla.<!-- -->org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC
</code>
Voorbeelden:
*https://support.mozilla.<!-- -->org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy
*https://support.mozilla.<!-- -->org/1/firefox/13.0a2/Darwin/en-US/36eol
Het laatste gedeelte van de URL, het onderwerp, kan een willekeurige string zijn.
Koppelingen vanuit Firefox voor Android dienen <code>/1/mobile</code> te gebruiken om het product te onderscheiden.
De tuple (product, versie, os, locale, onderwerp) bepaalt waar de gebruiker daadwerkelijk naartoe gaat. Hierdoor kan het SUMO-team het doel van de knop Help wijzigen zonder dat koppelingen/knoppen in Firefox niet meer werken. We hebben specifieke doelen voor alle onderwerpwaarden, en soms kunnen we gebruikers van OS X of Windows ten behoeve van de meest relevante artikelen uitsplitsen, of die met oude/specifieke versies van Firefox, etc.
=Verwijzen naar SUMO vanaf een webtoepassing=
Als deze inhoud via het web wordt aangeboden en ''niet'' met de browser wordt geleverd, hoeft u de in-product-koppelingen niet te gebruiken (en zou u dat niet moeten doen).
Alles wat u moet doen is de URL gebruiken zonder de locale-string. SUMO zal de gebruiker automatisch naar de versie van de pagina in de eigen taal sturen.
Dus, als voorbeeld, om naar het artikel [[Update Firefox to the latest version ]] te verwijzen:<br>
Gebruik
*https://support.mozilla<!-- -->.org/kb/update-firefox-latest-version
Gebruik geen
*https://support.mozilla<!-- -->.org/en-US/kb/update-firefox-latest-version
=Verwijzen vanaf een andere locatie=
Als u niet vanuit Firefox of een website verwijst (misschien een app, product, e-mail etc.), wilt u waarschijnlijk de URL (zonder de locale-string) gebruiken en de bron identificeren.
Voorbeeld:
*https://support.mozilla<!-- -->.org/kb/update-firefox-latest-version?utm_source=naamvanbron
=Vragen?=
Als u vragen hebt of het uiteindelijke doel van de in-product-koppeling moet instellen, neem dan contact op met Michael Verdi - mverdi at mozilla<!-- -->.com of verdi op IRC.
Het doorverwijzen naar Mozilla Support-artikelen is cruciaal voor het geven van directe toegang naar d ebenodigde hulp aan onze gebruikers. Er zijn twee primaire manieren om deze doorverwijzingen te maken, en de methode die u kiest hangt af van waarvandaan u verwijst. Deze handleiding leidt u door beide methodes, om ervoor te zorgen dat u effectief kunt doorverwijzen, waardoor u gebruikers helpt naadloos de juiste ondersteuningsinhoud te vinden.
__TOC__
=In-product-koppelingen naar SUMO=
Voor koppelingen die binnen de browserinterface van Firefox of Firefox voor Android worden geplaatst, dient u een specifieke URL-structuur te gebruiken. Deze structuur stelt het CX Content Team in staat om het doel van de koppeling aan te passen zonder functionaliteit in Firefox te verstoren. We hebben specifieke doelen vastgesteld voor diverse onderwerpen, waardoor we gebruikers door kunnen sturen naar de meest relevante artikelen op basis van factoren zoals hun besturingssysteem of Firefox-versie. Deze flexibiliteit betekent dat updates of wijzigingen rechtstreeks in [https://wiki.mozilla.org/Support/Kitsune Kitsune] kunnen worden aangebracht, zonder de noodzaak om wijzigingen in de code van Firefox aan te brengen.
Hieronder vindt u de opmaak voor het maken van in-product-koppelingen naar SUMO-artikelen:
<code>
https://support.mozilla.<!-- -->org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC
</code>
{note}'''Noot:''' de secties <code>%VERSION%/%OS%/%LOCALE%/</code> zijn plaatshouders. Engineers zijn ervoor verantwoordelijk deze dynamisch te vullen in de broncode.{/note}
Voorbeeld:
<code>
https://support.mozilla.<!-- -->org/1/firefox/13.0a2/Darwin/nl/prefs-privacy
</code>
In deze structuur:
*verwijst <code>%VERSION%</code> naar de Firefox-versie.
*stelt <code>%OS%</code> het besturingssysteem van de gebruiker voor.
*specificeert <code>%LOCALE%</code> de taal- en regio-instellingen van de gebruiker.
*beschrijft <code>TOPIC</code> het onderwerp van het ondersteuningsartikel, en dit kan elk tekstfragment zijn.
Koppelingen specifiek voor Firefox voor Android dienen <code>/1/mobile</code> in de URL te bevatten om deze te onderscheiden van koppelingen die zijn bedoeld voor de desktopversie.
{note}'''Noot:''' als een SUMO-plaatshouder wordt aangemaakt om een in-product-koppeling te testen, dient de plaatshouder te zijn gepubliceerd en bewaard onder ''administration'' om deze correct te laten werken. Als de inhoud eenmaal voltooid is en klaar is om te worden gepubliceerd, dient het artikel uit ''administration'' te worden verplaatst om deze zichtbaar voor eindgebruikers te maken.{/note}
{warning}Het aanmaken van in-product-koppelingen dient te worden gecoördineerd via een [https://bugzilla.mozilla.org/enter_bug.cgi?product=support.mozilla.org&component=Knowledge+Base+Content Content Request Bugzilla]-ticket, die wordt beheerd door het CX Content Team. Probeer niet zelf deze koppelingen handmatig aan te maken, aangezien ze in [https://wiki.mozilla.org/Support/Kitsune Kitsune] moeten worden ingesteld voordat ze goed kunnen werken.{/warning}
==Vermijd doorverwijzingen naar ankers==
Doorverwijzingen naar specifieke ankers binnen artikelen zijn kwetsbaar en kunnen eenvoudig defect raken als de paginastructuur wijzigt. Verwijs, om verbroken koppelingen te vermijden, altijd naar de hoofdpagina van het artikel. Dit zorgt ervoor dat uw koppeling geldig blijft en gebruikers de benodigde informatie kunnen benaderen, ongeacht updates van de interne secties van het artikel.
=Webeigenschapkoppelingen naar SUMO=
Als u koppelingen maakt vanuit webeigenschappen buiten Firefox, laat dan het locale-deel van de URL weg. Hierdoor kan het SUMO-systeem automatisch de taal detecteren en de gebruiker doorsturen naar de juiste taalversie van het artikel, op basis van hun browserinstellingen.
Dus, als voorbeeld, om naar het artikel [[Update Firefox to the latest release]] te verwijzen:
* '''Gebruik''' <code>https://support.mozilla<!-- -->.org/kb/update-firefox-latest-release</code>
* '''Gebruik niet''' <code>https://support.mozilla<!-- -->.org/en-US/kb/update-firefox-latest-release</code>
=Verwijzen vanaf een andere locatie=
Als u niet vanuit Firefox of een website verwijst (misschien een app, product, e-mail etc.), wilt u waarschijnlijk de URL (zonder de locale-string) gebruiken en de bron identificeren.
Voorbeeld:
<code>https://support.mozilla<!-- -->.org/kb/update-firefox-latest-version?utm_source=naamvanbron</code>
=Een ingekorte ''mzl<!-- -->.la''-koppeling aanmaken=
Lees [[How to generate mzl.la link]] om te zien hoe u een ingekorte mzl.la-koppeling aanmaakt.
=Vragen?=
Als u een in-product-koppeling wilt instellen, vul dan een [https://bugzilla.mozilla.org/enter_bug.cgi?product=support.mozilla.org&component=Knowledge+Base+Content Content Request Bugzilla]-ticket in. U kunt vragen stellen in deze [https://support.mozilla.org/en-US/forums/contributors/716943?last=87470 ondersteuningsdiscussie].
==Meer info==
*[[About the Knowledge Base]]
*[[Anatomy of a Knowledge Base article]]