[[PageOutline(2-5,Contents,pullout)]] = Google sitemap generator == Description This plugin produces a site map file 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 is suitable for dynamic sites with lots of different URLs for basically the same content and it allows your web site to be found better and searched better. The plugin can be configured to notify Google by sending a PING request to their site when content on your Trac has changed (Trac 0.10 version only). For now, wiki pages and tickets are supported in the sitemap. Other things like source code and pages produced by other plugins could also be included. The sitemap is implemented in the XML format. This is what a sample sitemap XML could look like: {{{#!xml http://yourtracurl/tracproject/wiki/WikiStart 2010-11-07T15:37:07Z daily http://yourtracurl/tracproject/wiki/SomePage 2010-11-07T16:22:35Z daily }}} More about the document format can be found [https://www.google.com/webmasters/sitemaps/docs/en/protocol.html here]. '''Fork:''' I have made a [https://github.com/trac-hacks/trac-googlesitemapplugin fork on GitHub] with some improvements/fixes. Feel free to [https://github.com/trac-hacks/trac-googlesitemapplugin/issues suggest new features]. The maintainership 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 the API changes between the Trac versions. This wiki now describes only the Trac 0.11 (and newer branches in the future). The [./@10 description for the 0.10 branch] is also available. == Bugs/Feature Requests Existing bugs and feature requests for GoogleSitemapPlugin are [report:9?COMPONENT=GoogleSitemapPlugin here]. If you have any issues, create a [/newticket?component=GoogleSitemapPlugin new ticket]. [[TicketQuery(component=GoogleSitemapPlugin&group=type,format=progress)]] == Download Download the zipped source from [export:googlesitemapplugin here]. The plugin is also available on [pypi:TracGoogleSitemapPlugin PyPI]. == Source You can check out GoogleSitemapPlugin for Trac 0.11 from [/svn/googlesitemapplugin/0.11 here] using Subversion, or [source:googlesitemapplugin/0.11 browse the source] with Trac. == Installation Download the source code into a directory of your choice, open a command line terminal and run this command: {{{#!sh python setup.py install }}} or use `easy_install` either on the downloaded source code or the SVN URL: {{{#!sh easy_install # or pip install svn+https://trac-hacks.org/svn/googlesitemapplugin/0.11 }}} Activate the plugin and, optionally, the automatic notification in your Trac environment by adding this line to the `[components]` section of your `../conf/trac.ini` file or use the IniAdminPlugin: {{{#!ini [components] tracgooglesitemap.plugin = enabled tracgooglesitemap.notify = enabled # optional, notifies Google to reload the sitemap when content has changed }}} Restart your web server or Trac server: {{{#!sh $ trac-admin /path/to/env deploy /deploy/path }}} == Configuration The following options are supported. They must be placed under a `[googlesitemap]` section in the configuration file. sitemappath:: Path of the sitemap relative to the main URL. Default: `sitemap.xml`. ignore_users:: Do not include wiki pages created by the listed users. Default: `trac` (excludes all standard Trac wiki pages). ignore_wikis:: Do not include the following wikis. The wildcards '`*`' and '`?`' are allowed and have there usual meaning. list_realms:: Which realms to list, ie `wiki` or `ticket`. Default: `wiki,ticket`. change_frequency:: Change frequency for all entries. Valid values: always, hourly, daily, weekly, monthly, yearly, never. Disabled if empty (default). compress_sitemap:: Compress sitemap, either by using HTTP gzip `content-encoding` if the client supports it (Googlebot does) or by requesting the sitemap with a trailing `.gz`. compression_level:: Compression level used: 0 (low/fast) to 9 (high/slow). Default: 6. The notifier can be told on which action Google should be notified about the sitemap change: notifyon:: List of actions on which Google should be notified. The action names are based on the Trac permissions needed to execute the actions. Supported actions are: TICKET_CREATE, TICKET_DELETE, TICKET_MODIFY, WIKI_CREATE, WIKI_DELETE, WIKI_VERSION_DELETE, WIKI_MODIFY, WIKI_RENAME. By default Google will be notified when a ticket or wiki is created or modified, but not when it is deleted. Default: TICKET_CREATE, TICKET_MODIFY, WIKI_CREATE, WIKI_VERSION_DELETE, WIKI_MODIFY, WIKI_RENAME. == Recent Changes [[ChangeLog(googlesitemapplugin, 3)]] == Author/Contributors '''Author:''' [wiki:martin_s] (Trac 0.11), [wiki:datenimperator] (Trac 0.10) [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:'''