# من Excel إلى Typst

حوِّل الورقة الأولى من ملف Excel أو CSV أو TSV إلى جدول Typst مهرَّب الرموز.

تنقل أداة "Excel to Typst" جدولًا جاهزًا من جدول بيانات إلى مستند Typst. تقرأ الملف، وتهرِّب كل خلية، وتكتب لك استدعاء `#table`.

## الاستخدامات الأنسب

استخدمها لجدول مستطيل نظيف: نتائج أو إحصاءات موجزة أو شبكة مقارنة أُعدَّت في جدول بيانات. يصبح الصف الأول صفًا للرأس بخط عريض.

إذا كانت الصفوف في الحافظة بالفعل، فتأخذ أداة [من CSV إلى Typst](/docs/tools/csv-to-typst/) النص الملصوق. ولمستند LaTeX استخدم [من Excel إلى LaTeX](/docs/tools/excel-to-latex/). وأبقِ المخططات والرسوم البيانية أشكالًا.

## تحويل ورقة

1. افتح **Excel to Typst**، أو شغِّل `/excel-to-typst`.
2. اختر ملفًا من نوع `.xlsx` أو `.xls` أو `.csv` أو `.tsv`.
3. اختر **Convert**.
4. تحقق من عدد الصفوف والأعمدة في الملاحظة أسفل النتيجة.
5. انسخ الجدول أو احفظ `table.typ`، ثم الصقه في مستندك.

ورقة مثل هذه:

| الطراز | الدقة | الزمن (ث) |
| --- | ---: | ---: |
| الأساس | 0.81 | 12.4 |
| المقترح | 0.87 | 10.9 |

تصبح جدول Typst من ثلاثة أعمدة. وتُحاذى الأعمدة الرقمية إلى اليمين، والأعمدة النصية إلى اليسار، وتوضَع خطوط أفقية عند أعلى الجدول والرأس وأسفله. ولا يحتاج Typst إلى حزمة إضافية لذلك.

## سلوك جداول البيانات

- يقرأ Oleafly **الورقة الأولى** في المصنَّف.
- تستخدم خلايا الصيغ النتيجة المخزنة مؤقتًا في الملف. أعد الحساب واحفظ جدول البيانات أولًا إذا كانت القيم قد تكون قديمة.
- يسهم النطاق المدمج بقيمته من الخلية العلوية اليسرى. أما الخلايا الأخرى ففارغة.
- تُهرَّب الأحرف التي قد يفسّرها Typst كترميز تنسيق.
- يبقى التحويل على جهازك.

:::caution[حدود الحجم والتخطيط]
يجوز أن تحتوي الورقة حتى 10,000 صف و100 عمود، وبما لا يتجاوز 2 ميغابايت من نص الخلايا. ولا يُعاد إنتاج المخططات ولا الألوان ولا تنسيق الخلايا ولا الصيغ ولا الروابط بين الأوراق.
:::

لإدخال ملف بيانات إلى مستند Typst مفتوح بدلًا من ذلك، انقر بزر الفأرة الأيمن في المحرر واختر **Table from CSV/XLSX…**. يقرأ ذلك الحوار JSON أيضًا، ويقبل تسمية توضيحية ووسمًا، ويمكنه إبقاء الجدول مرتبطًا بنسخة من البيانات في المشروع، بحيث يحدِّث تعديلُ البيانات الجدولَ عند التجميع التالي.
