Django levereras med ett ramverk för generering av sitemap på hög nivå för att skapa sitemap XML-filer.
\nEn webbplatskarta är en XML-fil på din webbplats som berättar för sökmotorindexerare hur ofta dina sidor ändras och hur ”viktiga” vissa sidor är i förhållande till andra sidor på din webbplats. Den här informationen hjälper sökmotorer att indexera din webbplats.
\nDjangos ramverk för webbplatskartor automatiserar skapandet av denna XML-fil genom att låta dig uttrycka denna information i Python-kod.
\nDet fungerar ungefär som Djangos syndication-ramverk. För att skapa en webbplatskarta, skriv en Sitemap-klass och peka på den i din URLconf.
Följ dessa steg för att installera appen för webbplatskartor:
\nLägg till 'django.contrib.sitemaps' i inställningen INSTALLED_APPS.
Se till att din TEMPLATES-inställning innehåller en DjangoTemplates-backend vars APP_DIRS-alternativ är inställt på True. Det finns där som standard, så du behöver bara ändra detta om du har ändrat den inställningen.
Se till att du har installerat sites-ramverket.
(Obs: Applikationen för webbplatskartan installerar inga databastabeller. Den enda anledningen till att den behöver läggas in i INSTALLED_APPS är så att Loader() mallladdaren kan hitta standardmallarna)
För att aktivera generering av webbplatskartor på din Django-webbplats, lägg till den här raden i din URLconf:
\nfrom django.contrib.sitemaps.views import sitemap\n\npath(\n "sitemap.xml",\n sitemap,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.sitemap",\n)\nDetta säger till Django att bygga en webbplatskarta när en klient öppnar /sitemap.xml.
Namnet på sitemap-filen är inte viktigt, men platsen är det. Sökmotorer indexerar bara länkar i din sitemap för den aktuella URL-nivån och lägre. Om till exempel sitemap.xml finns i din rotkatalog kan den referera till vilken URL som helst på din webbplats. Men om din webbplatskarta finns i /content/sitemap.xml kan den bara referera till webbadresser som börjar med /content/.
Sitemap-vyn tar ett extra, obligatoriskt argument: {'sitemaps': sitemaps}. sitemaps bör vara en ordbok som mappar en kort sektionsetikett (t.ex. blogg eller nyheter) till dess Sitemap-klass (t.ex. BlogSitemap eller NewsSitemap). Den kan också mappa till en instans av en Sitemap-klass (t.ex. BlogSitemap(some_var)).
SitemapLink to this heading#En Sitemap-klass är en Python-klass som representerar ett ”avsnitt” av poster i din webbplatskarta. Till exempel: kan en sitemap-klass representera alla poster i din blogg, medan en annan kan representera alla händelser i din evenemangskalender.
I det enklaste fallet klumpas alla dessa avsnitt ihop i en sitemap.xml, men det är också möjligt att använda ramverket för att generera ett sitemap-index som refererar till enskilda sitemap-filer, en per avsnitt. (Se ”Skapa ett sitemap-index” nedan.)
Sitemap-klasser måste vara underklasser till django.contrib.sitemaps.Sitemap. De kan finnas var som helst i din kodbas.
Låt oss anta att du har ett bloggsystem, med en Entry-modell, och du vill att din sitemap ska innehålla alla länkar till dina enskilda blogginlägg. Så här kan din sitemap-klass se ut:
from django.contrib.sitemaps import Sitemap\nfrom blog.models import Entry\n\n\nclass BlogSitemap(Sitemap):\n changefreq = "never"\n priority = 0.5\n\n def items(self):\n return Entry.objects.filter(is_draft=False)\n\n def lastmod(self, obj):\n return obj.pub_date\nAnteckning:
\nchangefreq och priority är klassattribut som motsvarar elementen <changefreq> respektive <priority>. De kan göras anropbara som funktioner, som lastmod var i exemplet.
items() is a method that returns a sequence or\nQuerySet of objects. The objects returned will get passed to any callable\nmethods corresponding to a sitemap property (location,\nlastmod, changefreq, and\npriority).
There is no location method in this example, but you\ncan provide it in order to specify the URL for your object. By default,\nlocation calls get_absolute_url() on each object\nand returns the result.
SitemapLink to this heading#En Sitemap-klass kan definiera följande metoder/attribut:
Required. A method that returns a sequence or QuerySet\nof objects. The framework doesn’t care what type of objects they are;\nall that matters is that these objects get passed to the\nlocation, lastmod,\nchangefreq and priority methods.
Optionell. Antingen en metod eller ett attribut.
\nIf it’s a method, it should return the absolute path for a given object\nas returned by items().
If it’s an attribute, its value should be a string representing an\nabsolute path to use for every object returned by\nitems().
I båda fallen betyder ”absolut sökväg” en URL som inte innehåller protokollet eller domänen. Exempel på detta:
\nBra: '/foo/bar/'
Dålig: 'example.com/foo/bar/'
Dålig: 'https://example.com/foo/bar/'
If location isn’t provided, the framework will call\nthe get_absolute_url() method on each object as returned by\nitems.
För att ange ett annat protokoll än 'http', använd protocol.
Optionell. Antingen en metod eller ett attribut.
\nIf it’s a method, it should take one argument – an object as returned\nby items() – and return that object’s last-modified\ndate/time as a datetime.
If it’s an attribute, its value should be a datetime\nrepresenting the last-modified date/time for every object returned by\nitems().
Om alla objekt i en sitemap har en lastmod, kommer sitemap som genereras av views.sitemap() att ha en Last-Modified header som är lika med den senaste lastmod. Du kan aktivera ConditionalGetMiddleware för att få Django att svara på lämpligt sätt på förfrågningar med en If-Modified-Since header som förhindrar att webbplatskartan skickas om den inte har ändrats.
**Tillval
\nThis property returns a Paginator for\nitems(). If you generate sitemaps in a batch you may\nwant to override this as a cached property in order to avoid multiple\nitems() calls.
Optionell. Antingen en metod eller ett attribut.
\nIf it’s a method, it should take one argument – an object as returned\nby items() – and return that object’s change\nfrequency as a string.
If it’s an attribute, its value should be a string representing the\nchange frequency of every object returned by items().
Möjliga värden för changefreq, oavsett om du använder en metod eller ett attribut, är:
'always'
'hourly'
'daily'
'weekly'
'monthly'
'yearly'
”aldrig
Optionell. Antingen en metod eller ett attribut.
\nIf it’s a method, it should take one argument – an object as returned\nby items() – and return that object’s priority as\neither a string or float.
If it’s an attribute, its value should be either a string or float\nrepresenting the priority of every object returned by\nitems().
Exempel på värden för priority: 0.4, 1.0. Standardprioriteten för en sida är 0.5. Se sitemaps.org documentation för mer information.
**Tillval
\nDetta attribut definierar protokollet ('http' eller 'https') för webbadresserna i webbplatskartan. Om det inte anges används det protokoll som webbplatskartan begärdes med. Om webbplatskartan skapas utanför ramen för en begäran är standardvärdet ``’https’’.
**Tillval
\nDetta attribut definierar det maximala antalet webbadresser som ingår på varje sida i webbplatskartan. Dess värde bör inte överstiga standardvärdet 50000, vilket är den övre gräns som tillåts i Sitemaps-protokollet.
**Tillval
\nEtt booleskt attribut som anger om webbadresserna i den här webbplatskartan ska genereras med alla dina LANGUAGES. Standardvärdet är False.
**Tillval
\nEn sekvens av språkkoder som ska användas för att generera alternativa länkar när i18n är aktiverad. Standard är LANGUAGES.
**Tillval
\nEtt boolean-attribut. När det används tillsammans med i18n kommer genererade URL:er att ha en lista med alternativa länkar som pekar på andra språkversioner med hjälp av hreflang-attributet. Standardvärdet är False.
**Tillval
\nEtt booleanskt attribut. När det är True kommer de alternativa länkar som genereras av alternates` att innehålla en hreflang="x-default" fallback-post med ett värde av LANGUAGE_CODE. Standardvärdet är False.
**En metod som returnerar det senaste värdet som returneras av lastmod. Denna funktion används för att lägga till attributet lastmod till Sitemap index context variables.
Som standard returnerar get_latest_lastmod():
**En metod som returnerar den sekvens av språkkoder som objektet visas för. Som standard returnerar get_languages_for_item() languages.
Ramverket för webbplatskartor tillhandahåller en bekvämlighetsklass för ett vanligt fall:
\nThe django.contrib.sitemaps.GenericSitemap class allows you to\ncreate a sitemap by passing it a dictionary which has to contain at least\na queryset entry. This queryset will be used to generate the items\nof the sitemap. It may also have a date_field entry that\nspecifies a date field for objects retrieved from the queryset.\nThis will be used for the lastmod attribute and\nget_latest_lastmod() methods in the generated sitemap.
Nyckelordsargumenten priority, changefreq och protocol gör det möjligt att ange dessa attribut för alla URL:er.
Här är ett exempel på en URLconf som använder GenericSitemap:
from django.contrib.sitemaps import GenericSitemap\nfrom django.contrib.sitemaps.views import sitemap\nfrom django.urls import path\nfrom blog.models import Entry\n\ninfo_dict = {\n "queryset": Entry.objects.all(),\n "date_field": "pub_date",\n}\n\nurlpatterns = [\n # some generic view using info_dict\n # ...\n # the sitemap\n path(\n "sitemap.xml",\n sitemap,\n {"sitemaps": {"blog": GenericSitemap(info_dict, priority=0.6)}},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nOfta vill du att sökmotorns sökrobotar ska indexera vyer som varken är objektdetaljsidor eller flatpages. Lösningen är att uttryckligen lista URL-namn för dessa vyer i items och anropa reverse`() i location-metoden i sitemap. Till exempel:
# sitemaps.py\nfrom django.contrib import sitemaps\nfrom django.urls import reverse\n\n\nclass StaticViewSitemap(sitemaps.Sitemap):\n priority = 0.5\n changefreq = "daily"\n\n def items(self):\n return ["main", "about", "license"]\n\n def location(self, item):\n return reverse(item)\n\n\n# urls.py\nfrom django.contrib.sitemaps.views import sitemap\nfrom django.urls import path\n\nfrom .sitemaps import StaticViewSitemap\nfrom . import views\n\nsitemaps = {\n "static": StaticViewSitemap,\n}\n\nurlpatterns = [\n path("", views.main, name="main"),\n path("about/", views.about, name="about"),\n path("license/", views.license, name="license"),\n # ...\n path(\n "sitemap.xml",\n sitemap,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nSitemap-ramverket har också möjlighet att skapa ett sitemap-index som refererar till enskilda sitemap-filer, en för varje avsnitt som definieras i din sitemaps-dictionary. De enda skillnaderna i användning är:
Du använder två vyer i din URLconf: django.contrib.sitemaps.views.index() och django.contrib.sitemaps.views.sitemap().
Vyn django.contrib.sitemaps.views.sitemap() bör ta ett argument med nyckelordet section.
Så här skulle de relevanta URLconf-raderna se ut för exemplet ovan:
\nfrom django.contrib.sitemaps import views\n\nurlpatterns = [\n path(\n "sitemap.xml",\n views.index,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.index",\n ),\n path(\n "sitemap-<section>.xml",\n views.sitemap,\n {"sitemaps": sitemaps},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nDetta kommer automatiskt att generera en sitemap.xml-fil som refererar till både sitemap-flatpages.xml och sitemap-blog.xml. Klasserna Sitemap och dict sitemaps ändras inte alls.
If all sitemaps have a lastmod returned by\nget_latest_lastmod() the sitemap index will have a\nLast-Modified header equal to the latest lastmod.
Du bör skapa en indexfil om en av dina sitemaps har mer än 50 000 webbadresser. I det här fallet kommer Django automatiskt att paginera webbplatskartan och indexet kommer att återspegla det.
\nOm du inte använder vaniljvyn för webbplatskartan - till exempel om den är förpackad med en cachningsdekorator - måste du namnge din webbplatskartvy och skicka sitemap_url_name till indexvyn:
from django.contrib.sitemaps import views as sitemaps_views\nfrom django.views.decorators.cache import cache_page\n\nurlpatterns = [\n path(\n "sitemap.xml",\n cache_page(86400)(sitemaps_views.index),\n {"sitemaps": sitemaps, "sitemap_url_name": "sitemaps"},\n ),\n path(\n "sitemap-<section>.xml",\n cache_page(86400)(sitemaps_views.sitemap),\n {"sitemaps": sitemaps},\n name="sitemaps",\n ),\n]\nOm du vill använda en annan mall för varje webbplatskarta eller index för webbplatskartor som finns på din webbplats kan du ange det genom att skicka en parameter ”template_name” till vyerna ”sitemap” och ”index” via URLconf:
\nfrom django.contrib.sitemaps import views\n\nurlpatterns = [\n path(\n "custom-sitemap.xml",\n views.index,\n {"sitemaps": sitemaps, "template_name": "custom_sitemap.html"},\n name="django.contrib.sitemaps.views.index",\n ),\n path(\n "custom-sitemap-<section>.xml",\n views.sitemap,\n {"sitemaps": sitemaps, "template_name": "custom_sitemap.html"},\n name="django.contrib.sitemaps.views.sitemap",\n ),\n]\nDessa vyer returnerar TemplateResponse-instanser som gör att du enkelt kan anpassa svarsdata före rendering. För mer information, se TemplateResponse-dokumentation.
När du anpassar mallarna för vyerna index() och sitemap() kan du förlita dig på följande kontextvariabler.
Variabeln sitemaps är en lista med objekt som innehåller attributen location och lastmod för var och en av sitemaps. Varje URL innehåller följande attribut:
plats: Platsen (webbadress och sida) för webbplatskartan.
lastmod: Fylls på av metoden get_latest_lastmod() för varje webbplatskarta.
Variabeln urlset är en lista över webbadresser som ska visas i webbplatskartan. Varje URL har attribut som definieras i klassen Sitemap:
alternativ
ändringsfrekvens
objekt
lastmod
plats
prioritet
Attributet alternates är tillgängligt när i18n och alternates är aktiverade. Det är en lista över andra språkversioner, inklusive den valfria x_default fallbacken, för varje URL. Varje alternativ är en ordbok med nycklarna location och lang_code.
The item attribute has been added for each URL to allow more flexible\ncustomization of the templates, such as Google news sitemaps. Assuming\nSitemap’s items() would return a list of items with\npublication_data and a tags field something like this would\ngenerate a Google News compatible sitemap:
<?xml version="1.0" encoding="UTF-8"?>\n<urlset\n xmlns="https://www.sitemaps.org/schemas/sitemap/0.9"\n xmlns:news="https://www.google.com/schemas/sitemap-news/0.9">\n{% spaceless %}\n{% for url in urlset %}\n <url>\n <loc>{{ url.location }}</loc>\n {% if url.lastmod %}<lastmod>{{ url.lastmod|date:"Y-m-d" }}</lastmod>{% endif %}\n {% if url.changefreq %}<changefreq>{{ url.changefreq }}</changefreq>{% endif %}\n {% if url.priority %}<priority>{{ url.priority }}</priority>{% endif %}\n <news:news>\n {% if url.item.publication_date %}<news:publication_date>{{ url.item.publication_date|date:"Y-m-d" }}</news:publication_date>{% endif %}\n {% if url.item.tags %}<news:keywords>{{ url.item.tags }}</news:keywords>{% endif %}\n </news:news>\n </url>\n{% endfor %}\n{% endspaceless %}\n</urlset>\n