الترحيل·7 min read·

ترحيل ملف ZIP من Medium إلى VeloCMS — الدليل الكامل

يمنحك تصدير Medium ملفات HTML لكل مقالة كتبتها. يحوّل CLI الترحيل في VeloCMS هذه الملفات إلى تنسيق AST الكتل ويعيد رفع صورك إلى R2 في خطوة واحدة.

يتضمّن تصدير Medium ملف ZIP يحتوي على ملف HTML واحد لكل مقالة نشرتها. على خلاف Substack (الذي يوفّر ملف CSV منظّماً للمشتركين)، لا يتيح Medium تصدير المشتركين — ترحيلك إذن يقتصر على المحتوى فحسب. تشمل ملفات HTML جميع مقالاتك ومسوّداتك وردودك، مع صور مضمّنة ترتبط بشبكة توصيل المحتوى الخاصة بـ Medium.

الخطوة 1 — تنزيل تصدير Medium

انتقل إلى medium.com وانقر على صورتك الرمزية، ثم Settings ثم Security and apps ثم Download your information. يُرسل إليك Medium رابط التنزيل خلال 24 ساعة (وعادةً ما يكون أسرع من ذلك). يحتوي ملف ZIP على مجلد posts/ بملف HTML لكل مقالة. فكّ ضغط ملف ZIP محلياً.

الخطوة 2 — تحويل HTML من Medium إلى تنسيق VeloCMS

velocms-migrate medium-to-json \
  --input ./medium-export/posts/ \
  --output posts.json \
  --download-images

يأمر الخيار --download-images المحوّلَ بجلب كل صورة من شبكة توصيل المحتوى الخاصة بـ Medium ورفعها إلى حاوية VeloCMS R2. بدون هذا الخيار، ستبقى الصور مرتبطة بشبكة Medium — ستعمل في البداية لكنها ستتعطّل إذا أزال Medium هذه الصور لاحقاً. تستغرق عملية التحويل نحو 5 ثوانٍ لكل مقالة.

يتضمّن تصدير Medium المسوّدات والردود (التعليقات على منشورات الآخرين). يُعلّم المحوّل المسوّدات بحالة «مسودة» ويتخطّى الردود افتراضياً. مرّر الخيار --include-responses لاستيراد الردود بوصفها منشورات إذا أردت ذلك.

ما يتعامل معه المحوّل تلقائياً

يستخدم Medium بنية HTML مخصصة تعتمد أسماء فئات وسمات بيانات محددة. يتعامل المحوّل مع: نص العنوان الثانوي (التسمية الصغيرة فوق العنوان الرئيسي)، والعنوان الفرعي (يُعيَّن على حقل الملخص)، والاقتباسات البارزة (تُحوَّل إلى كتل callout)، والصفحات في Gist (تُحوَّل إلى كتل code مع جلب المحتوى من GitHub API)، والصور الأصلية في Medium مع توضيحاتها (تُحوَّل إلى كتل صور مع الحفاظ على نص التوضيح).

الخطوة 3 — الاستيراد وإعداد الروابط الأصلية

استورد ملف posts.json عبر Admin ثم Tools ثم Import. بعد الاستيراد، فكّر في تعيين روابط أصلية على منشوراتك في VeloCMS تُشير إلى عناوين URL الأصلية في Medium. هذا يُخبر Google أن مدوّنتك الجديدة هي المصدر الأساسي وأن Medium مجرد موقع للنشر المتزامن، مما يُحوّل سلطة التصنيف إلى نطاقك مع مرور الوقت. في محرر منشورات VeloCMS، يحتوي لوح SEO على حقل Canonical URL — عيّنه على عنوان URL الأصلي بصيغة medium.com/post-slug خلال فترة الانتقال، ثم احذفه عند اكتساب نطاقك الجديد سلطة كافية.