Jak przekształcić katalog w indeks HTML lub utworzyć mapę witryny

Aby przekształcić folder systemu Windows w indeks HTML z możliwością przeglądania, należy utworzyć index.htmlstronę z linkami względnymi do zawartości folderu. Program PowerShell może wygenerować taką stronę bez instalowania konwertera. Jeśli chodzi o mapę witryny dla wyszukiwarki, należy utworzyć osobny plik XML z listą publicznych adresów URL witryn; katalog na dysku lokalnym nie jest mapą witryny.

Indeks katalogu HTML a mapa witryny

Indeks katalogu HTML to strona, którą użytkownicy mogą otwierać, aby przeglądać pliki i foldery. Może znajdować się na komputerze, dysku współdzielonym lub serwerze WWW. Mapa witryny XML to czytelna dla maszyn lista preferowanych publicznych adresów URL witryny. Google zaleca w pełni kwalifikowane, bezwzględne adresy URL i kanoniczne wersje stron. Przesłanie mapy witryny jest wskazówką do odkrycia; nie gwarantuje to, że Google przeszuka lub zindeksuje każdy adres URL. Zapoznaj się ze wskazówkami Google dotyczącymi map witryn .

Co się stało z Dir2HTML?

W oryginalnej wersji tego artykułu zalecano Arclab Dir2HTML, narzędzie systemu Windows do tworzenia jednostronicowych lub wielostronicowych indeksów HTML. Arclab obecnie oznacza Dir2HTML jako narzędzie wycofane z eksploatacji: jego rozwój i dystrybucja zostały wstrzymane, firma nie udostępnia już plików do pobrania i nie będzie żadnych przyszłych aktualizacji. Stare linki do pobierania i deklaracje zgodności z systemami Windows 2000, XP i Vista są nieaktualne. W przypadku bieżącego użytkowania należy unikać nieaktualizowanego instalatora z nieznanej witryny pobierania; zamiast tego wbudowana metoda programu PowerShell poniżej tworzy prosty indeks. Oficjalne FAQ dotyczące starszego oprogramowania Arclab zawiera aktualny stan.

Utwórz indeks HTML z katalogu Windows

Ten przykład tworzy index.htmlplik w folderze, który chcesz wyświetlić. Pliki i podfoldery są dodawane rekurencyjnie, używa linków względnych, aby indeks mógł być przenoszony wraz z drzewem folderów, i pomija sam indeks i skrypt. Zapisz skrypt jako .ps1plik i zmień ścieżkę przykładową przed jego uruchomieniem.

1. Wybierz folder źródłowy. W Eksploratorze plików zidentyfikuj katalog do skatalogowania, np D:\ProjectFiles. . Wygenerowana strona zostanie zapisana w tym folderze, więc zachowaj ją obok plików i podfolderów, jeśli przeniesiesz lub opublikujesz indeks. Uwzględnij tylko treści, które zamierzasz udostępnić; strona zawiera listę nazw i linków i nie zmienia uprawnień dostępu do folderu.

2. Zapisz skrypt programu PowerShell. Otwórz Notatnik, wklej poniższy kod, zaktualizuj ścieżkę w pierwszym wierszu i zapisz plik jako Create-DirectoryIndex.ps1. Skrypt używa programu PowerShell Get-ChildItemdo enumeracji drzewa katalogów; Microsoft dokumentuje, że -Recurseopcja ta obejmuje elementy w folderach podrzędnych. Koduje również nazwy plików do użytku w formacie HTML i URL.

$root = (Resolve-Path -LiteralPath 'D:\ProjectFiles').Path
$outFile = Join-Path $root 'index.html'
$scriptPath = $PSCommandPath

$items = foreach ($entry in (Get-ChildItem -LiteralPath $root -Recurse | Where-Object {
    $_.FullName -ne $outFile -and $_.FullName -ne $scriptPath
} | Sort-Object FullName)) {
    $relative = $entry.FullName.Substring($root.TrimEnd('\').Length) -replace '^[\\/]+', ''
    $href = (($relative -split '[\\/]') | ForEach-Object {
        [Uri]::EscapeDataString($_)
    }) -join '/'
    $label = $relative
    if ($entry.PSIsContainer) {
        $href += '/'
        $label += '/'
    }
    $label = [System.Net.WebUtility]::HtmlEncode($label)
    '<li><a href="' + $href + '">' + $label + '</a></li>'
}

if (-not $items) { $items = '<li>No files or folders found.</li>' }
$entryHtml = $items -join [Environment]::NewLine
$html = @"
<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Directory index</title></head>
<body><h1>Directory index</h1><ul>
$entryHtml
</ul></body></html>
"@

Set-Content -LiteralPath $outFile -Value $html -Encoding UTF8
Write-Host "Created $outFile"
Start-Process $outFile

Kod opiera się na wbudowanych poleceniach cmdlet Get-ChildItem i Resolve-Path firmy Microsoft . Elementy ukryte nie są uwzględniane, chyba że dodasz -Forceparametr programu PowerShell. Jeśli Twoje konto nie może odczytać podfolderu, popraw uprawnienia lub utwórz indeks z poziomu konta, które ma uprawnienia do jego wyświetlania.

3. Uruchom skrypt. Otwórz program PowerShell, przejdź do folderu, w którym zapisałeś skrypt, i uruchom go. Na przykład, jeśli skrypt znajduje się w D:\ProjectFiles, wpisz Set-Location -LiteralPath 'D:\ProjectFiles', a następnie .\Create-DirectoryIndex.ps1. Ostatnie polecenie zapisze index.htmli otworzy skrypt w domyślnej przeglądarce. Jeśli Twoja organizacja ogranicza wykonywanie skryptów, postępuj zgodnie z jej zasadami, zamiast zmieniać ustawienia systemowe tylko dla tego zadania.

4. Przejrzyj stronę i linki. Upewnij się, że nazwy są obecne i że przykładowe linki do plików otwierają oczekiwane pliki. Linki do folderów działają, gdy przeglądarka lub serwer WWW zezwala na nawigację po katalogach; w przypadku witryny hostowanej użyj folderów z własnymi stronami indeksowymi lub usuń wpisy katalogów, jeśli wyświetlanie folderów jest wyłączone. Wygenerowany kod HTML należy zachować w tej samej strukturze katalogów, w przeciwnym razie linki względne mogą wskazywać na niewłaściwe miejsce.

Ta lekka strona zawiera listę ścieżek, a nie rozmiary plików, daty, opisy ani niestandardowy motyw. Dodaj te szczegóły tylko wtedy, gdy czytelnicy ich potrzebują; pełniejszy katalog katalogów może wymagać rozbudowanego narzędzia lub dostosowanego skryptu.

Utwórz mapę witryny XML dla aktywnej witryny

Nie przesyłaj indeksu programu PowerShell jako mapy witryny SEO. Robot indeksujący potrzebuje publicznych adresów URL Twojej witryny, takich jak https://www.example.com/guides/setup/, a nie ścieżek lokalnych, takich jak D:\ProjectFiles\guide.pdf. Użyj wbudowanej mapy witryny w systemie CMS, jeśli jest dostępna. W przeciwnym razie wygeneruj plik XML z listy kanonicznych stron witryny i uwzględnij tylko te adresy URL, które mają być brane pod uwagę przez wyszukiwarki. Nie wymyślaj lastmoddat; Google twierdzi, że może użyć tego pola, jeśli wartość jest stale poprawna i weryfikowalna.

Podstawowa mapa witryny XML używa katalogu <urlset>głównego i <url>wpisu z pełnym kwalifikowanym kodem <loc>dla każdej strony. Stosuj znaki specjalne zgodnie z wymaganiami XML. Pojedyncza mapa witryny powinna mieścić się w limicie Google 50 000 adresów URL i 50 MB bez kompresji; większe witryny mogą dzielić pliki i korzystać z indeksu mapy witryny. Opublikuj ją w swojej witrynie – zazwyczaj w katalogu głównym – i prześlij w Search Console lub dodaj odwołanie, robots.txtnp Sitemap: https://www.example.com/sitemap.xml. . Zapoznaj się z protokołem Sitemaps , aby poznać format pliku, oraz z Google Search Central, aby uzyskać wskazówki dotyczące tworzenia i przesyłania.