Hébergement des Spaces dans un sous-dossier
La façon par défaut d’héberger la documentation avec Archbee est sur votre domaine personnalisé, par exemple docs.piedpiper.com. Pour rendre la documentation disponible sur votre domaine principal dans un sous-dossier comme https://www.piedpiper.com/docs, vous devrez avoir accès à vos serveurs Web afin de pouvoir faire un proxy des requêtes vers nos systèmes.
Vous devrez quand même configurer un domaine personnalisé par défaut, puis effectuer un proxy vers celui-ci à partir de votre domaine principal. Nous nous assurerons que Google ne le considère pas comme un duplicata en le signalant via une balise canonique.
Étape 1 : Saisissez le proxy optionnel comme dans l’image ci-dessous
Pendant que vous êtes ici, veuillez vous assurer que le chemin URL à l’étape 5, est le même que celui que vous définissez ci-dessous dans la configuration de votre serveur Web.
Étape 2 : Voici quelques exemples provenant de serveurs Web populaires sur la façon de les configurer pour que le système de proxy fonctionne
Configuration du serveur Nginx
location /docs {
proxy_ssl_server_name on;
proxy_pass https://docs.piedpiper.com/docs
proxy_set_header Host docs.piedpiper.com;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header "requested-by" "proxy";
}Configuration du serveur Apache
Assurez-vous que les modules suivants sont installés et activés :
sudo a2enmod proxy
sudo a2enmod proxy_balancer
sudo a2enmod proxy_httpAjoutez ce qui suit au fichier de configuration du site sous /etc/apache2/sites-available
Par exemple : 000-default.conf
SSLProxyEngine on
ProxyPass "/docs" "https://docs.piedpiper.com/docs"
ProxyPassReverse "/docs" "https://docs.piedpiper.com/docs"Notre configuration complète fonctionnelle de domaine ressemble à ceci :
<VirtualHost *:80>
ServerName piedpiper.com
DocumentRoot "/app"
<Directory "/app">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
SSLProxyEngine on
ProxyPass "/docs" "https://docs.piedpiper.com/docs
ProxyPassReverse "/docs" "https://docs.piedpiper.com/docs"
</VirtualHost>Redémarrez le serveur Apache :
Par exemple, si vous utilisez Apache sur Linux :
$ sudo service apache2 restart