Disclaimer: Dit artikel is gegenereerd door automatische vertaling.

Regel voor artikelomleiding

Prev Next

Plannen ter ondersteuning van het gebruik van regels voor het omleiden van artikelen in de kennisbank

Professional
Business
Enterprise






U kunt een regel voor het omleiden van artikelen instellen voor elke URL van een gepubliceerd artikel of conceptartikel. De omleidingsfunctie is handig wanneer u de URL van een artikel wijzigt en er naar diezelfde URL wordt verwezen in andere artikelen op uw Knowledge Base-site. U kunt ook een bulksgewijze import van omleidingsregels uitvoeren.

Omleidingsregels voorkomen dat gebruikers op dode of verbroken links klikken.


Een regel voor het omleiden van artikelen toevoegen

Je kunt de URL of slug van een artikel wijzigen voor of na het publiceren van het artikel of de categoriepagina. De URL van een categorie van het indextype kan ook worden gewijzigd. U kunt deze wijzigingen rechtstreeks in de artikeleditor aanbrengen.

Volg de onderstaande stappen om de regel voor het omleiden van artikelen toe te voegen:

  1. Navigeer naar ()> Knowledge base site > Article redirect rules in de Knowledge Base-portal.

    De pagina met regels voor het omleiden van artikelen verschijnt met een lijst met bestaande regels (indien van toepassing).

  2. Klik op Nieuwe omleiding om een nieuwe omleidingsregel te maken.

    Het deelvenster Nieuwe omleidingsregel wordt weergegeven.

  3. Selecteer het gewenste type doorverwijzing:
    a. Eindigt met: Om de omleidingsregel in te stellen voor een artikel met de unieke slug aan het einde van je URL.
    b. Vervangen door: Om de omleidingsregel in te stellen voor de URL-tekst tussen de domeinnaam en de artikelslug.

Eindigt op

  1. Typ in het veld Bronpad de unieke slug aan het einde van uw URL voor de omleiding.

NOTITIE

De URL-slug in het bronpad moet beginnen met een schuine streep (/).

  1. Typ in het veld Bestemmings-URL de volledige bestemmings-URL of typ de nieuwe slug voor omleiding. Het toevoegen van een schuine streep (/) aan het begin van de bestemmings-URL is optioneel.

Voorbeeld: Als u de URL van het artikel wilt omleiden van https://docs.document360.com/docs/getting-started-with-document360 naar https://docs.document360.com/docs/getting-started-video-library, voegt u het bronpad en de bestemmings-URL toe, zoals hieronder vermeld:
Bron pad: /getting-started-with-document360
Bestemming-URL: getting-started-video-library

  1. Klik op Maken.

Vervangen door

  1. Typ in het veld Bronpad de tekst tussen het domein en de artikelslug die u wilt omleiden.

Voorbeeld: Het bronpad in de URL https://project.technicaldocumentation.com/v1/docs/fr/getting-started is /v1/docs/fr/.

NOTITIE

Het bronpad moet beginnen en eindigen met een schuine streep (/).

  1. Typ in het veld Tekst vervangen de nieuwe URL-tekst die u wilt gebruiken voor omleiding.

Voorbeeld: Vervang /v1/docs/fr/ door /v2/docs/en/ in de URL https://project.technicaldocumentation.com/v1/docs/fr/getting-started.

NOTITIE

De vervangende tekst moet beginnen en eindigen met een schuine streep (/).

  1. Klik op Maken.


Aanbevolen procedures

Als u een meertalige Knowledge Base met meerdere projectwerkruimten beheert, stelt u omleidingsregels in op basis van taal of werkruimte. Als u bijvoorbeeld een regel instelt met het bronpad /customer-support en het doel /sales-and-support, is dit alleen van toepassing op de standaardtaal van de hoofdwerkruimte.

  • Als u deze regel wilt toepassen op een andere taal (bijvoorbeeld Duits: /de/), maakt u een nieuwe regel met het bronpad /de/customer-support en het doel /de/sales-and-support.

  • Als u de regel in een andere werkruimte wilt toepassen (bijvoorbeeld versie 1: /v1/), stelt u het bronpad /v1/docs/customer-support en het doel /v1/docs/sales-and-supportin.


Omleidingsregel op siteniveau

Op de pagina Regels voor omleidingen voor artikelen kunt u op siteniveau een regel voor omleidingen voor submappen instellen met behulp van de optie Vervangen door . Dit is handig voor het migreren van een ander platform of het omleiden van afgeschafte werkruimten/talen.

Voorbeeld: Stel een omleidingsregel voor de submap /azure/serverless in op /data/cloud360 in de URL's zoals https://apidocs.serverless360.com/azure/serverless/article_slug.


Een omleidingsregel bewerken

Volg de onderstaande stappen om de regel voor het omleiden van artikelen te bewerken:

  1. Navigeer naar ()> Knowledge base site > Article redirect rules in de Knowledge Base-portal.

    De pagina met regels voor het omleiden van artikelen verschijnt met een lijst met bestaande regels (indien van toepassing).

  2. Gebruik het filter om de gewenste omleidingsregel te vinden.

  3. Plaats de muisaanwijzer op de gewenste regel en klik op het pictogram Bewerken ().

    Het deelvenster Regel voor omleidingsregels bewerken wordt weergegeven.

  4. Werk de benodigde velden bij.

  5. Klik op Bijwerken.


Een omleidingsregel verwijderen

Volg de onderstaande stappen om een omleidingsregel voor artikelen te verwijderen:

  1. Navigeer naar ()> Knowledge base site > Article redirect rules in de Knowledge Base-portal.

    De pagina met regels voor het omleiden van artikelen verschijnt met een lijst met bestaande regels (indien van toepassing).

  2. Gebruik Filter om de gewenste omleidingsregel te vinden.

  3. Plaats de muisaanwijzer op de gewenste regel en klik op het pictogram Verwijderen ().

  4. Als u meerdere regels wilt verwijderen, schakelt u de selectievakjes naast de regels in en klikt u op Verwijderen.

  5. Klik op Ja in het bevestigingsvenster Verwijderen .

NOTITIE

Verwijderde omleidingsregels kunnen niet worden opgehaald.


Een omleidingsregel filteren

Volg de onderstaande stappen om de gewenste omleidingsregel te filteren:

  1. Zoeken: voer een trefwoord in van het bronpad of de bestemmings-URL in de zoekbalk en het resultaat wordt ingevuld.

  2. Type: Filter op het type omleiding: Eindigt met, Vervangt door of Beide.

  3. Wijzigingsdatum: Filter regels op de datum van de laatste wijziging, met opties zoals 1 jaar, 3 maanden, 30 dagen of 7 dagen. Klik op Aangepaste datum om een aangepaste periode te kiezen en selecteer de gewenste periode.


Regels voor het importeren van omleidingen

Als u regels voor bulkomleidingen in ƩƩn keer wilt importeren, uploadt u een CSV-bestand dat overeenkomt met de volgende sjabloon:

Bron

Bestemming

Omleidingstype

/myoldarticle

newarticle

eindigt met

/en/customers/

/v1/docs/

vervangen door

NOTITIE

De bestandsgrootte moet kleiner zijn dan of gelijk zijn aan 1 MB.

Sjabloon voor het importeren van omleidingsregelbestanden

U kunt het sjabloon ook hier downloaden:

Omleidingsregels bulksgewijs importeren:

  1. Bereid een CSV-bestand voor dat overeenkomt met de meegeleverde sjabloon (bestandsgrootte ≤ 1 MB).

  2. Navigeer naar ()> Knowledge base site > Article redirect rules in de Knowledge Base-portal.

  3. Klik op Omleidingsregel importeren.

    Het deelvenster Regels voor het importeren van omleidingen wordt weergegeven.  

  4. Sleep het CSV-bestand of selecteer Klikken om te uploaden.

  5. Bekijk de lijst met geldige en ongeldige regels.

    NOTITIE

    Klik op het pictogram Downloaden () naast het aantal ongeldige regels om de lijst met ongeldige regels te downloaden.

  6. Klik op Importeren om de geldige regels toe te passen.


Regels voor het exporteren van omleidingen

Volg de onderstaande stappen om omleidingsregels te exporteren als een CSV-bestand:

  1. Navigeer naar ()> Knowledge base site > Article redirect rules in de Knowledge base-portal.

  2. Klik op Exporteren om de regels als CSV-bestand te downloaden.


Probleemoplossing

Gepubliceerd artikel dat een 404-fout omleidt of toont

Een gepubliceerd artikel op de Knowledge Base-site kan doorverwijzen naar een ander artikel of leiden tot een 404-fout als gevolg van een verkeerd geconfigureerde omleidingsregel die is toegepast op de link van het artikel.

Stappen om op te lossen:

  1. Navigeer naar ()> Knowledge base site > Article redirect rules in de Knowledge Base-portal.

  2. Gebruik de zoekbalk om de slug van het artikel te vinden en controleer of er een omleidingsregel wordt toegepast.

  3. Als een omleidingsregel wordt toegepast, bekijkt u het doel ervan. Als de regel onnodig of verkeerd geconfigureerd is, verwijdert u deze.

  4. Sla de wijzigingen op en bezoek het artikel opnieuw om ervoor te zorgen dat het wordt weergegeven zoals verwacht op de Knowledge Base-site.

Als het probleem zich blijft voordoen na het volgen van deze stappen, neem dan contact op met het Document360-ondersteuningsteam voor verdere hulp: Neem contact op met Document360 Support

Published article redirecting or showing a 404 error

Er treedt een fout op tijdens het opslaan van een artikelomleidingsregel.

Fout: Kan de regel voor het opslaan van artikelomleiding niet opslaan. De opgegeven bron maakt al deel uit van een bestaande bestemming.

Deze fout treedt op wanneer een doelslug (het doel van een bestaande omleidingsregel) wordt gebruikt als het bronpad voor een andere omleiding. Zodra een doel is ingesteld in een omleidingsregel, wordt het een statisch doel en kan het niet opnieuw worden gebruikt als bron in een nieuwe regel.

Stappen om op te lossen:

  • Zorg ervoor dat de doelslug niet wordt gebruikt als bronpad in bestaande of nieuwe omleidingsregels.

  • Controleer en update uw omleidingsregels om conflicten te voorkomen.

An error message indicating failure to save article redirection rule in the Knowledge base portal.

404-fouten voorkomen na het verwijderen van talen op de Knowledge Base-site

Wanneer talen worden verwijderd/verborgen van de Knowledge Base-site, kunnen lezers 404-fouten tegenkomen als ze proberen toegang te krijgen tot verwijderde taalversies van artikelen.

Zodra een taal uit het project is verwijderd, zijn alle artikelen die aan die taal zijn gekoppeld, niet meer beschikbaar. Gebruikers met links naar bladwijzers of directe toegang tot die URL's kunnen echter nog steeds proberen ze te openen, wat leidt tot 404-fouten.

Stappen om op te lossen:

Om 404-fouten te voorkomen en gebruikers om te leiden naar de hoofdtaalversie van het artikel, stelt u omleidingsregels in voor de verwijderde talen:

  1. Navigeer naar ()> Knowledge base site > Article redirect rules in de Knowledge Base-portal.

  2. Klik op Nieuwe omleiding om een nieuwe omleidingsregel toe te voegen.

    Het deelvenster Nieuwe omleidingsregel wordt weergegeven.

  3. Kies Vervangen door in het gedeelte Omleidingstype .

  4. Voer in het bronpad in /docs/<language_code> (bijvoorbeeld /docs/fr voor Frans, /docs/es voor Spaans, /docs/de voor Duits).

  5. Voer in de tekst vervangen in / om alle taalspecifieke artikellinks om te leiden naar de hoofdtaal.

  6. Klik op Maken om de regel op te slaan.

    Herhaal het proces voor elke verwijderde taal. Zodra deze omleidingsregels zijn toegepast, zal elke poging om toegang te krijgen tot een verwijderd taalartikel gebruikers automatisch omleiden naar de hoofdtaalversie, waardoor 404-fouten worden voorkomen, zelfs als de links een bladwijzer hebben.

Creating a new redirect rule with source path and replace text fields filled.


Veelgestelde vragen

Wat zijn dode links?

Dode links, of verbroken links, zijn hyperlinks die niet meer werken vanwege problemen zoals URL-wijzigingen, onjuiste URL's of beperkte/privƩartikelen. Ze resulteren meestal in een 404-foutpagina.a

Wat is een artikelslak?

Een slug is het deel van een URL dat een specifiek artikel/pagina uniek identificeert. Het komt na de in de / hoofd-URL van uw project.

Voorbeeld:
URL van het artikel: https://docs.document360.com/docs/why-did-we-build-document360

Naaktslak: /why-did-we-build-document360

Hoeveel omleidingsregels kan ik instellen in een project?

Je kunt maximaal 10.000 redirectregels per project instellen. Als je de limiet overschrijdt, neem dan contact op met ons ondersteuningsteam.

Zijn er limieten voor de functie voor importomleidingsregels?

U kunt maximaal 1.000 omleidingsregels per dag importeren en de importfunctie maximaal vijf keer per dag gebruiken. Als je de limiet overschrijdt, neem dan contact op met ons ondersteuningsteam.

Waarom zie ik de foutmelding 'De KB-site wordt te vaak omgeleid bij het openen?'

Deze fout treedt op als gevolg van een omleidingslus, vaak veroorzaakt door het instellen van de URL van de Document360 Knowledge Base-site als de aanmeldings-URL voor JWT-verificatie. Zorg ervoor dat de aanmeldings-URL voor JWT-verificatie niet hetzelfde is als de site-URL van Document360 KB. Gebruik een speciale verificatiepagina als aanmeldings-URL om omleidingslussen te voorkomen en de fout op te lossen.

Hoe kunnen we het probleem van 404-fouten aanpakken wanneer we functionaliteiten stopzetten die leiden tot inkomende links van bronnen die we niet kunnen controleren?

Voor beƫindigde functies kunt u, om 404-fouten effectief te beheren, een standaardartikel maken dat gebruikers informeert over de stopzetting van een functionaliteit, die kan worden gebruikt om relevante artikelen om te leiden.

Voor meerdere beƫindigde functionaliteiten kunt u overwegen een gecentraliseerde pagina op te zetten die alle gerelateerde informatie consolideert, zodat gebruikers gemakkelijk toegang hebben tot updates en het aantal dode links wordt verminderd.

Hoe leid ik een artikel om van de ene pagina naar de andere met behulp van aangepast JavaScript?

Volg de onderstaande stappen om een artikel van de ene pagina naar de andere om te leiden met behulp van aangepast JavaScript:

  1. Navigeer naar () > Knowledge base site > Customize site in de Knowledge Base-portal.

  2. Klik op Aangepaste CSS en JavaScript.

  3. Plak de volgende code op het tabblad JavaScript :

    $(document).ready(function() {
      if(window.location.href=="source URL") {
        window.location.replace("destination URL");
      }
    });
    
  4. Vervang de bron-URL en bestemmings-URL in de code.

  5. Klik op Opslaan.

Hoe schrijf ik een omleidingsregel om de naam van de werkruimte in de URL te vervangen?

U kunt omleidingsregels gebruiken bij het migreren van een ander platform naar Document360.

  • Oude URL-structuur: https://docs.document360.com/{oldworkspace}/section/page

  • Nieuwe URL-structuur: https://docs.document360.com/{newworkspace}/section/page

Hetzelfde domein moet aan beide platforms worden toegewezen om de omleiding te laten werken. Bijvoorbeeld
Als de oude werkruimte v1 is en de nieuwe werkruimte v2:

Bron

Bestemming

Regel

/v1

/

eindigt met

/v1/

/v2

vervangen door

Deze regel zorgt ervoor dat alle aanvragen die naar de oude werkruimte v1 verwijzen, worden omgeleid naar de nieuwe werkruimte v2.

Hoe kan ik een specifieke artikel/categorie URL doorverwijzen naar de homepage van mijn documentatie?

Als u een specifieke URL wilt doorverwijzen naar de startpagina van mijn documentatie, wijzigt u de bestemmings-URL in '/'.
Als u bijvoorbeeld de URL https://docs.radixdlt.com/docs/welcome wilt omleiden naar https://docs.radixdlt.com , stelt u de bron-URL in op /docs/welcome en de bestemmings-URL op '/' in de regel voor vervangen door omleiding.