مقدمة

يدعم قالب PaperMod ميزة Twitter Card. ومع ذلك، يجب كتابة إعدادات Twitter Card في config.toml أو في معلومات رأس *.md لكل مقال. إذا تم تعيينها في كل من المقال و config.toml، فستكون الأولوية لمعلومات رأس كل مقال.

طريقة الإعداد

config.toml

في config.toml، أضف عنصرًا يسمى images ضمن [params]. في images، اكتب مسار الصورة التي سيتم عرضها في Twitter Card. إذا كنت ستضع الصورة في مجلد static، فيكفي تحديد اسم الملف فقط.

1
2

[params]
  images = ["twitter_card.jpg"]

هيكل المجلد

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

root
│  config.toml (اكتب هنا)
├─content
│  └─posts
│      └─مجلد المقال
│         │  index.md (اكتب هنا)
│         └─images
│             cover.png (ضع هنا)
└─static
    twitter_card.jpg (ضع هنا)

معلومات رأس كل مقال

في معلومات رأس كل مقال، أضف عنصرًا يسمى image تحت cover. إذا قمت بتعيين relative إلى true، يمكنك تحديده بمسار نسبي من *.md للمقال.

1
2
3

cover:
  image: "images/cover.jpg"
  relative: true

إذا كنت لا ترغب في عرضها أعلى المقال

إذا كنت لا ترغب في عرض صورة الغلاف أعلى المقال، أضف عنصرًا يسمى hidden تحت cover وقم بتعيينه إلى true.

1
2
3
4

cover:
  image: "images/cover.jpg"
  relative: true
  hidden: true

حول حجم الصورة

حاليًا، يبدو أن حجم Twitter Card في مواصفات PaperMod يدعم فقط summary_large_image. الحجم المناسب (الدقة) لـ summary_large_image مختلف عليه، ولكن يبدو أن 800 x 418 (نسبة الصورة 1.91:1) جيدة.

الموقع المرجعي 1 الموقع المرجعي 2

إذا أمكن، نوصي بتغيير حجم الصورة قبل النشر.

كيفية التحقق من الإعدادات

للتحقق من إعدادات Twitter Card، استخدم Twitter Card Validator. ومع ذلك، في بيئتي لم يتم عرض المعاينة بشكل صحيح، لذلك إذا لم يتم عرض المعاينة، نوصي بالتحقق منها مرة واحدة قبل النشر باستخدام حساب خاص أو ما شابه.