كيفية تحويل دليل إلى فهرس HTML أو إنشاء خريطة موقع

لتحويل مجلد في نظام ويندوز إلى فهرس HTML قابل للتصفح، أنشئ index.htmlصفحة تحتوي على روابط نسبية لمحتويات المجلد. يمكن لـ PowerShell إنشاء واحدة دون الحاجة إلى تثبيت مُحوِّل. أما إذا كنت تقصد خريطة موقع لمحركات البحث، فأنشئ ملف XML منفصلًا يحتوي على عناوين URL لمواقع الويب العامة؛ فدليل القرص المحلي ليس خريطة موقع ويب.

فهرس دليل HTML مقابل خريطة موقع الويب

فهرس دليل HTML هو صفحة يمكن للمستخدمين فتحها لتصفح الملفات والمجلدات. يمكن أن يكون موجودًا على جهاز كمبيوتر، أو محرك أقراص مشترك، أو خادم ويب. أما خريطة موقع XML فهي قائمة قابلة للقراءة آليًا بعناوين URL العامة المفضلة لموقع الويب. توصي جوجل باستخدام عناوين URL كاملة ومطلقة، بالإضافة إلى النسخ الأساسية للصفحات. يُعد إرسال خريطة الموقع بمثابة تلميح لاكتشاف الموقع، ولكنه لا يضمن أن تقوم جوجل بفهرسة جميع عناوين URL. راجع إرشادات جوجل الخاصة بخريطة الموقع .

ماذا حدث لـ Dir2HTML؟

أوصت النسخة الأصلية من هذه المقالة ببرنامج Arclab Dir2HTML، وهو أداة مساعدة لنظام ويندوز لإنشاء فهرس HTML من صفحة واحدة أو عدة صفحات. أعلنت شركة Arclab الآن أن برنامج Dir2HTML قد انتهى دعمه: فقد توقف تطويره وتوزيعه، ولم تعد الشركة توفر روابط تنزيل له، ولن تُصدر له أي تحديثات مستقبلية. روابط التنزيل القديمة ومعلومات التوافق مع أنظمة ويندوز 2000 وXP وVista أصبحت غير صالحة. للاستخدام الحالي، تجنب الاعتماد على مُثبِّت غير مُحدَّث من موقع تنزيل غير معروف؛ بدلاً من ذلك، استخدم طريقة PowerShell المدمجة الموضحة أدناه لإنشاء فهرس بسيط. يمكنك الاطلاع على آخر المستجدات في قسم الأسئلة الشائعة لبرامج Arclab القديمة .

إنشاء فهرس HTML من دليل ويندوز

يُنشئ هذا المثال ملفًا index.htmlفي المجلد الذي ترغب في عرض محتوياته. يتضمن الملفات والمجلدات الفرعية بشكل متكرر، ويستخدم روابط نسبية ليتمكن الفهرس من التنقل مع شجرة المجلدات، ويتجاوز الفهرس والبرنامج النصي نفسهما. احفظ البرنامج النصي كملف، .ps1وغيّر مسار المثال قبل تشغيله.

1. اختر مجلد المصدر. في مستكشف الملفات، حدد المجلد المراد فهرسته، مثلاً D:\ProjectFiles. سيتم حفظ الصفحة المُنشأة في هذا المجلد، لذا احتفظ بها بجانب الملفات والمجلدات الفرعية إذا قمت بنقل الفهرس أو نشره. أضف فقط المحتوى الذي تنوي مشاركته؛ فالصفحة تعرض الأسماء والروابط فقط، ولا تُغير أذونات الوصول إلى المجلد.

2. احفظ سكربت PowerShell. افتح المفكرة، والصق الكود أدناه، وعدّل المسار في السطر الأول، ثم احفظ الملف باسم Create-DirectoryIndex.ps1. يستخدم السكربت PowerShell Get-ChildItemلحصر عناصر شجرة الدليل؛ وتشير وثائق مايكروسوفت إلى أن هذا -Recurseالخيار يشمل العناصر الموجودة في المجلدات الفرعية. كما يقوم بتشفير أسماء الملفات لاستخدامها في HTML وعناوين 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

يعتمد هذا الكود على أوامر PowerShell المدمجة Get-ChildItem و Resolve-Path . لا يتم تضمين العناصر المخفية إلا بإضافة -Forceمُعامل PowerShell. إذا كان حسابك لا يستطيع قراءة مجلد فرعي، فقم بتصحيح الأذونات أو أنشئ الفهرس من حساب لديه صلاحية عرضه.

3. شغّل البرنامج النصي. افتح PowerShell، وانتقل إلى المجلد الذي حفظت فيه البرنامج النصي، ثم شغّله. على سبيل المثال، إذا كان البرنامج النصي موجودًا في D:\ProjectFiles، فأدخل Set-Location -LiteralPath 'D:\ProjectFiles'، ثم .\Create-DirectoryIndex.ps1. يقوم الأمر الأخير بكتابة البرنامج index.htmlالنصي وفتحه في متصفحك الافتراضي. إذا كانت مؤسستك تقيّد تنفيذ البرامج النصية، فاتبع سياستها بدلاً من تغيير إعدادات النظام العامة لهذه المهمة فقط.

4. راجع الصفحة والروابط. تأكد من وجود الأسماء وأن روابط الملفات النموذجية تفتح الملفات المطلوبة. تعمل روابط المجلدات عندما يسمح المتصفح أو خادم الويب بالتنقل بين المجلدات؛ بالنسبة للمواقع المستضافة، استخدم مجلدات ذات صفحات فهرس خاصة بها، أو احذف إدخالات المجلدات إذا كانت خاصية عرض المجلدات معطلة. احتفظ بملف HTML المُنشأ بجانب بنية المجلدات نفسها، وإلا فقد تشير الروابط النسبية إلى مكان خاطئ.

تعرض هذه الصفحة البسيطة مسارات الملفات فقط، دون ذكر أحجامها أو تواريخها أو أوصافها أو تصميمها المخصص. أضف هذه التفاصيل فقط إذا احتاج إليها المستخدمون؛ فقد يتطلب فهرس الدليل الكامل أداةً مُدارة أو برنامجًا نصيًا مُخصصًا.

أنشئ خريطة موقع XML لموقع ويب مباشر

لا تُرسل فهرس PowerShell كخريطة موقع مُحسّنة لمحركات البحث. يحتاج برنامج الزحف إلى عناوين URL العامة لموقعك، مثل `<عنوان URL>` https://www.example.com/guides/setup/، بدلاً من المسارات المحلية مثل `<مسار D:\ProjectFiles\guide.pdfالموقع>`. استخدم خريطة الموقع المُدمجة في نظام إدارة المحتوى الخاص بك إن وُجدت. وإلا، فأنشئ ملف XML من قائمة الصفحات الأساسية للموقع، واحرص على تضمين عناوين URL التي تريد أن تأخذها محركات البحث في الاعتبار فقط. لا تُضلل lastmodمحركات البحث؛ إذ تُشير جوجل إلى أنها قد تستخدم هذا الحقل عندما تكون القيمة دقيقة وقابلة للتحقق باستمرار.

تستخدم خريطة الموقع الأساسية بتنسيق XML مسارًا <urlset>رئيسيًا ومدخلًا <url>يحتوي على عنوان URL كامل <loc>لكل صفحة. يجب مراعاة استخدام الأحرف الخاصة وفقًا لمتطلبات XML. يُنصح بالالتزام بحدود جوجل التي تبلغ 50,000 عنوان URL و50 ميجابايت غير مضغوطة لخريطة الموقع الواحدة؛ يمكن للمواقع الأكبر حجمًا تقسيم الملفات واستخدام فهرس خريطة الموقع. انشر خريطة الموقع على موقعك - ​​عادةً في المسار الرئيسي - وأرسلها إلى Search Console أو أشر إليها robots.txtباستخدام سطر مثل <sitemap> Sitemap: https://www.example.com/sitemap.xml. راجع بروتوكول خرائط المواقع لمعرفة تنسيق الملف، ومركز بحث جوجل للحصول على إرشادات الإنشاء والإرسال.