Podręcznik:GenerateSitemap.php
Plik MediaWiki: generateSitemap.php | |
---|---|
Lokalizacja: | maintenance/ |
Kod źródłowy: | master • 1.35.1 • 1.31.12 |
Klasy: | GenerateSitemap |
Szczegóły
generateSitemap.php to skrypt służący do generowania mapy witryny w MediaWiki. Mapy witryny to pliki umożliwiające łatwiejsze indeksowanie strony przez roboty wyszukiwarek (np. googlebot). Niektóre z nich obsługują protokół sitemap.
Domyślnie, skrypt generuje indeks mapy witryny oraz jedną (skompresowaną w gzip) mapę witryny dla każdej przestrzeni nazw posiadającej zawartość. Zobacz #Opcje, które są przyjmowane przez skrypt.
W MediaWiki 1.16.0 generowana mapa nie współpracuje z Google. Musisz zastosować tę poprawkę.
Po więcej informacji na temat korzystania ze skryptów konserwacyjnych, zobacz Podręcznik:Skrypty konserwacyjne .
Opcje
--help
- Wyświetla dostępne opcje przyjmowane przez
generateSitemap.php
--fspath=<path>
- Ścieżka systemu plików gdzie wynik będzie zapisany np.
sitemap/
. Ktalog musi być dostępny z poziomu online!
--identifier=<identifier>
- Jakie miejsce identyfikator użyć do wiki, domyślnie $wgDBname
--urlpath=<prefix>
- Adres URL wskazujący na
--fspath
, np.- /sitemap/
- If specified, gets prefixed to the filenames in the sitemap index. This is needed because some search engines like Google require absolute URLs in sitemaps. You should specify
--server
also; the values will often be similar, but having them separate allows the script to accommodate even unusual setups. - Before MediaWiki 1.32.0 this parameter should contain the protocol and host name. However, since MediaWiki 1.32.0 the contents of this parameter will be appended to the
--server
parameter, thus it must neither contain protocol nor hostname. This is a breaking change not announced via the RELEASE-NOTES.
--server=<server>
- Protokół i nazwa hosta do użycia w adresach URL, np.
- Jest to czasami potrzebne, gdy nie powiedzie się automatyczne pobranie nazwy serwera i w adresach mogą pojawić się domeny "localhost" lub "my.servername".
- If set the value of
$wgCanonicalServer
will override the value of this option in all sitemap files except for the sitemap index file.
--compress=[yes|no]
- Czy kompresować pliki map witryn? Domyślne ustawienie:
yes
--skip-redirects
- Po dodaniu tej opcji, przekierowania są pomijane i nie będą dodawane do mapy witryny. Jest zalecana, ponieważ Google może narzekać na przekierowania. Mimo to, domyślnym ustawieniem jest niepomijanie przekierowań.
Przykład
Tworzenie mapy witryny dla Google Webmaster Tools:
Najpierw (w $IP):
mkdir sitemap
Następnie:
Wersja MediaWiki: | ≥ 1.32 |
php maintenance/generateSitemap.php --memory-limit=50M --fspath=/path/to/examplecom/sitemap/ --identifier=examplecom --urlpath=/sitemap/ --server=https://www.example.com --compress=yes
For older versions (MediaWiki <1.32) |
---|
php maintenance/generateSitemap.php --memory-limit=50M --fspath=/path/to/examplecom/sitemap/ --identifier=examplecom --urlpath=https://www.example.com/sitemap --server=https://www.example.com --compress=yes
|
Dla domen, które nie używają liter alfabetu łacińskiego, trzeba użyć Punycode.
Podobne ustawienia w LocalSettings.php
Wersja MediaWiki: | ≥ 1.13 |
$wgSitemapNamespaces
: Tablica nazw do generowania mapy witryny Google dla, lub fałsz jeśli ma być generowane dla wszystkich nazw.Domyślnym ustawieniem jestfalse
.
Wersja MediaWiki: | ≥ 1.19 |
$wgSitemapNamespacesPriorities
: Priorytety przestrzeni nazw dla sitemaps. Powinno to być mapa identyfikatorów przestrzeni nazw do priorytetu. Domyślnym ustawieniem jestfalse
.