اللصق من Docusaurus يكسر تنسيق كتل الأكواد

[msohm (Mark Sohm)]

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

إليك مثال على شكل اللصق لهذه القسم: Create a doc | Docusaurus لاحظ كيف أصبحت كتل الكود أسطراً منفصلة بدلاً من كتلة كود مستمرة. يحدث هذا مع أي موقع اختبرته ومبني باستخدام Docusaurus، وليس موقعهم فقط.

---

يتمتع كل مستند بـ id فريد. بشكل افتراضي، يكون id للمستند هو اسم المستند (بدون الامتداد) بالنسبة إلى مجلد المستندات الجذري.

على سبيل المثال، يكون id لـ greeting.md هو greeting، ويكون id لـ guide/hello.md هو guide/hello.

website # Root directory of your site

└── docs

├── greeting.md

└── guide

└── hello.md

ومع ذلك، يمكن للمستخدم تعريف الجزء الأخير من id في الواجهة الأمامية (front matter). على سبيل المثال، إذا كان محتوى guide/hello.md معرّفًا كما هو موضح أدناه، فإن id النهائي سيكون guide/part1.

---

id: part1

---

Lorem ipsum

يُستخدم المعرّف (ID) للإشارة إلى مستند عند كتابة أشرطة جانبية يدوياً، أو عند استخدام مكونات التخطيط أو الخطافات (hooks) المتعلقة بالمستندات.

[merefield (Robert)]

يحدث هذا أيضًا مع النصوص الخام من Markdown على GitHub، للاطلاع

حتى في وضع Markdown …

[renato (Renato Atilio)]

@merefield

هذا يحدث أيضًا مع النصوص الصافية (raw) من Markdown على GitHub، فقط للاطلاع

هل يمكنك مشاركة مثال؟ لم أتمكن من إعادة إنتاج المشكلة مع بعض المصادر التي جرّبتها.

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

إليك مخرجات نفس النص المنسوخ والمُلصق:

---

لكل مستند معرّف id فريد. بشكل افتراضي، يكون معرّف id للمستند هو اسم المستند (بدون الامتداد) نسبيًا إلى مجلد المستندات الجذر.

على سبيل المثال، معرّف greeting.md هو greeting، ومعرّف guide/hello.md هو guide/hello.

website # المجلد الجذر لموقعك
└── docs
   ├── greeting.md
   └── guide
      └── hello.md

ومع ذلك، يمكن للمستخدم تحديد الجزء الأخير من id في البيانات الأولية (front matter). على سبيل المثال، إذا كان محتوى guide/hello.md معرّفًا كما هو موضح أدناه، فسيكون معرّف id النهائي هو guide/part1.

---
id: part1
---

Lorem ipsum

يُستخدم المعرّف id للإشارة إلى مستند عند كتابة الشريط الجانبي يدويًا، أو عند استخدام مكوّنات التخطيط أو الخطافات (hooks) المتعلقة بالمستندات.