DokuWiki can automatically create an XML Sitemap used by several big search engines like Google, Yahoo, and Microsoft.

Before continuing, enable sitemap creation by setting the sitemap properties under Configuration Settings. The sitemap is placed in the cache subdirectory of your DokuWiki installation. It will be accessed by the following type of URL http://your_domain/dokuwiki/doku.php?do=sitemap. 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”:

• Google
• Yahoo
• Microsoft Live/MSN

Note: the sitemap will only contain pages that are readable by the public without logging in.

TODO: ?do=sitemap MUST allow restriction to namespaces. You can always have multiple sitemaps for different purposes and ?do=sitemap&ns=some_ns&ns=… must be supported.

To be able to create a sitemap, the webserver needs to have write access to the sitemap file in /data/cache. The easiest way to make sure it has, is to create an empty sitemap.xml.gz file and change its permissions accordingly¹⁾.

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.

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]

• DokuWiki and Searchengines
• Google Webmaster Tools, use it to manage your sitemaps and monitor googlebot crawling reports about your site