This is an old revision of the document!
Table of Contents
Google Sitemap
DokuWiki can automatically create an XML Sitemap used by several big search engines like Google, Yahoo, and Microsoft.
The sitemap creation is enabled with the sitemap option. The sitemap is placed in the top directory of your DokuWiki installation. Depending on the availability of gzip support in your PHP install it will either be named sitemap.xml.gz
(when gzip is available) or sitemap.xml
(with no gzip support). Nearly all modern PHP installs have gzip support enabled, so sitemap.xml.gz
is your best guess.
When the sitemap is updated, DokuWiki will inform the following search engines automatically through a HTTP “ping”:
Note: the sitemap will only contain pages that are readable by the public without logging in.
Permission Setup
To be able to create a sitemap, the webserver needs to have write access to the sitemap file. The easiest way to make sure it has, is to create an empty sitemap.xml.gz
file and change its permissions accordingly1).
If your sitemap won't be created you can try to get some debug output from the indexer by calling http://yourserver/dokuwiki/lib/exe/indexer.php?debug=1
in your browser.
To force your sitemap to be re-created, try temporarily setting the sitemap option to a large, negative value.
Sitemap Validity
Sitemaps are bound to a domain name. If your sitemaps contains URLs of the form http://domain.org
, the sitemap will not be valid when pulled from http://www.domain.org
and vice versa. To make sure a canonical URL is used you can either configure the baseurl setting or redirect “mismatching” URLs via another rewrite rule in your .htaccess
:
Rewrite example (Apache):
RewriteEngine on RewriteCond %{HTTP_HOST} !^www\.domain\.org$ [NC] RewriteRule ^(.*)$ http://www.domain.org/$1 [R,L]