Lorsque j'essaie de cliquer sur un lien de la page Web produite par dwww, le message d'erreur suivant s'affiche:
Not Found
The requested URL /cgi-bin/dwww/usr/share/doc/ was not found on this server.
Apache/2.4.10 (Ubuntu) Server at randys-laptop Port 80
J'ai installé le paquet du navigateur de documentation Debian.
Qu'est-ce que je fais mal?
dwww
utilise cgi
pour servir les pages Web et cgi
n'est plus activé dans Apache2
par défaut; vous devez donc activer cgi
:
Sudo a2enmod cgi
Et redémarrez ensuite le service Apache2
avec:
service Apache2 restart
Cela résoudra le problème majeur que vous rencontrez avec dwww
retournant not found
.
Mais vous pourriez rencontrer un autre problème. dwww
autorise l'accès à partir du serveur Web aux fichiers de /var/www/dwww
et /usr/share/doc
(et il suivra les liens symboliques situés dans d'autres répertoires vers /usr/share/doc
).
Le problème supplémentaire que vous pouvez rencontrer est que certains fichiers de documentation ne sont pas dans /usr/share/doc
.
Par exemple (cela dépendra de la documentation que vous avez installée), certains répertoires de /usr/share/gtk-doc/html
sont liés de manière symbolique à /usr/share/doc/...
. Ceux-ci afficheront est dwww
sans problème.
Mais d'autres fichiers ne sont pas et ne s'afficheront pas automatiquement. Le répertoire /usr/share/gtk-doc/html/atk
, par exemple, n’utilise pas de lien symbolique vers /usr/share/doc
. Essayer d'ouvrir ces fichiers avec dwww
a pour résultat:
dwww will not allow you to read the file /usr/share/gtk-doc/html/atk/index.html
Il y a probablement une solution pour cela impliquant Apache2
/dwww
configuration; mais je ne suis pas un expert en Apache2
sécurité et je ne voudrais pas introduire de problème.
La solution de contournement simple consiste à utiliser le protocole file://
pour les très rares fichiers contenant ce problème.
Pour l'exemple de documentation atk
ci-dessus, l'URL générée est la suivante:
http://<server-name>/cgi-bin/dwww/usr/share/gtk-doc/html/atk/index.html?type=html
Vous pouvez aller dans la barre d'adresse et la modifier pour:
file:///usr/share/gtk-doc/html/atk/index.html?type=html
et le fichier se chargera alors.