Cum să transformi un director într-un index HTML sau să creezi o hartă a site-ului

Pentru a transforma un folder Windows într-un index HTML răsfoibil, creați o index.htmlpagină cu linkuri relative către conținutul folderului. PowerShell poate genera una fără a instala un convertor. Dacă vă referiți la o hartă a site-ului pentru motorul de căutare, creați un fișier XML separat care să listezeze adresele URL ale site-urilor web publice; un director pe disc local nu este o hartă a site-ului web.

Indexul directoarelor HTML vs. harta site-ului web

Un index de directoare HTML este o pagină pe care oamenii o pot deschide pentru a răsfoi fișiere și foldere. Poate fi găsit pe un PC, pe o unitate partajată sau pe un server web. O hartă a site-ului XML este o listă care poate fi citită de mașină cu adresele URL publice preferate ale unui site web. Google recomandă adrese URL complet calificate, absolute și versiuni canonice ale paginilor. Trimiterea unei hărți a site-ului este un indiciu de descoperire; nu garantează că Google va accesa cu crawlere sau va indexa fiecare adresă URL. Consultați instrucțiunile Google privind hărțile site-ului .

Ce s-a întâmplat cu Dir2HTML?

Versiunea originală a acestui articol recomanda Arclab Dir2HTML, un utilitar Windows pentru crearea unui index HTML cu o singură pagină sau mai multe pagini. Arclab listează acum Dir2HTML ca fiind lansat la sfârșitul perioadei de utilizare: dezvoltarea și distribuția s-au oprit, compania nu mai oferă descărcări și nu vor exista actualizări viitoare. Vechile linkuri de descărcare și afirmațiile de compatibilitate cu Windows 2000, XP și Vista sunt învechite. Pentru utilizarea curentă, evitați să vă bazați pe un program de instalare neîntreținut de pe un site de descărcare necunoscut; metoda PowerShell încorporată de mai jos creează în schimb un index simplu. Întrebările frecvente oficiale despre software-ul vechi de la Arclab au starea actuală.

Crearea unui index HTML dintr-un director Windows

Acest exemplu creează index.htmlfișiere în folderul pe care doriți să îl listați. Include fișiere și subfoldere recursiv, folosește legături relative astfel încât indexul să poată călători odată cu arborele de foldere și omite indexul și scriptul în sine. Salvați scriptul ca .ps1fișier și modificați calea exemplu înainte de a-l rula.

1. Alegeți folderul sursă. În Explorer, identificați directorul de catalogat, cum ar fi D:\ProjectFiles. Pagina generată va fi salvată în folderul respectiv, așa că păstrați-o lângă fișiere și subfoldere dacă mutați sau publicați indexul. Includeți doar conținutul pe care intenționați să îl partajați; pagina listează nume și linkuri și nu modifică permisiunile de acces ale folderului.

2. Salvați scriptul PowerShell. Deschideți Notepad, lipiți codul de mai jos, actualizați calea pe prima linie și salvați fișierul ca Create-DirectoryIndex.ps1. Scriptul folosește PowerShell Get-ChildItempentru a enumera un arbore de directoare; Microsoft documentează că -Recurseopțiunea include elemente în folderele secundare. De asemenea, codifică numele fișierelor pentru utilizarea 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

Codul se bazează pe cmdleturile Get-ChildItem și Resolve-Path încorporate în Microsoft . Elementele ascunse nu sunt incluse decât dacă adăugați -Forceparametrul PowerShell. Dacă contul dvs. nu poate citi un subfolder, remediați permisiunile sau creați indexul dintr-un cont care are permisiunea de a-l vizualiza.

3. Executați scriptul. Deschideți PowerShell, comutați la folderul în care ați salvat scriptul și executați-l. De exemplu, dacă scriptul se află în D:\ProjectFiles, introduceți Set-Location -LiteralPath 'D:\ProjectFiles', atunci .\Create-DirectoryIndex.ps1. Comanda finală îl scrie index.htmlși îl deschide în browserul implicit. Dacă organizația dvs. restricționează executarea scripturilor, urmați politica acesteia în loc să modificați o setare la nivel de sistem doar pentru această sarcină.

4. Examinați pagina și linkurile. Confirmați că există nume și că linkurile către fișiere eșantion deschid fișierele așteptate. Linkurile către foldere funcționează atunci când browserul sau serverul web permite navigarea în directoare; pentru un site găzduit, utilizați foldere cu propriile pagini index sau eliminați intrările din director dacă listarea folderelor este dezactivată. Păstrați codul HTML generat lângă aceeași structură de directoare, altfel linkurile relative pot indica locul greșit.

Această pagină ușoară listează căi, nu dimensiuni de fișiere, date, descrieri sau o temă personalizată. Adăugați aceste detalii numai dacă cititorii au nevoie de ele; un catalog de directoare mai complet poate necesita un instrument întreținut sau un script personalizat.

Creați o hartă a site-ului XML pentru un site web activ

Nu trimiteți indexul PowerShell ca hartă a site-ului SEO. Un crawler are nevoie de adresele URL publice ale site-ului dvs., cum ar fi https://www.example.com/guides/setup/, mai degrabă decât de căi locale, cum D:\ProjectFiles\guide.pdfar fi . Folosiți harta site-ului încorporată a CMS-ului dvs. atunci când este disponibilă. În caz contrar, generați XML din lista canonică de pagini a site-ului și includeți doar adresele URL pe care doriți ca motoarele de căutare să le ia în considerare. Nu inventați lastmoddate; Google spune că poate utiliza acest câmp atunci când valoarea este în mod constant corectă și verificabilă.

O hartă a site-ului XML de bază folosește o <urlset>rădăcină și o <url>intrare cu un caracter complet calificat <loc>pentru fiecare pagină. Escapeți caracterele speciale conform cerințelor XML. Păstrați o singură hartă a site-ului în limitele Google de 50.000 de adrese URL și 50 MB necomprimate; site-urile mai mari pot diviza fișierele și pot utiliza un index de hartă a site-ului. Publicați-o pe site-ul dvs. - de obicei la rădăcină - și trimiteți-o în Search Console sau faceți referire la ea robots.txtcu o linie, cum ar fi Sitemap: https://www.example.com/sitemap.xml. Consultați protocolul Sitemaps pentru formatul fișierului și Google Search Central pentru îndrumări privind crearea și trimiterea.