Subfolderhosting

Subfolderhosting stelt je in staat je Document360 Knowledge Base-site te bedienen vanaf een pad onder je hoofddomein, zoals example.com/docs, in plaats van een apart subdomein zoals docs.example.com. Een submap (of subdirectory) verschijnt na het root-domein in een URL en helpt de inhoud logisch te structureren onder je bestaande site. Het hosten van documentatie in een submap in plaats van een subdomein is over het algemeen beter voor zoekmachineoptimalisatie, omdat zoekmachines submapinhoud behandelen als onderdeel van de autoriteit van je hoofddomein. Subfolderhosting kan worden ingeschakeld voor zowel door Document360 geleverde domeinen als voor aangepaste domeinen in afbeelding.

Wanneer subfolderhosting te gebruiken

Gebruik subfolderhosting wanneer je wilt dat je documentatie onder je bestaande websitedomein staat in plaats van als een apart subdomein.

• Je wilt dat je kennisbasis profiteert van de SEO-autoriteit van je hoofddomein in plaats van dat je autoriteit apart op een subdomein bouwt.
• Uw merk- of marketingrichtlijnen vereisen dat alle klantgerichte content onder één root-domein valt.
• Je wilt een URL zoals example.com/help in plaats van help.example.com.

Voordat je begint

Je hebt ook toegang nodig tot de configuratie van je webserver (Nginx, Apache, IIS of ASP.NET Core) om verzoeken te proxy'en naar Document360, aangezien subfolderhosting server-side configuratie buiten Document360 vereist.

Hoe je subfolderhosting inschakelt

1. Navigeer naar > Knowledge base site in de linker navigatiebalk van de Knowledge base portal.
2. Navigeer naar Custom domain.
3. Op de pagina Aangepast domein navigeer je naar de Subfolder hosting tabblad. Standaard is het submappad ingesteld op /docs.
4. Zet de schakelaar aan naast Kennisbank die als submap wordt gehost.

Wanneer deze schakelaar aan staat, wordt de publieke preview van artikelen zichtbaar en wordt de workspace-slug niet langer automatisch ingevoegd wanneer je links toevoegt in artikelen.

Subfolderhosting is nu ingeschakeld voor je project.

Hoe stel je een aangepast submappad in

Je kunt je kennisbank hosten op een submappad anders dan /docs, zoals /help of /support.

1. Navigeer naar > Knowledge base site in de linker navigatiebalk van de Knowledge base portal.
2. Navigeer naar Custom domain.
3. Op de pagina Aangepast domein navigeer je naar de Subfolder hosting tabblad.
4. Maak het pad in de Submap leeg en voer bijvoorbeeld je aangepaste pad in./help
5. Klik Update.

Houd bij het instellen van een pad anders dan het standaardpad ook rekening met de talen die aan elke werkruimte in je project zijn gekoppeld; De serverconfiguratie hiervoor verschilt per webserver. Je aangepaste submap wordt pas van kracht zodra subfolderhosting is ingeschakeld, en je server moet geconfigureerd zijn om proxyverzoeken voor dit pad te sturen — zie de artikelen over platformspecifieke servers voor richtlijnen.

Hoe stel je een aangepast Site API-pad in

Standaard is het Site API-pad ingesteld op /api. Je kunt dit aanpassen vanuit hetzelfde submap hosting tabblad — bijvoorbeeld naar /docs-api of /api-docs, als /api het al door een andere applicatie op jouw domein wordt gebruikt.

1. Navigeer naar > Knowledge base site in de linker navigatiebalk van de Knowledge base portal.
2. Navigeer naar Custom domain.
3. Op de pagina Aangepast domein navigeer je naar de Subfolder hosting tabblad. Standaard is het Site API-pad ingesteld op /api.
4. Maak het Site API-padveld open en voer bijvoorbeeld je aangepaste pad in./docs-api
5. Klik Update.

Na het instellen van het Site API-pad configureer je een bijpassende locatieblok op je webserver en zorg je ervoor dat de waarde die je hier invoert exact overeenkomt met het pad in de reverse proxy-opstelling van je server. Zie de platformspecifieke servergids voor voorbeelden:

Wat gebeurt er daarna

Zodra je webserver is geconfigureerd, staat je kennisbanksite live in je aangepaste submap. De bestaande Document360-URL blijft echter ook verzoeken bedienen — bijvoorbeeld, zowel example.document360.io als example.com/docs verwijzen naar je kennisbanksite. Dit veroorzaakt dubbele inhoud in zoekmachines zoals Google en Bing.

Om dubbele inhoud te voorkomen, schakel je de schakelaar Restrict subdomain access in onder > Knowledge base site > Custom domain > Subfolder hosting. Zorg ervoor dat een canoniek domein is geconfigureerd voordat je deze schakelaar inschakelt — zodra ingeschakeld, verwijst je Document360-subdomein automatisch naar je canonieke domein.

Gemeenschappelijke webservers

Best practices

• Definieer zowel het Subfolderpad als het Site API-pad samen; Subfolderhosting werkt niet correct als er maar één is ingesteld.
• Gebruik een ander pad dan /api het pad van je Site API-pad als je domein al een andere applicatie bedient op /api, en houd de portaalinstelling en serverconfiguratie synchroon.
• Schakel subdomeintoegang beperken alleen in nadat je canonieke domein volledig is geconfigureerd, om redirect-problemen te voorkomen.
• Test je submapconfiguratie op een stagingpad voordat je het toepast op je productiedomein.

FAQ