wp2hugo

ووردبريس إلى موقع Hugo Static المهاجر

هذا هو أفضل برنامج ترحيل لترحيل تصدير WordPress إلى Hugo. إنه يتعامل مع العديد من الحالات الغريبة التي واجهتها أثناء محاولتي ترحيل موقع الويب الشخصي الخاص بي إلى موقع يستند إلى Hugo.

على الرغم من أن هذا يستهدف في المقام الأول إنشاء الأكواد المستندة إلى Hugo، إلا أنه يمكن استخدامه لتحويل مدونات WordPress إلى ملفات تعتمد على Markdown والتي يمكن استخدامها مع أنظمة أخرى على سبيل المثال Mkdocs أو Jekyll.

الاستخدام التجاري

أريد أن يكون هذا المشروع متاحًا على نطاق واسع قدر الإمكان، مع الاستمرار في تمويل تكاليف التطوير. هذا المشروع مجاني تمامًا للاستخدام غير التجاري والشخصي. الاستخدام التجاري مقيد عن طريق الترخيص. لا تتردد في الاتصال بي إذا كنت ترغب في ترخيص هذا تجاريًا.

الاستخدام

ثنائي

• قم بتنزيل أداة wp2hugo من الإصدارات
• قم بتصدير موقع WordPress الخاص بك عبر Tools -> Export في لوحة تحكم المشرف الخاصة بك
• لنفترض أن الملف الذي تم تنزيله هو wordpress-export.xml قم بإنشاء موقع الويب باستخدام $ wp2hugo --source wordpress-export.xml --download-media

$ wp2hugo
Usage of wp2hugo:
 -authors string
   CSV list of author name(s), if provided, only posts by these authors will be processed
  -color-log-output
   enable colored log output, set false to structured JSON log (default true)
  -continue-on-media-download-error
   continue processing even if one or more media downloads fail
  -download-media
   download media files embedded in the WordPress content
  -font string
   custom font for the output website (default " Lexend " )
  -media-cache-dir string
   dir path to cache the downloaded media files (default " /tmp/wp2hugo-cache " )
  -output string
   dir path to write the Hugo-generated data to (default " /tmp " )
  -source string
   file path to the source WordPress XML file

البناء من المصدر

$ git clone [email protected]:ashishb/wp2hugo.git
$ cd wp2hugo/src/wp2hugo
$ make build_prod
# `./bin/wp2hugo` will contain the binary and you can use it as `$ ./bin/wp2hugo --source wordpress-export.xml --download-media`

التثبيت عبر مديري الحزم

أهداف wp2hugo

ترحيل أنواع المنشورات والتصنيفات وصفحات الأرشيف الخاصة بها

1. ترحيل المشاركات
2. ترحيل الصفحات
3. ترحيل العلامات
4. ترحيل الفئات
5. ترحيل أنواع منشورات Avada المخصصة (الأسئلة الشائعة والمحافظ)
6. قم بضبط صفحة WordPress الرئيسية بشكل صحيح
7. إنشاء صفحة مؤلف ووردبريس

ترحيل الروابط الدائمة

1. قم بترحيل جميع عناوين URL بما في ذلك عناوين URL للوسائط بشكل صحيح
2. أنشئ تكوين Nginx الذي يحتوي على GUID -> تعيين عنوان URL النسبي
3. قم بترحيل موجز RSS باستخدام UUIDs الموجودة، بحيث تظهر الإدخالات كما هي - وهذا أمر مهم لأي شخص لديه خلاصة مهمة، راجع المزيد من التفاصيل حول الترحيل الفاشل
4. قم بتعيين ملف RSS feed.xml الخاص بـ WordPress إلى ملف RSS feed.xml الخاص بـ Hugo

ترحيل محتوى المنشور والرموز القصيرة

1. ترحيل مقتطف الصفحة
2. قم بترحيل "إظهار المزيد..." من WordPress -> Summary في Hugo
3. ترحيل منشورات فئة القائمة (catlist)
4. ترحيل جدول محتوى WordPress -> Hugo
5. ترحيل كتل التعليمات البرمجية بشكل صحيح - ترحيل معلومات فئة التعليمات البرمجية الموجودة إذا كانت متوفرة
6. ترحيل التضمينات:
   1. قم بترحيل إطار (إطارات) iframe مثل تضمينات YouTube
   2. ترحيل تضمينات YouTube
   3. قم بترحيل النص العادي الذي يتم تضمينه على موقع YouTube على نمط WordPress في نص النشر
   4. ترحيل تضمينات WP YouTube Lyte على YouTube
   5. قم بترحيل تضمين خريطة Google عبر googlemaps برمز قصير مخصص
   6. ترحيل GitHub Gists
7. ترحيل الرموز القصيرة لـ WordPress:
   1. قم بترحيل الرمز القصير لـ WordPress [caption] إلى {{< Figure >}}) الخاص بـ Hugo
   2. ترحيل الرمز القصير لـ WordPress [الصوت])
8. ترحيل كتل وميزات Gutenberg:
   1. ترحيل الحواشي السفلية لـ WordPress
   2. ترحيل معرض WordPress بما في ذلك المعرض الفارغ

ترحيل البيانات الوصفية والسمات

1. الحفاظ على حالة المسودة للمسودات والمشاركات المعلقة
2. استخدم تاريخ المسودة كتاريخ احتياطي لمسودات المشاركات
3. الصور المميزة - تصدير اقترانات الصور المميزة مع الصفحات والمنشورات بشكل صحيح
4. تنسيقات منشورات ووردبريس

ترحيل مرفقات الوسائط

1. ترحيل favicon.ico
2. قم بترحيل صور wp-content/uploads المضمنة في الصفحات إلى ملفات Hugo الثابتة مع الحفاظ على عناوين URL النسبية
3. ترحيل الصور الخارجية (على مضيفين مختلفين) إلى ملفات Hugo الثابتة

متنوعات

1. القدرة على تصفية المشاركات حسب المؤلف (المؤلفين)، وهي مفيدة لعمليات الترحيل متعددة المواقع في WordPress
2. الخط المخصص - الافتراضي هو Lexend
3. دعم خلفيات طمس المنظر (على غرار خلفيات WordPress المتقدمة)

لماذا لا تعمل الأدوات الموجودة

تقوم الأدوات الحالية بعمل غير مكتمل في ترحيل المحتوى. نادرًا ما يقومون بترحيل البيانات الوصفية مثل GUID، وعمليات تضمين YouTube، وعمليات تضمين خرائط Google، وعمليات تضمين التعليمات البرمجية بشكل صحيح.

مدير هوغو

يحتوي هذا المستودع على الأداة التجريبية hugomanager . أستخدم هذه الأداة للتوليد التلقائي لعناوين URL من العنوان وكذلك لمعرفة منشورات المدونة التي لا تزال تحمل علامة مسودة أو تلك التي من المقرر نشرها قريبًا.

يمكنك بناء ذلك عبر

src/wp2hugo $ make build_hugo_manager
...

src/wp2hugo $ ./bin/hugomanager
A tool for managing Hugo sites e.g. adding URL suggestions, generating site status summary etc.

Usage:
  hugomanager [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  sitesummary Print site stats (e.g. number of posts, number of drafts etc.)
  urlsuggest  Suggests URLs for all the pending/future posts that are missing a URL
  version     Print the version number of HugoManager

Flags:
  -a, --author string    author name for copyright attribution (default " YOUR NAME " )
      --config string    config file (default is $HOME /.cobra.yaml)
  -h, --help             help for hugomanager
  -l, --license string   name of license for the project
      --viper            use Viper for configuration (default true)

Use " hugomanager [command] --help " for more information about a command.

ملحوظة:

1. لترحيل التعليقات، استخدم Remark42