Fjord

توثيق Fjord

الوحدات

04

التضمينات

أنشئ رسائل منظمة بالمحرر المرئي من دون كتابة JSON.

الوظائف المتاحة

  • عناوين وأوصاف وحقول ووسائط
  • معاينة مباشرة أثناء التحرير
  • الحفظ ثم التعديل مجدداً

ماذا يمكنك إنشاءه بالتضمينات؟

أنشئ رسائل Discord في المحرر المرئي وراجعها في المعاينة المباشرة. اجمع النصوص والحقول والصور والألوان، واحفظ المسودات أو انشر الرسائل في قناة وحدّثها لاحقًا.

فهم التركيبات

يدعم التنسيقان المعاينة والألوان والصور وتعدد التضمينات وفتحها ونسخها وحذفها وترتيبها. يستخدم V1 حقول Discord الثابتة وV2 كتلًا حرة. توضح الأقسام التالية المدخلات والفروق.

يتم استخدام اسم التركيبة فقط للإدارة في لوحة المعلومات ولا يتم إرساله إلى Discord. يمكن تخزين ما يصل إلى 50 تركيبة بأسماء لا تزيد عن 50 حرفًا لكل خادم.

الحالةالسلوك
مسودةبدون قناة مستهدفة، سيتم حفظ المقطوعة ولكن لن يتم نشرها على Discord.
النشر المُدارباستخدام القناة المستهدفة، يؤدي الحفظ إلى إنشاء رسالة Discord مرتبطة بشكل دائم بالتركيبة. سيتم إجراء المزيد من التغييرات على تحديث هذه الرسالة بالضبط.
إرسال مرة واحدةيرسل الرسالة الحالية دون حفظ التركيبة أو إنشاء رابط لاحق. هذا الخيار موجود فقط قبل الحفظ الأول.

المكونات V1 / V2

تبدأ التركيبات الجديدة بـV2.

اختر V1 أو V2 قبل الحفظ الأول. بعد الحفظ تصبح النسخة ثابتة حتى للمسودة وبعد إزالة المنشور. أنشئ تركيبًا جديدًا لاستخدام تنسيق آخر. النسخ يحافظ على النسخة. لا تُحوّل رسائل V1 المحفوظة ولا تُحذف تلقائيًا.

V1

يستخدم V1 تضمينات Discord التقليدية بلون تمييز ومناطق ثابتة، بحد أقصى عشرة تضمينات. أرقام الجدول هي حدود الأحرف. المؤلف والعنوان والوصف والتذييل وجميع أسماء الحقول وقيمها معًا لا تتجاوز 6000 حرف عبر جميع التضمينات. للنص العادي حد منفصل. لكل تضمين V1 حد أقصى 25 حقلًا.

الإدخالحد الأحرفالحالة
المؤلف256اختياري
رابط المؤلف512اختياري
العنوان256اختياري
رابط العنوان (اختياري)512اختياري
الوصف4096اختياري
نص التذييل2048اختياري
اسم الحقل256مطلوب بعد الإضافة
قيمة الحقل1024مطلوب بعد الإضافة

كل مناطق التصميم اختيارية. عند إضافة حقل يصبح اسمه وقيمته مطلوبين. احذف الحقول غير المستخدمة. العرض جنبًا إلى جنب يفعّل الحقول المتجاورة، ويتحدد ترتيبها النهائي حسب Discord وعرض الشاشة. رابط المؤلف أو أيقونته يتطلب اسم المؤلف، ورابط العنوان يتطلب عنوانًا، وأيقونة التذييل تتطلب نص تذييل. الروابط الاختيارية عناوين HTTP(S) كاملة. الطابع الزمني يعرض وقت الإرسال.

اختيار الرتب والقنوات متاح في النص العادي ووصف V1 وقيم الحقول. لا تتوفر أدوات الإشارة هذه في المؤلف والعنوان والتذييل وأسماء الحقول، لكن رموز الخادم متاحة في هذه النصوص. رابط المؤلف ورابط العنوان يقبلان URL فقط، دون رتب أو قنوات أو رموز تعبيرية. الإشارات داخل التضمينات التقليدية لا ترسل تنبيهًا.

يجمع V2 حتى خمسة أزرار روابط في صف إجراءات واحد. يُطبق الحد الكلي للمكونات بدل حد خمسة صفوف في V1.

أزرار الروابط تفتح مواقع ولا تمنح رتبًا. كل زر مضاف يحتاج تسمية حتى 80 حرفًا ورابط HTTP(S) كامل حتى 512 حرفًا. الرمز التعبيري اختياري. يمكن ترتيب الأزرار وحذفها. يعرض V1 الأزرار أسفل التضمينات، خمسة في الصف وخمسة صفوف إجمالًا، أي 25 زرًا. يعرضها V2 داخل حاويتها ويحسب الأزرار والصفوف ضمن حد 40.

إنشاء تركيبة

الاسم الداخلي مطلوب حتى لحفظ المسودة فقط. يسمح المحرر بـ50 حرفًا كحد أقصى. يحصل التركيب الجديد على اسم مقترح قابل للتعديل، يظهر في لوحة التحكم فقط. النشر يتطلب قناة متاحة ونصًا مرئيًا أو تضمينًا أو زر رابط كاملًا. لا يحتاج الوصف أو الصورة إلى عنوان. لا تحتاج المسودة الفارغة إلى محتوى بعد.

حقوق Discord المطلوبة

عرض القناة إرسال الرسائل تضمين الروابط إرفاق الملفات الإشارة إلى @everyone و@here وجميع الرتب

في V1 قد ترسل إشارات النص العادي تنبيهات، لكن التضمينات التقليدية لا تفعل. في V2 قد تطلق كتل النص إشارات أيضًا. يحتاج Fjord إلى إذن Discord المناسب لـ@everyone و@here والرتب غير المتاحة للإشارة العامة. راجع الإشارات قبل النشر.

عرض القناة وإرسال الرسائل مطلوبان لكل نشر. تضمين الروابط مطلوب للتضمينات التقليدية وصورها. إرفاق الملفات مطلوب للإرسال لمرة واحدة لصور محلية. حفظ المسودة لا ينشر رسالة Discord بعد.

  1. افتح التضمينات في لوحة التحكم.
  2. حدد تركيبة جديدة وقم بتعيين اسم داخلي.
  3. أضف محتوى الرسالة العادي إذا لزم الأمر.
  4. صمم التضمين الأول وأضف عمليات التضمين الإضافية إذا لزم الأمر.
  5. تحقق من النتيجة في معاينة Discord.
  6. اختر قناة مستهدفة للنشر أو اترك القناة فارغة لحفظ مسودة فقط.
اسم المقطوعةإلزامي

يُستخدم حصريًا للإدارة في لوحة المعلومات وقد يحتوي على 50 حرفًا كحد أقصى.

محتوى الرسالةاختياري

نص الرسالة العادي اختياري ومحدود بـ 2,000 حرف. يمكن نشر نص فقط. يجب أن تكون الرسالة ذات محتوى ظاهر. تحقّق أيضًا من حدود التنسيق والمكوّنات.

التضميناختياري

التضمينات اختيارية ويمكن تصميم عشرة كحد أقصى. يحدّ إجمالي المكوّنات في V2 أيضًا من عددها ومحتواها.

القناة المستهدفةاختيارية

بدون قناة مستهدفة، يتم حفظ المسودة. تعتبر القناة المستهدفة التي يمكن الوصول إليها إلزامية للنشر.

محتوى الرسالة

يظهر محتوى الرسالة العادي أعلى التضمينات ويمكن أن يحتوي على ما يصل إلى 2000 حرف. يمكن استخدام الأدوار والقنوات والرموز التعبيرية للخادم من خلال التحديد في المحرر.

في V1 قد ترسل إشارات النص العادي تنبيهات، لكن التضمينات التقليدية لا تفعل. في V2 قد تطلق كتل النص إشارات أيضًا. يحتاج Fjord إلى إذن Discord المناسب لـ@everyone و@here والرتب غير المتاحة للإشارة العامة. راجع الإشارات قبل النشر.

تضمينات التصميم

يعرض Discord أيقونة المؤلف فقط إذا تم إدخال اسم مؤلف أيضًا. أدخل اسمًا أعلاه حتى تظهر الأيقونة في المعاينة. يعرض Discord أيقونة التذييل فقط إذا تم إدخال نص تذييل أيضًا. أدخل نصًا أعلاه حتى تظهر الأيقونة في المعاينة.

V2

يمكن أن تحتوي كتلة الصورة على معرض من عشر صور كحد أقصى. استخدم «+ صورة أخرى» لإضافة صور يمكن حذفها بشكل منفرد. لكل صورة وصورة مصغرة وصف اختياري حتى 80 حرفًا وخيار إخفاء المحتوى. يدعم القسم ثلاثة نصوص حتى 4000 حرف لكل نص. استخدم «+ نص آخر» لإضافة نصين إضافيين كحد أقصى. في الملحق اختر صورة مصغرة أو زر رابط. يتطلب الزر تسمية حتى 80 حرفًا وعنوان HTTP(S) كاملًا حتى 512 حرفًا. الرمز التعبيري وتعطيل الزر اختياريان. تحسب النصوص الإضافية وزر الملحق ضمن حد المكونات. لا تحسب الصور المنفردة في المعرض كمكونات إضافية.

في V2 يمكن إخفاء الحاويات والصور، بما فيها الصور المصغرة، باستخدام خيار المحتوى المخفي. يبقى المحتوى مخفيًا حتى النقر عليه.

يوفر V2 عشر حاويات كحد أقصى بألوان مستقلة. استخدم كتل النص أو الأقسام بصورة مصغرة اختيارية على اليمين، كل منها حتى 4000 حرف مع Markdown. الفاصل يعرض خطًا أو مسافة فقط، صغيرة أو كبيرة. أضف الكتل وانسخها واحذفها ورتبها بالأسهم. كتل النص والصور الفارغة لا تنتج محتوى مرئيًا. توفر نصوص V2 اختيار الرتب والقنوات ورموز الخادم.

لا يحتوي V2 على حقول المؤلف التقليدية أو إدخال رابط العنوان أو الحقول المتجاورة أو أيقونات التذييل أو مفتاح الطابع الزمني. استخدم Markdown للعناوين والروابط في النص. المثال أدناه ينشئ تذييلًا صغيرًا ورمز الوقت ينشئ طابعًا زمنيًا. لا يوفر V1 كتل V2 حرة الترتيب. لا يمكن خلط التنسيقين في رسالة واحدة.

-# ... · {time.full}

حاوية

ألوان سريعة · 10

كتلة نص

Markdown · 4000

قسم مع صورة مصغرة

Markdown · 4000 · Thumbnail ≤ 5 MB

صورة

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

فاصل

إظهار الخط الفاصل · صغير / كبير

حد V2 المشترك هو 40 مكونًا للرسالة كاملة. تُحسب الحاويات والنصوص والأقسام والصور المصغرة والمعارض والفواصل وصفوف الإجراءات والأزرار والقوائم. خيارات القائمة لا تُحسب منفردة. تُحسب أيضًا الفواصل والأدوات المضافة تلقائيًا.مثلًا حاوية تضم نصًا وصورة وفاصلًا وزرًا مع صفه تستخدم ستة مكونات. لذلك لا يمكن ملء الحاويات العشر بلا حدود.

استخدام الصور

حدود الصور لكل ملف. في V1 تقبل أيقونة المؤلف والصورة المصغرة وأيقونة التذييل 5 MB لكل منها. حد الصورة الكبيرة مطابق لحد كتل V2 الموضح أدناه. تُقبل PNG وJPG/JPEG وWebP وGIF. اختيار ملف يستبدل الصورة وإزالة يفرغ مكانها. لا تظهر أيقونات المؤلف والتذييل دون النص المقابل.

اختر PNG أو JPG/JPEG أو WebP أو GIF. تُرفع الصور عند الحفظ. الحد للصور المصغرة 5 MB وللصور الكبيرة 10 MB. يسمح الإرسال لمرة واحدة في وحدة التضمينات بعشر صور محلية بإجمالي 20 MB.

Thumbnail5 MB
صورة10 MB

الحفظ والنشر

إذا كانت الرسالة المُدارة مفقودة في Discord، يعيد الحفظ نشرها. يحافظ التركيب المنسوخ على التنسيق لكنه يبدأ دون قناة نشر ويكون مستقلًا عن الأصل.

حفظ كمسودة

اترك تحديد القناة فارغًا ثم احفظه. تظل المسودة متاحة في لوحة التحكم دون إنشاء رسالة Discord.

النشر بشكل دائم

حدد قناة واحفظها. تظل رسالة Discord التي تم إنشاؤها مرتبطة بالأغنية. سيتم تحديث التغييرات اللاحقة في نفس الرسالة عند حفظها.

تأجيل النشر

إذا اخترت قناة مختلفة لتركيبة تم نشرها بالفعل، ففي المرة التالية التي تقوم فيها بحفظها، سيتم إنشاء الرسالة الجديدة أولاً ثم ستتم إزالة الرسالة القديمة.

إزالة المنشور

إزالة المشاركة تؤدي فقط إلى حذف رسالة Discord المُدارة. يبقى التكوين كمسودة محفوظة.

حذف التركيبة

حذف التركيب يزيل السجل المحفوظ وصوره المخزنة. لا يحذف رسالة Discord المرسلة، لكنها قد تفقد مراجع الصور. لحذف الرسالة المُدارة أيضًا أزل منشورها صراحة أولًا. الرسائل المرسلة لمرة واحدة لا تُدار لاحقًا.

الإدارة والتكرار

يمكن فتح التركيبات المحفوظة وإعادة تسميتها وتكرارها وحذفها. يمكن إنشاء ما يصل إلى عشرة عمليات تضمين وإعادة ترتيبها وتكرارها داخل التركيبة. يتم منع التكرار إذا كان ذلك سيتجاوز عدد Discord أو حدود النص.

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

إصلاح الأخطاء

الملاحظةالاختبار
لا يمكن نشر الرسالة.هل تم تحديد قناة نصية يمكن الوصول إليها وهل يُسمح لـ Fjord بإرسال الرسائل والتضمين فيها؟
تم رفض الصورة.اختر PNG أو JPG/JPEG أو WebP أو GIF. تُرفع الصور عند الحفظ. الحد للصور المصغرة 5 MB وللصور الكبيرة 10 MB. يسمح الإرسال لمرة واحدة في وحدة التضمينات بعشر صور محلية بإجمالي 20 MB.
الإرسال مرة واحدة غير متاح.الوظيفة متاحة فقط قبل الحفظ الأول وتقتصر على عشرة مرفقات محلية.
لم يتم ذكر الدور.في V1 قد ترسل إشارات النص العادي تنبيهات، لكن التضمينات التقليدية لا تفعل. في V2 قد تطلق كتل النص إشارات أيضًا. يحتاج Fjord إلى إذن Discord المناسب لـ@everyone و@here والرتب غير المتاحة للإشارة العامة. راجع الإشارات قبل النشر.
القناة المحفوظة لم تعد متاحة.حدد قناة موجودة يُسمح لـ Fjord بالنشر فيها واحفظها مرة أخرى.

عناصر استبدال التركيبات

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

{member.guild.member_count}عدد الأعضاء
{guild.owner.mention}الإشارة إلى مالك الخادم
{member.guild.name}اسم الخادم
{guild.owner.id}معرّف مالك الخادم
{channel.mention}الإشارة إلى قناة الهدف
{time.relative}الوقت النسبي
{channel.id}معرّف قناة الهدف
{bot.mention}الإشارة إلى البوت
{time.full}التاريخ والوقت
{guild.id}معرّف الخادم
{bot.name}اسم البوت
{bot.id}معرّف البوت

المتطلبات والحدود

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

المعاينة والمحتوى المخفي وملفات الصور

في معاينة V2 تحتفظ صورة المعرض المنفردة بنسبة أبعادها. تظهر الصور المتعددة في شبكة بمساحات قص متساوية بنسبة 16:9. تستخدم صورتان أو أربع صور عمودين، وتستخدم ثلاث صور ومن خمس إلى عشر صور ثلاثة أعمدة. تظهر الصورة المصغرة يمين نص القسم. يوفر وصف الصورة نصًا بديلًا وليس تعليقًا مرئيًا إضافيًا.

تخص مفاتيح إخفاء الصور والحاويات محرر V2. يمكن إخفاء كل صورة في المعرض والصور المصغرة بشكل مستقل. يخفي إعداد الحاوية محتواها مع إبقاء إطارها الخارجي ظاهرًا. يكشف النقر المحتوى في المعاينة دون تغيير الإعداد المحفوظ. يستطيع الأعضاء أيضًا كشف المحتوى المخفي بالنقر في Discord.

تقبل صور الرسائل PNG وJPG/JPEG وWebP وGIF. يجب أن يتوافق نوع الملف مع محتوى الصورة. تغيير امتداد ملف HTML أو SVG لا يجعله صورة مدعومة. تبقى حدود جداول الصور مطبقة على كل ملف. إذا رُفضت صورة محلية أو تعذرت قراءتها، فاختر الملف الأصلي مجددًا وأعد الحفظ.

تدعم حقول نص Markdown روابط الويب والبريد الإلكتروني. تفتح المعاينة روابط HTTP(S) وmailto، لكنها لا تفتح الملفات المحلية أو عناوين Blob. تتطلب روابط المؤلف والعنوان وأزرار الروابط عناوين HTTP(S) كاملة. لا تنشر المعاينة رسالة. تحقق من النتيجة المحفوظة في Discord، فقد يختلف العرض حسب العميل وعرض الشاشة.