Cómo convertir un directorio en un índice HTML o crear un mapa del sitio.

Para convertir una carpeta de Windows en un índice HTML navegable, crea una index.htmlpágina con enlaces relativos al contenido de la carpeta. PowerShell puede generarla sin necesidad de instalar un convertidor. Si te refieres a un mapa del sitio para motores de búsqueda, crea un archivo XML independiente con las URL de los sitios web públicos; un directorio del disco local no constituye un mapa del sitio web.

Índice de directorio HTML frente a mapa del sitio web

Un índice de directorio HTML es una página que los usuarios pueden abrir para explorar archivos y carpetas. Puede estar ubicado en un PC, una unidad compartida o un servidor web. Un mapa del sitio XML es una lista legible por máquina de las URL públicas preferidas de un sitio web. Google recomienda URL absolutas completas y versiones canónicas de las páginas. Enviar un mapa del sitio es una sugerencia para que Google lo descubra; no garantiza que rastreará o indexará todas las URL. Consulta la guía de Google sobre mapas del sitio .

¿Qué pasó con Dir2HTML?

La versión original de este artículo recomendaba Arclab Dir2HTML, una utilidad de Windows para crear índices HTML de una o varias páginas. Arclab ahora indica que Dir2HTML ha llegado al final de su ciclo de vida: su desarrollo y distribución se han detenido, la empresa ya no ofrece descargas y no habrá más actualizaciones. Los antiguos enlaces de descarga y las afirmaciones de compatibilidad con Windows 2000, XP y Vista ya no son válidos. Para su uso actual, evite utilizar un instalador sin mantenimiento de un sitio de descarga desconocido; el método integrado de PowerShell que se describe a continuación crea un índice sencillo. Las preguntas frecuentes oficiales de Arclab sobre software heredado contienen la información actualizada.

Cree un índice HTML a partir de un directorio de Windows.

Este ejemplo crea un index.htmlíndice en la carpeta que deseas listar. Incluye archivos y subcarpetas de forma recursiva, utiliza enlaces relativos para que el índice se mueva con la estructura de carpetas y omite el índice y el script en sí. Guarda el script como un .ps1archivo y cambia la ruta de ejemplo antes de ejecutarlo.

1. Seleccione la carpeta de origen. En el Explorador de archivos, identifique el directorio que desea catalogar, por ejemplo D:\ProjectFiles, . La página generada se guardará en esa carpeta, así que manténgala junto a los archivos y subcarpetas si mueve o publica el índice. Incluya solo el contenido que desee compartir; la página muestra nombres y enlaces, y no modifica los permisos de acceso de la carpeta.

2. Guarda el script de PowerShell. Abre el Bloc de notas, pega el código que aparece a continuación, actualiza la ruta en la primera línea y guarda el archivo como Create-DirectoryIndex.ps1. El script utiliza la función de PowerShell Get-ChildItempara enumerar un árbol de directorios; Microsoft documenta que esta -Recurseopción incluye elementos en subcarpetas. También codifica los nombres de archivo para su uso en HTML y 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

El código utiliza los cmdlets integrados de Microsoft Get-ChildItem y Resolve-Path . Los elementos ocultos no se incluyen a menos que se agregue -Forceel parámetro de PowerShell. Si su cuenta no puede leer una subcarpeta, corrija los permisos o cree el índice desde una cuenta que tenga permiso para verla.

3. Ejecuta el script. Abre PowerShell, ve a la carpeta donde lo guardaste y ejecútalo. Por ejemplo, si el script está en D:\ProjectFiles, escribe Set-Location -LiteralPath 'D:\ProjectFiles', y luego .\Create-DirectoryIndex.ps1. El comando final lo escribe index.htmly lo abre en tu navegador predeterminado. Si tu organización restringe la ejecución de scripts, sigue su política en lugar de cambiar una configuración global del sistema solo para esta tarea.

4. Revisa la página y los enlaces. Confirma que los nombres estén presentes y que los enlaces de archivos de ejemplo abran los archivos esperados. Los enlaces de carpetas funcionan cuando el navegador o el servidor web permiten la navegación por directorios; para un sitio alojado, usa carpetas con sus propias páginas de índice o elimina las entradas de directorio si la visualización de carpetas está deshabilitada. Mantén el HTML generado junto a la misma estructura de directorios, de lo contrario, los enlaces relativos podrían apuntar a la ubicación incorrecta.

Esta página sencilla muestra las rutas de acceso, no el tamaño de los archivos, las fechas, las descripciones ni un tema personalizado. Añada esos detalles solo si los lectores los necesitan; un catálogo de directorios más completo podría requerir una herramienta con mantenimiento o un script personalizado.

Crea un mapa del sitio XML para un sitio web en producción.

No envíe el índice de PowerShell como un mapa del sitio SEO. Un rastreador necesita las URL públicas de su sitio, como https://www.example.com/guides/setup/, en lugar de rutas locales como D:\ProjectFiles\guide.pdf. Use el mapa del sitio integrado de su CMS cuando esté disponible. De lo contrario, genere XML a partir de la lista de páginas canónicas del sitio e incluya solo las URL que desea que los motores de búsqueda consideren. No invente lastmodfechas; Google dice que puede usar ese campo cuando el valor sea consistentemente preciso y verificable.

Un mapa del sitio XML básico utiliza una <urlset>raíz y una <url>entrada con una URL completa <loc>para cada página. Escapa los caracteres especiales como lo requiere XML. Mantén un único mapa del sitio dentro de los límites de Google de 50 000 URL y 50 MB sin comprimir; los sitios más grandes pueden dividir los archivos y usar un índice de mapas del sitio. Publícalo en tu sitio (normalmente en la raíz) y envíalo a Search Console o haz referencia a él robots.txtcon una línea como Sitemap: https://www.example.com/sitemap.xml. Consulta el protocolo de mapas del sitio para el formato de archivo y Google Search Central para obtener orientación sobre la creación y el envío.