Podręcznik:GenerateSitemap.php
| Plik MediaWiki: generateSitemap.php | |
|---|---|
| Lokalizacja: | maintenance/ |
| Kod źródłowy: | master • 1.42.3 • 1.41.4 • 1.39.10 |
| 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
--serveralso; 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
--serverparameter, 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
$wgCanonicalServerwill 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:
mkdir sitemap
Następnie wygeneruj mapę witryny:
| Wersja MediaWiki: | ≥ 1.40 |
php maintenance/run.php generateSitemap --memory-limit=50M --fspath=/path/to/examplecom/sitemap/ --identifier=example.com --urlpath=/sitemap/ --server=https://www.example.com --compress=yes --skip-redirects
| Wersje MediaWiki: | 1.32 – 1.39 |
php maintenance/generateSitemap.php --memory-limit=50M --fspath=/path/to/examplecom/sitemap/ --identifier=example.com --urlpath=/sitemap/ --server=https://www.example.com --compress=yes --skip-redirects
| Wersja MediaWiki: | ≤ 1.31 |
php maintenance/generateSitemap.php --memory-limit=50M --fspath=/path/to/examplecom/sitemap/ --identifier=example.com --urlpath=https://www.example.com/sitemap --server=https://www.example.com --compress=yes --skip-redirects
This will create a sitemap index stored at /path/to/examplecom/sitemap/sitemap-index-example.com.org.xml which points to a compressed XML file for each namespace, e.g. /path/to/examplecom/sitemap/sitemap-example.com-NS_0-0.xml.gz for the main namespace.
This does not mean your sitemap can now be found automatically! You will then need to submit the link for the sitemap index to the crawling site (eg Yandex or Google), i.e. https://www.example.com/sitemap/sitemap-index-example.com.org.xml .
Alternatively, you can make this findable by any crawler by adding a link to the sitemap index to your site root directory e.g.:
ln -s /sitemap/sitemap-index-example.com.org.xml sitemap.xml
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.