Het hosten van je Document360-kennisbank in een submap op Apache, zoals example.com/docs, vereist het inschakelen van Apache-modules en het configureren van proxy- en redirect-regels. Dit artikel behandelt het inschakelen van de benodigde modules, het routeren van de startpagina, artikel- en categoriepagina's, en het Site API-pad, het genereren van sitemaps en het afhandelen van URL-omleiding om dubbele inhoud in zoekmachines te voorkomen.
Vervang het voorbeelddomein in dit artikel door je eigen door Document360 geleverde domein of aangepaste domein. Bijvoorbeeld, example.document360.io vertegenwoordigt je domein, example.document360.io/v1 een submap pad van de werkruimte, en example.document360.io/help een pad op de startpagina van een submap.
Voordat je begint
Subfolderhosting werkt alleen wanneer zowel het Subfolderpad (bijvoorbeeld /docs of /help) als het Site API-pad (bijvoorbeeld /api) zijn gedefinieerd in Document360, met een bijpassende configuratie op je server.
Zorg ervoor dat de volgende Apache-modules zijn ingeschakeld — deze maken deel uit van de standaard Apache-installatie:
proxyproxy_httpheaderssubstituteproxy_html
Stel ze in staat met:
sudo a2enmod proxy proxy_http headers substitute proxy_html
Hoe de startpagina te configureren
Configureer het volgende Virtual Host-locatieblok om verzoeken voor de startpagina te proxyen, waarbij het pad begint met /help:
<Location /help>
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
RequestHeader unset Accept-Encoding
ProxyPass https://example.document360.io/v1
ProxyPassReverse https://example.document360.io/v1
AddOutputFilterByType SUBSTITUTE text/html
substitute 's|href="/docs|href="/help|ni'
substitute 's|href="/v1/docs|href="/help|ni'
substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
</Location>
Artikelen preview-links voor submap hosting repareren
Links voor artikelvoorbeelden in het Document360-portaal bevatten de werkruimte en taalslug in de URL. Bijvoorbeeld, de live article URL kan docs.example.com/getting-startedzijn , terwijl de portal preview-link . docs.example.com/v1/en/getting-started Je kunt ofwel een locatieblok toevoegen om het /v1/en pad te verwerken, of een omleiding instellen van /v1/en naar /:
RewriteEngine on
RewriteRule ^v1/en$ / [R=301,L,NC]
Deze omleiding vereist de rewrite module:
sudo a2enmod rewrite
Hoe je artikel- en categoriepagina's configureert
Voeg de volgende locatieblokken toe aan hetzelfde Apache Virtual Host-configuratiebestand aan proxy-artikel-, categorie- en API-verzoeken:
<Location /help/>
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
ProxyPass https://example.document360.io/docs/
ProxyPassReverse https://example.document360.io/docs/
AddOutputFilterByType SUBSTITUTE text/html
substitute 's|href="/docs|href="/help|ni'
substitute 's|href="/v1/docs|href="/help|ni'
substitute 's|href="https://example.document360.io/docs|href="https://docs.example.com/help|ni'
</Location>
<Location /api>
ProxyPreserveHost off
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
RequestHeader unset Accept-Encoding
ProxyPass https://example.document360.io/api
ProxyPassReverse https://example.document360.io/api
AddOutputFilterByType SUBSTITUTE application/json
substitute 's|href="/docs/|href="/help/|ni'
substitute 's|href="/v1/docs/|href="/help/|ni'
substitute 's|href="https://example.document360.io/docs/|href="https://docs.example.com/help/|ni'
</Location>
Herstart de Apache-server zodra deze is geconfigureerd:
sudo systemctl restart apache2
Vervang /docs en /api door de exacte waarden die zijn geconfigureerd onder Subfolderpad en Site API-pad in het Document360-portaal.
Hoe je sitemapgeneratie instelt
Het sitemap-prefix blijft hetzelfde, behalve voor de taalcode (en, fr, de, enzovoort).
<Location /sitemap.xml.en>
RequestHeader set Host example.document360.io
RequestHeader set requested-by proxy
ProxyPass https://example.document360.io/sitemap.xml.en
ProxyPassReverse https://example.document360.io/sitemap.xml.en
</Location>
Wat gebeurt er daarna
Zodra Apache is geconfigureerd, staat je kennisbanksite live in je aangepaste submap. De bestaande Document360-URL blijft ook verzoeken bedienen — bijvoorbeeld, zowel example.document360.io en 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 Subdomeintoegang Beperken in onder > Knowledge base site > Custom domain > Subfolder hosting. Zorg ervoor dat een canoniek domein is geconfigureerd voordat je dit inschakelt — zodra ingeschakeld, wordt je Document360-subdomein automatisch doorgestuurd naar je canonieke domein.
Best practices
- Schakel alle vijf vereiste Apache-modules in (
proxy,proxy_http,headers,substitute, )proxy_htmlvoordat je locatieblokken configureert, anders werkt proxy en herschrijven niet. - Houd het Subfolderpad en het Site API-pad identiek tussen het Document360-portaal en je Apache-configuratie om gebroken routering te voorkomen.
- Gebruik de
substituteregels consequent over de blokken op de startpagina, artikel/categorie en API-locaties om gemengde/docslinks/helpop de live site te voorkomen. - Stel de
/v1/endoorverwijzing voor artikelvoorbeeldlinks vroeg in, omdat niet-overeenkomende previewlinks anders verwarring kunnen veroorzaken voor contentauteurs.