How do I add an image in the middle of a post?

Place your cursor on a new line where you want the image to appear. Drag an image file from your desktop onto that spot in the editor — a blue insertion indicator shows exactly where it will land. Alternatively, press / to open the slash menu and choose Image or File Upload. A native file picker opens and you can select the image from your computer. Both methods upload the image to Cloudflare R2, generate responsive size variants, and insert a Next.js Image component in the post body. After t...

Where is the Media Library and what can I do there?

The Media Library lives at Admin → Media. It shows a grid of every image (and other media file) you've ever uploaded to this blog, searchable by filename and filterable by file type (image, video, document) and upload date. From the library you can view any file's full URL (the R2 public CDN URL), copy the URL to use elsewhere, add or edit the alt text on an existing image, download the original file, or delete files you no longer need. Deleting a file from the library doesn't automatically r...

Can I insert a previously uploaded image into a new post?

Yes. Use the /image slash command and look for the From library tab in the image picker modal. It shows a grid of your recent uploads and lets you search by filename. Click any thumbnail and the image inserts at the cursor position. The post will reference the existing R2 URL rather than creating a duplicate copy — this keeps your storage usage down and ensures that updating the image in the Media Library (by replacing the file) propagates the change to every post that uses it.

How important is alt text and how do I add it?

Alt text is important for two reasons: accessibility (screen readers read it aloud to visually impaired users) and SEO (search engines index alt text to understand what the image shows). In VeloCMS, you add alt text by clicking on any image in the editor — the image properties panel slides in on the right with an Alt text field. Fill in a concise description of what the image shows (not what the image is called, but what it depicts). If you forget to add alt text before publishing, the SEO pa...

كيف أرفع الصور وأنظّمها في VeloCMS؟

لرفع صورة في VeloCMS، إما اسحبها وأفلتها مباشرةً على محرر المحتوى، أو الصقها من الحافظة، أو استخدم أمر الشرطة /image لفتح منتقي الملفات. تُخزَّن الصور المرفوعة في Cloudflare R2 ويمكن الوصول إليها من أي منشور عبر مكتبة الوسائط — لست بحاجة قط إلى رفع الصورة ذاتها مرتين.

كيف أضيف صورة في منتصف منشور؟

ضع المؤشر على سطر جديد في موضع ظهور الصورة. اسحب ملف الصورة من سطح المكتب وأفلته في ذلك الموضع على المحرر — يظهر مؤشر إدراج أزرق يُحدد بالضبط أين ستُوضع. أو اضغط / لفتح قائمة الأوامر السريعة واختر Image أو File Upload؛ يفتح منتقي الملفات الأصلي وتستطيع اختيار الصورة من جهازك. كلتا الطريقتين ترفعان الصورة إلى Cloudflare R2 وتولّدان أحجامًا متجاوبة مختلفة وتُدرجان مكوّن Next.js Image في جسم المنشور. بعد ظهور الصورة في المحرر، انقر عليها لفتح لوحة خيارات الصورة حيث يمكنك إضافة نص بديل alt text أو تعيين تعليق أو تغيير المحاذاة.

أين توجد مكتبة الوسائط وما الذي يمكنني فعله فيها؟

توجد مكتبة الوسائط في Admin → Media. تعرض شبكة من كل صورة (وملف وسائط آخر) رفعتها على هذه المدونة، قابلة للبحث باسم الملف وللتصفية حسب نوع الملف (صورة أو فيديو أو مستند) وتاريخ الرفع. من المكتبة يمكنك عرض رابط URL الكامل لأي ملف (رابط CDN العام من R2)، أو نسخ الرابط للاستخدام في مكان آخر، أو إضافة النص البديل لصورة موجودة أو تعديله، أو تنزيل الملف الأصلي، أو حذف الملفات التي لم تعد تحتاجها. حذف ملف من المكتبة لا يُزيله تلقائيًا من المنشورات — ستظهر الصورة كرابط مكسور في المنشورات التي استخدمتها، لذا تحقق قبل الحذف.

هل يمكنني إدراج صورة مرفوعة سابقًا في منشور جديد؟

نعم. استخدم أمر الشرطة /image وابحث عن تبويب From library في نافذة منتقي الصور. تعرض شبكة من آخر الملفات المرفوعة وتتيح البحث باسم الملف. انقر على أي صورة مصغّرة وستُدرَج في موضع المؤشر. سيستخدم المنشور رابط R2 الموجود بدلًا من إنشاء نسخة مكررة — مما يُبقي استخدام التخزين منخفضًا ويضمن أن تحديث الصورة في مكتبة الوسائط (باستبدال الملف) ينعكس على كل منشور يستخدمها.

ما أهمية النص البديل وكيف أضيفه؟

للنص البديل أهمية لسببين: إمكانية الوصول (تقرأه برامج قراءة الشاشة بصوت عالٍ للمستخدمين ضعاف البصر) وتحسين SEO (تُفهرسه محركات البحث لفهم محتوى الصورة). في VeloCMS، تُضيف النص البديل بالنقر على أي صورة في المحرر — يظهر لوح خصائص الصورة على اليمين ويتضمن حقل Alt text. اكتب وصفًا موجزًا لما تُظهره الصورة (ليس اسم الملف بل ما تصوّره). إن نسيت إضافة النص البديل قبل النشر، سيُشير لوح SEO إلى الصورة كتحذير بشأن نص بديل مفقود. يمكن لمساعد الذكاء الاصطناعي أيضًا اقتراح نص بديل — انقر أيقونة التألق بجانب حقل النص البديل وسيولّد وصفًا من محتوى الصورة.

يولّد VeloCMS تلقائيًا نسخ WebP من الصور JPEG وPNG المرفوعة ويُقدّم الصيغة المثلى لمتصفح كل زائر. المتصفحات الحديثة تحصل على WebP (أصغر عادةً بنسبة 25-35% من JPEG عند جودة مكافئة)؛ أما المتصفحات القديمة فتحصل على الصيغة الأصلية. يحدث هذا بصورة شفافة عبر خط أنابيب تحويل الصور في Cloudflare دون أي إجراء من جانبك.