# من CSV إلى Typst

الصق صفوف CSV أو TSV واحصل على جدول Typst معالَجًا بعلامات الهروب، مع صف رأس وخطوط أفقية.

تحوّل أداة CSV إلى Typst صفوف جداول البيانات المنسوخة إلى جدول Typst. الصق الصفوف، وحوّلها، ثم الصق الجدول في ملف `.typ` الخاص بك.

## متى تستخدمه

- نسخت نطاقًا من جدول بيانات أو ملف نتائج؛
- البيانات نص عادي بالفعل، مثل تصدير CSV صغير؛
- تريد مصدر Typst معالَجًا بعلامات الهروب دون كتابة استدعاء `table` بنفسك.

لمصنّف `.xlsx` أو `.xls`، استخدم [Excel to Typst](/docs/tools/excel-to-typst/). لمستند LaTeX، استخدم [Excel to LaTeX](/docs/tools/excel-to-latex/).

## حوّل الصفوف

1. افتح **CSV to Typst**، أو شغّل `/csv-to-typst`.
2. الصق صفوفًا مفصولة بفواصل أو بعلامات جدولة، أو اختر **Load example**.
3. اختر **Convert**.
4. تحقق من عدد الصفوف والأعمدة في الملاحظة أسفل النتيجة.
5. انسخ الجدول أو احفظ `table.typ`.

على سبيل المثال:

```text
Method,Accuracy,Runtime (s)
Baseline,0.82,14.2
Oleafly,0.95,9.8
```

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

## سلوك الجدول

- يكتشف Oleafly علامات الجدولة أو الفواصل من السطر الأول.
- يمكن للخلايا المقتبسة أن تحمل فواصل وعلامات اقتباس وفواصل أسطر. يصبح فاصل السطر داخل خلية مسافة.
- تُعالَج الأحرف التي كان Typst سيقرؤها كترميز، مثل `#` و`*` و`_` و`$`، بعلامات هروب.
- يعمل التحويل على جهازك.

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

داخل مستند Typst يمكنك تخطي النسخ واللصق. انقر بزر الفأرة الأيمن في المحرر واختر **Table from CSV/XLSX…**. يقرأ مربع الحوار ذلك ملفات CSV أو TSV أو XLSX أو JSON، ويضيف تسمية توضيحية ومعرّفًا مرجعيًا اختياريين، ويمكنه إبقاء الجدول مرتبطًا بملف بياناته بحيث يحدَّث الجدول عند التجميع التالي. طالع [الكتابة في Typst](/docs/writing/typst/).
