# محرر Typst المرئي

ابدأ مشروع Typst مباشرة في تخطيط يجمع الكتابة والمعاينة.

تزيل أداة Visual Typst Editor خطوة إعداد المشروع الفارغ. فهي تنشئ مستند Typst وتفتح المصدر بجانب معاينة PDF الحية له، فيظهر أثر كل تعديل من السطر الأول.

## متى تختار هذه الأداة

استخدمها عندما تتعلم Typst، أو تحوّل فكرة صغيرة إلى مستند منسق، أو تريد رؤية المصدر والناتج معًا.

اختر [Typst Editor](/docs/tools/typst-editor/) عندما تكون مساحة الشاشة ضيقة أو تفضّل البدء بتخطيط المحرر فقط. كلتا الأداتين تنشئ النوع نفسه من المشروع، ولا يختلف إلا تخطيط الافتتاح.

:::note[ما معنى "Visual" هنا]
تفتح هذه الأداة مساحة عمل مقسومة بين المصدر والمعاينة. وللتحرير مع إخفاء الترميز، بدّل في شريط أدوات المحرر من **Code** إلى **Visual** في أي ملف Typst. عندها تُعرض العناوين والتوكيدات والقوائم والرياضيات والصور والجداول والمراجع في مواضعها، ويظهر في المصدر موضع المؤشر.
:::

## بدء المستند

1. فعّل **Settings → Experimentation → LaTeX tools**.
2. افتح **Visual Typst Editor**، أو شغِّل `/visual-typst-editor`.
3. ينشئ Oleafly **Untitled Typst document** ويفتحه في عرض Split.
4. أعد تسمية المشروع واكتب في ملف المصدر `.typ`.
5. صدّر ملف PDF المجمّع عندما تصبح المعاينة جاهزة.

جرّب هذه البداية الصغيرة:

```typst
= Results

The treatment group improved by *12%*.

$ integral_0^1 x^2 dif x = 1/3 $
```

مع تفعيل **Auto compile**، يحدّث محرك Typst المضمّن المعاينة أثناء كتابتك. ويبقى مصدرك ملف `.typ` عاديًا يمكنك تحريره خارج Oleafly.

## من المفيد معرفته

- يعمل تجميع Typst وتصدير PDF محليًا.
- يستخدم Typst حزمًا من Typst Universe، لا حزم LaTeX أو `tlmgr`.
- لا تترجم أوامر LaTeX مباشرة إلى صياغة Typst. استخدم [LaTeX to Typst](/docs/tools/latex-to-typst/) للحصول على نقطة بداية محوّلة.
- ينقلك **Go to PDF** والنقر داخل ملف PDF بين المصدر والصفحة، كما في مشاريع LaTeX.

لمتابعة تحرير المشروع والملفات والتصديرات بعد الإنشاء، تابع مع [الكتابة في Typst](/docs/writing/typst/). وتغطي صفحة [مشاريع Typst](/docs/typst/) الإصدارات والحزم والخطوط.