Tagann Django le creat giniúna láithreáin ardleibhéil chun comhaid sitemap XML a chruthú.
\nIs comhad XML é léarscáil an láithreán gréasáin ar do shuíomh Gréasáin a insíonn innéacsóirí inneall cuardaigh cé chomh minic a athraíonn do leathanaigh agus cé chomh tábhachtach agus atá leathanaigh áirithe maidir le leathanaigh eile ar do shuíomh. Cuidíonn an fhaisnéis seo le hinnill chuardaigh do láithreán a
\nDéanann creat láithreán gréasáin Django cruthú an chomhad XML seo a uathoibriú trí ligean duit an fhaisnéis seo a chur in iúl i gcód Python.
\nOibríonn sé cosúil le Django: doc: creat sindication </ref/contrib/syndication>. Chun léarscáil an léarscáileáin a chruthú, scríobh a:class: ~django.contrib.sitemaps.siteMap rang agus dírigh air i d:doc: URLCon</topics/http/urls> f.
\nChun an aip léarscáileáin a shuiteáil, lean na céimeanna seo:
\nCuir django.contrib.sitemaps' le do shocrú: INSTALLED_APPS.
Déan cinnte go bhfuil cúltaca DjangoTemplates ag do shuíomh: setting: TEMPLATES a bhfuil a roghanna APP_DIRS socraithe go True. Tá sé ann de réir réamhshocraithe, mar sin ní bheidh ort é seo a athrú ach má tá an socrú sin athraithe agat.
<django.contrib.sites>Déan cinnte go bhfuil creat:mod: `sites `suiteáilte agat.
(Nóta: Ní shuiteálann an feidhmchlár léarscáileáin aon táblaí bunachar sonraí. Is é an t-aon chúis a chaithfidh sé dul chuig: setting: INSTALLED_APPS ionas gur féidir leis an lódóir teimpléad:func: ~django.template.loaders.app_directories.loader na teimpléid réamhshocraithe a aimsiú.)
\nChun giniúint léarscáileán gréasáin a ghníomhachtú ar do shuíomh Django, cuir an líne seo le duit:doc: URLConf:: </topics/http/urls>
\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)\nInsíonn sé seo le Django léarscáil an léarscáileáin a thógáil nuair a fhaigheann cliant rochtain aith:file: /sitemap.xml.
\nNíl ainm an chomhaid léarscáileáin tábhachtach, ach tá an suíomh. Ní innéacfaidh innill chuardaigh ach naisc i do léarscáil gréasáin don leibhéal reatha URL agus thíos. Mar shampla, má tá: file: sitemap.xml ina gcónaí i d'eolaire fréimhe, féadfaidh sé tagairt a dhéanamh ar aon URL ar do shuíomh. Mar sin féin, má tá do léarscáil an léarscáileáin ina g:file: /content/sitemap.xml, ní fhéadfaidh sé tagairt a dhéanamh ach URLanna a thosaíonn la:file: /content/.
\nTógann an dearcadh léarscáileáin argóint breise riachtanach: {'sitemaps': sitemaps}. Ba chóir go mbeadh sitemaps ``ina fhoclóir a mhapálann lipéad gearrchuid (m.sh., ``blog nó nuacht) chuig a aicme:class: ~django.contrib.sitemaps.sitemap (m.sh., BlogSitemap nó NewsSitemap). Féadfaidh sé léarscáil freisin chuig ranga*teacht* de a:class: ~django.contrib.sitemaps.sitemap (m.sh., ``BlogSitemap (some_var) `).
SitemapLink to this heading#A: Class: “~django.contrib.SiteMaps.SiteMap` aicme Python é rang a léiríonn “cuid” d'iontrálacha i do léarscáil an léarscáileáin. Mar shampla, d'fhéadfadh rang amháin: class: ~django.contrib.sitemaps.sitemap iontrálacha uile do bhlag a léiriú, agus d'fhéadfadh ceann eile léiriú a dhéanamh ar na himeachtaí go léir i d'fhéilire imeachtaí.
\nSa chás is simplí, cuirtear na codanna seo go léir le chéile i gceann amháin: file: sitemap.xml, ach is féidir an creat a úsáid freisin chun innéacs léarscáil an léarscáileáin a ghiniúint a thagann tagairt do chomhaid léarscáileáin aonair, ceann in aghaidh an roinn. (Féach `Innéacs léarscáileáin a chruthú `_ thíos.)
\nSitemap classes must subclass\ndjango.contrib.sitemaps.Sitemap. They can live anywhere in your codebase.
Glacaimis leis go bhfuil córas blag agat, le samhail ``Iontrála`, agus ba mhaith leat go n-áireofaí do léarscáil an léir le d'iontrálacha blag aonair. Seo mar a d'fhéadfadh cuma ar do rang léarscáileán gréasáin:
\nfrom 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\nNóta:
\n<changefreq><priority>:attr: ~SiteMap.ChangeFreq agus:attr: ~SiteMap.Priority tréithe aicme iad a fhreagraíonn d'eilimintí ```` agus ````, faoi seach. Is féidir iad a dhéanamh inghlaoch mar fheidhmeanna, mar: attr: ~SiteMap.LastMod a bhí sa sampla.
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#Is féidir le rang Sitemap na modhaí/tréithe seo a leanas a shainiú:
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.
**Roghnach. ** Modh nó tréith.
\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().
Sa dá chás, ciallaíonn “cosán iomlán” URL nach bhfuil an prótacal nó an fearann san áireamh. Samplaí:
\nGo maith: '/foo/bar/'
Droch: `example.com/foo/bar/'
Droch: '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.
Chun prótacal seachas 'http' a shonrú, bain úsáid:attr: ~SiteMap.Protocol.
**Roghnach. ** Modh nó tréith.
\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().
Má tá a:attr: ~SiteMap.lastMod ag gach mír i léarscáil an léarscáileáin, beidh ceannteideal Last-Modified ag an léarscáileán a ghineann: func: views.sitemap comhionann leis an lastmod` is déanaí. Is féidir leat an: class: ~django.middleware.http.ConditionalGetMiddleware a ghníomhachtú chun a chur ar Django freagairt go cuí d'iarratais le ceannteideal If-Modfied-Since a chuirfidh cosc ar an léarscáil an léarscáil a sheoladh mura bhfuil sé athraithe.
** Roghnach. **
\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.
**Roghnach. ** Modh nó tréith.
\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().
Is iad na luachanna féideartha le haghaidh: attr: ~SiteMap.ChangeFreq, cibé acu a úsáideann tú modh nó tréith, ná:
\n\n**Roghnach. ** Modh nó tréith.
\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().
Luachanna samplacha le haghaidh: attr: ~SiteMap.Priority: 0.4, 1.0`. Is é 0.5 tosaíocht réamhshocraithe leathanaigh. Féach an doiciméadú `sitemaps.org `_ le haghaidh tuilleadh eolais.
** Roghnach. **
\nSainmhíníonn an tréith seo prótacal ('http' nó https') na URLanna sa léarscáil an léarscáileáin. Mura bhfuil sé socraithe, úsáidtear an prótacal lena n-iarradh an léarscáil an léarscáileáin. Má tá an léarscáil an léarscáileáin tógtha lasmuigh de chomhthéacs iarratais, is é ``https'` an réamhshocraithe.
** Roghnach. **
\nSainmhíníonn an tréith seo an líon uasta URLanna atá san áireamh ar gach leathanach den láithreán gréasáin. < https://www.sitemaps.org/protocol.html#index>Níor chóir go mbeadh a luach níos mó ná luach réamhshocraithe 50000, is é sin an teorainn uachtarach a cheadaítear sa phrótacal `Sitemaps `_.
** Roghnach. **
\nTréith boolean a shainmhíníonn an cheart URLanna an léarscáileáin seo a ghiniúint ag baint úsáide as do chuid uil:setting: LANGUAGES. Is é an réamhshocrú False.
** Roghnach. **
\nA: Téarma: seiche <language code>am de:téarma: cóid teanga `le húsáid chun naisc mhalartacha a ghiniúint nuair a chumasaítear: attr: `~SiteMap.I18N. Réamhshocraithe chuig: socrú: LANGUAGES.
\n** Roghnach. **
\nTréith boolean. Nuair a úsáidtear iad i gcomhar le:attr: ~SiteMap.i18n beidh liosta de naisc mhalartacha ag gach ceann acu ag díriú ar leaganacha teanga eile ag baint úsáide as an tréith hreflang `_. Is é an réamhshocrú ``False`.
\n** Roghnach. **
\nTréith boolean. Nuair a bheidh True` beidh iontráil hreflang="x-default" le luach de:setting: LANGUAGE_CODE sna naisc malartacha a ghineann: ~SiteMap.Alternates. Is é an réamhshocrú False.
**Roghnach. ** Modh a thugann an luach is déanaí ar ais ag: attr: ~SiteMap.LastMod. <sitemap-index-context-variables>Úsáidtear an fheidhm seo chun an tréith lastmod a chur chuig: ref: `Athróga comhthéacs innéacs Láithreáin Láithreáin `.
De réir réamhshocraithe: meth: ~SiteMap.get_Latest_LastMod tuairisceann:
\n\n**Roghnach. ** Modh a thugann seicheamh na gcód teanga ar taispeántar an mír ina leith. De réir réamhshocraithe: meth: ~SiteMap.get_Languages_for_item filleadh: attr: ~SiteMap.Languages.
\nSoláthraíonn creat an léarscáileáin rang áisiúlachta do chás coiteann:
\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.
Ceadaíonn argóintí eochairfhocal:: attr: :attr: ~SiteMap.ChangeFreq, agus:attr: ~SiteMap.Protocol argóintí eochairfhocal na tréithe seo a shonrú do gach URLanna.
\nSeo sampla de a:doc: URLConf ag baint úsáid:class: GenericSiteMap </topics/http/urls>:
\nfrom 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]\nGo minic ba mhaith leat craoltóirí inneall cuardaigh tuairimí a innéacsú nach leathanaigh mionsonraí réada ná leathanaigh cothroma iad. Is é an réiteach ainmneacha URL do na tuairimí seo a liostáil go sainráite i items agus glaoch ar: func: ~django.urls.reverse sa mhodh suíomha ar an láithreán gréasáin. Mar shampla:
# 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]\nTá sé de chumas ag creat an léarscáileáin léarscáileáin innéacs léarscáileáin a chruthú a thagann tagairt do chomhaid léarscáileáin aonair, ceann in aghaidh gach roinn a shainmhínítear i do fhoclóir Is iad na difríochtaí amháin maidir le húsáid ná:
\nÚsáideann tú dhá radharc i do URLConf: :func: django.contrib.sitemaps.views.index agus:func: django.contrib.sitemaps.views.sitemap.
Ba chóir go dtógfadh argóint eochairfhocal section an dearcadh: django.contrib.sitemaps.views.sitemap.
Seo an chuma a bheadh ar na línte URLConf ábhartha don sampla thuas:
\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]\nGhinfidh sé seo comhad a:file: sitemap.xml go huathoibríoch a thagann tagairt don araon: file: sitemap-flatpages.xml agus:file: sitemap-blog.xml. Ní athraíonn na ranganna: Class: ~Django.Contrib.SiteMaps.Sitemap agus an dict ``Sitemaps ``ar chor ar bith.
\nIf all sitemaps have a lastmod returned by\nget_latest_lastmod() the sitemap index will have a\nLast-Modified header equal to the latest lastmod.
Ba chóir duit comhad innéacs a chruthú má tá níos mó ná 50,000 URL ag ceann de do léarscáileanna láithreáin. Sa chás seo, déanfaidh Django an léarscáil an léarscáil uathoibríoch, agus léireoidh an t-innéacs é sin.
\nMura bhfuil tú ag úsáid an radharc léarscáileáin fanaile - mar shampla, má tá sé fillte le maisitheoir caching - ní mór duit d'amharc léarscáileáin a ainmniú agus sitemap_url_name a chur chuig an amharc innéacs:
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]\nMás mian leat teimpléad difriúil a úsáid do gach léarscáil an léarscáileáin nó innéacs léarscáileáin atá ar fáil ar do shuíomh, féadfaidh tú é a shonrú trí pharaiméadar template_name a chur chuig na tuairimí sitemap agus index tríd an URLConf:
from 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]\nTugann na tuairimí seo ar ais: class: ~django.template.Response.TemplateResponse cásanna a ligeann duit na sonraí freagartha a shaincheapadh go héasca sula ndéantar iad a rindreáil. Le haghaidh tuilleadh sonraí, féach an:doc: `TemplateResponse doiciméadúcháin </ref/template-response>.
\nAgus na teimpléid á shaincheapadh le haghaidh tuairimí: func: ~django.contrib.sitemaps.views.index agus:func: ~django.contrib.sitemaps.views.sitemap, is féidir leat brath ar na hathróga comhthéacs seo a leanas.
\nIs é an t-athróg sitemaps ``liosta de na rudaí ina bhfuil an tréith ``suíomh agus lastmod do gach ceann de na léarscáileanna láithreáin. Nochtann gach URL na tréithe seo a leanas:
láithreach: Suíomh (url & leathanach) an léarscáileáin.
lastmod: Daonraithe ag an modh: meth: ~SiteMap.get_Latest_LastMod do gach léarscáil an léarscáileáin.
Is é an t-athróg urlset` liosta de URLanna ba chóir a bheith le feiceáil sa léarscáil an léarscáileáin. Nochtann gach URL tréithe mar a shainmhínítear san aicme:class: ~django.contrib.sitemaps.siteMap:
\nmalartach
Changefreq
Míre
lasmod
suíomh
``tosaíocht ``
Tá an tréith alternates ar fáil nuai:attr: ~SiteMap.I18n agus:attr: ~SiteMap.Alternates cumasaithe. Is liosta de leaganacha teanga eile é, lena n-áirítear an fillback roghnaí:attr: ~SiteMap.x_default, do gach URL. Is foclóir é gach malartach le heochracha láithreach agus 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