كيفية استخدام Markdown

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

Frontmatter

الكتلة الموجودة في أعلى الملف، والمحاطة بثلاث شرطات، هي المادة الأمامية. فهو يقوم بتكوين الصفحة بدلاً من الظهور عليها، ويجب أن يكون أول شيء في الملف:

---
layout: doc
sidebar: false
aside: false
---

# My Page

المفاتيح التي تستحق المعرفة:

مفتاح	تأثير
layout	doc للصفحة العادية، home للصفحة المقصودة
sidebar	false يخفي شريط التنقل الأيسر
aside	يخفي false جدول المحتويات الموجود على الصفحة على اليمين
title	يتجاوز عنوان علامة تبويب المتصفح

معظم الصفحات لا تحتاج إلى مادة أمامية على الإطلاق. قم بإضافته فقط عندما تريد إيقاف تشغيل شيء ما.

صناديق وسائل الشرح

هذه هي اللوحات الملونة المستخدمة في جميع أنحاء الموقع. مفتوح بثلاث نقطتين والنوع، مغلق بثلاث نقطتين:

::: tip
Handy but optional advice.
:::

::: warning
Something the reader can get wrong.
:::

::: danger
Something that will break their server or lose their data.
:::

::: info
Extra background that is not needed to follow the steps.
:::

يمكنك إعطاء أي منها عنوانًا مخصصًا عن طريق وضع النص بعد النوع:

::: tip RECOMMENDED
This shows "RECOMMENDED" as the box title instead of "TIP".
:::

استخدم هذه العناصر باعتدال. من الصعب قراءة الصفحة التي توجد بها كل فقرات أخرى في مربع ملون من تلك التي لا تحتوي على أي فقرة.

كتل التعليمات البرمجية

قم دائمًا بتسمية اللغة بعد علامات الفتح الخلفية. يقوم بتشغيل تمييز بناء الجملة ويخبر القارئ بما هو عليهالنظر إلى:

```bash
steamcmd + تسجيل دخول مجهول + تحديث التطبيق 629800 التحقق من صحة + إنهاء
```

bash وini وjson وmd وjs وts كل شيء تقريبًا في هذه المستندات.

تمييز خطوط محددة

ضع أرقام الأسطر بين قوسين متعرجين لجذب الانتباه إلى جزء من كتلة:

```ini{2}
[/Script/Mordhau. MordauGameSession]
MaxSlots=64
ServerName=خادمي
```

Windows وLinux جنبًا إلى جنب

عندما تختلف الخطوة حسب النظام الأساسي، استخدم مجموعة التعليمات البرمجية بدلاً من كتابة القسم مرتين:

::: code-group

```powershell [Windows]
. \steamcmd. exe + تسجيل دخول مجهول + التحقق من صحة app_update 629800 + إنهاء
```

```bash [Linux]
. /steamcmd. sh +تسجيل دخول مجهول +app_update 629800 التحقق من صحة +إنهاء
```

:::

يحصل القارئ على علامات التبويب ولا يرى سوى علامات التبويب التي يحتاجها.

الروابط بين الصفحات

الروابط الداخلية تبدأ من مجلد اللغة وتترك .md:

[Required Tools](/en/contributing/tools)
[RCON Guide](/en/rcon-guide/)

يشير المسار الذي ينتهي بـ / إلى index.md لهذا المجلد.

WARNING

اكتب الروابط الداخلية بالمسار الكامل من جذر الموقع، وليس الروابط النسبية مثل ../tools. تنقطع الروابط النسبية بمجرد تحرك الصفحة، وتؤدي وظيفتهابشكل مختلف في معاينة GitHub عما هو عليه على الموقع.

عندما تقوم بالارتباط بصفحة في قسم مترجم، اجعل القارئ يتحدث بلغته. من رابط صفحة فرنسية إلى /fr/rcon-guide/، وليس /en/rcon-guide/.

الصور

ضع الملف في نفس مجلد الصفحة التي تستخدمه واربطه من جذر الموقع:

![Server browser showing a custom server](/en/dedicated-server-guide/browser.webp)

احفظ لقطات الشاشة باسم .webp حيث يمكنك ذلك. إنها جزء صغير من حجم PNG بنفس الجودة، وهذا المستودع كبير بالفعل بما يكفي.

إضافة صفحة جديدة

إنشاء الملف هو نصفه فقط - صفحة لا يمكن لأحد الانتقال إليها قد لا تكون موجودة أيضًا.

1. قم بإنشاء ملف .md في المجلد الأيمن ضمن docs/.
2. افتح .vitepress/config.mts.
3. ابحث عن اللغة التي تضيف إليها، وأضف إدخالاً إلى nav أو sidebar الذي يشير إلى صفحتك.
4. قم بتشغيل npm run docs:dev وانقر عليه.

إذا كانت صفحتك تنتمي إلى كل اللغات، أضف اللغة الإنجليزية أولاً واترك اللغات الأخرى للمترجمين. الصفحة الفارغة أسوأ من الصفحة المفقودة.

نمط المنزل

• عنوان # واحد لكل صفحة، في الأعلى، ويجب أن يتطابق مع ما يطلق عليه الشريط الجانبي الصفحة.
• لا تتخطى مستويات العناوين — يجب أن يكون ### أسفل ##، وليس أسفل # مباشرة.
• ضع سطرًا فارغًا قبل وبعد العناوين والقوائم وكتل التعليمات البرمجية ووسائل الشرح. Markdown يتسامح مع هذا حتى فجأة لم يعد كذلك.
• استخدم العلامات الخلفية لأسماء الملفات والأوامر ومفاتيح التكوين والقيم. Game.ini، وليس "Game. ini".
• اسمح لـ Prettier بالتعامل مع تغليف الخط. لا تضف فواصل أسطر يدوية لإبقاء الأسطر قصيرة.