# من HTML إلى Typst

حوِّل HTML الدلالي إلى مستند Typst مستقل يمكنك تحريره وتجميعه أو تحويله إلى مشروع.

تأخذ أداة "HTML to Typst" ترميز الويب المهيكل وتمنحك كود Typst. فالعناوين والفقرات والتوكيد والقوائم والروابط والجداول البسيطة تنتقل كلها، فلا تحتاج إلى إعادة بنائها يدويًا.

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

- عندما كتبت ترميز HTML بنفسك أو تملك إذنًا بإعادة استخدام محتواه؛
- عندما تستخدم الصفحة عناصر ذات معنى مثل العناوين والفقرات والقوائم؛
- عندما تريد بنية المستند في Typst، لا نسخة مرئية من الصفحة.

الصق ترميز HTML نفسه. فالأداة لا تنزّل صفحات الويب، ولا تشغّل السكربتات، ولا تعيد بناء تخطيط يعتمد على CSS وJavaScript.

## تحويل الترميز

1. افتح **HTML to Typst**، أو شغِّل `/html-to-typst`.
2. الصق مقطع HTML أو مستندًا كاملًا، أو اختر **Load example**.
3. اختر **Convert**.
4. اقرأ كود Typst المتولد.
5. انسخه، أو احفظ `converted.typ`، أو اختر **Create project** لفتحه كمشروع Typst.

مثلًا:

```html
<h2>Method</h2>
<p>We compared <strong>three</strong> conditions.</p>
<ul><li>Control</li><li>Treatment</li></ul>
```

يصبح عنوانًا في Typst وفقرة بنص عريض وقائمة نقطية.

## ما ينجو من الانتقال

يحوِّل Pandoc المدمج في Oleafly البنية الدلالية على جهازك. أما تخطيطات الشبكة ونقاط التوقف المتكيفة والتحريكات ومعظم تنسيقات CSS فليس لها مقابل في Typst وتُترك جانبًا.

تحقق بعد ذلك من الروابط وكتل الكود والجداول والقوائم المتداخلة ومراجع الصور. لا تجلب الأداة الصور البعيدة أو أوراق الأنماط. ولإدخال ملف `.html` مع صوره، استخدم **Import a project → HTML page** في المكتبة، حيث يمكن إنشاء مشروع Typst واستخراج الصور المضمّنة إلى `assets/`. ويغطي [دليل الاستيراد](/docs/import-project/) ذلك.

إذا كانت الوجهة LaTeX فاستخدم [من HTML إلى LaTeX](/docs/tools/html-to-latex/).
