= Google sitemap generator = == Description == This plugin will handle requests of the URL /sitemap.xml and will produce XML suitable for submission to the [https://www.google.com/webmasters/sitemaps/docs/en/about.html Google sitemap] service. The sitemap is a way to describe your site's content other than depending on a crawler that follows every link. It's suitable for dynamic sites with lots of different URLs for basically the same content. The maintainer-ship of this plugin for Trac 0.11+ was taken over by [wiki:martin_s] in May 2010. The new Trac 0.11 version was written from scratch, mainly because of great API changes between the Trac versions. This wiki page is not yet fully updated to reflect the (sometimes missing) features of the new version. The plugin will notify Google by sending a PING request to their site whenever content on your trac has changed (Trac 0.10 version only). For now, wiki pages are supported in the sitemap, but tickets will eventually follow. == Requirements == The plugin was tested with Python 2.4 but should work with 2.3 as well. It uses API extensions of trac 0.10, so it wouldn't run with older versions of trac. Furthermore, you need '''setuptools''' to install and run the extension. If the [http://trac.edgewall.org/wiki/WebAdmin webadmin plugin] is installed, this plugin will register a page to configure it. == Installation == Download the source code into a directory of your choice, open a command line terminal and run this command: {{{ python setup.py install }}} Activate the plugin in your trac environment by adding this line to the section [component] of trac.ini {{{ sitemap.* = enabled }}} Restart your webserver. == Bugs/Feature Requests == See [query:status!=closed&component=GoogleSitemapPlugin&order=priority existing bugs and feature requests], and feel free to create a [/newticket?component=GoogleSitemapPlugin&owner=martin_s new ticket]. == Download and Source == Trac 0.10:: The project has been recently reactivated, since the original source code location has been switched off. In future, source will be on trac hacks SVN. Meanwhile, there's a trac.10 compatible egg available as an attachment [attachment:sitemap-0.1dev_r18-py2.5.egg.tar.gz here]. Place it in the Trac {{{plugins}}} directory, e.g. {{{/usr/share/trac/plugins}}}. Visit http://svn.software-consultant.net/browser/sitemap-plugin/trunk to browse the source code. == Example == This is how a sitemap XML could look like: {{{ #!xml http://localhost/wiki/ImageTest 2006-11-07T15:37:07Z daily }}} More about the document format can be found [https://www.google.com/webmasters/sitemaps/docs/en/protocol.html here]. == Recent Changes == [[ChangeLog(googlesitemapplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:martin_s] (Trac 0.11), [wiki:datenimperator] (Trac 0.10) [[BR]] '''Contributors:'''