مهرب LaTeX
في 10%_off يقرأ LaTeX علامة النسبة المئوية بداية تعليق والشرطة السفلية بداية نص منخفض؛ وبعد التهريب إلى 10\%\_off تُطبع كلتاهما كما كُتبتا. ويسري ذلك على & وعلامة الدولار والأقواس المعقوفة والشرطة العكسية، ويمكن عكس العملية. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- Cost is $5 & 10%_off
- وضع الحساب
- Escape
- النتيجة
- Cost is \$5 \& 10\%\_off
- الطول
- 24
- أحرف خاصة
- 4
لصق نص حر داخل مستند LaTeX فخ شائع: علامة العطف تنهي خلية جدول، والنسبة المئوية تبدأ تعليقاً يبتلع بقية السطر، والدولار يفتح وضع الرياضيات، والشرطة السفلية تبدأ مؤشراً سفلياً، والمربع يصطدم بمعاملات الماكرو، والأقواس المعقوفة تغيّر التجميع، والتيلدا تصبح مسافة غير قابلة للكسر، والرمز الرفيع يبدأ مؤشراً علوياً، والشرطة المائلة العكسية المنفردة تبدأ تسلسل تحكم. يحوّل مهرب LaTeX هذا النص العادي إلى جزء آمن يمكنكم إدراجه في الفقرات والتسميات التوضيحية والملصقات وحقول المراجع، ويعكس نفس الخريطة عندما تحتاجون الحروف الأصلية.
كيف تعمل تهريبات الرموز الخاصة في LaTeX عملياً
يعامل LaTeX مجموعة صغيرة من محارف ASCII كبنية نحوية لا كرموز قابلة للطباعة. الشرطة المائلة العكسية تفتح تسلسلات التحكم، لذا لا يجوز أن يظهر مسار مثل C:\Users خاماً في وضع النص. علامة العطف فاصل أعمدة في بيئات tabular وalign؛ والنسبة المئوية تبدأ تعليقاً يخفي كل شيء حتى نهاية السطر؛ والدولار يبدّل الرياضيات المضمنة؛ والشرطة السفلية والرمز الرفيع يعلّمان المؤشرات السفلية والعلوية؛ والمربع يعلّم معاملات الماكرو؛ والأقواس المعقوفة تحدّد المجموعات؛ والتيلدا محرف نشط للمسافات غير القابلة للكسر.
عندما تحقن سلسلة المعالجة عناوين المستخدمين أو رموز المنتجات أو أسماء الملفات أو عنوان URL أو خلايا CSV في قالب .tex، فإن أيّاً من هذه الرموز الخاصة سيغيّر معنى المستند أو يوقف الترجمة. تسير هذه القدرة على المدخل حرفاً حرفاً. في وضع escape تستبدل كل رمز خاص بتسلسل نصي قياسي: الرموز البسيطة تصبح شرطة مائلة عكسية ثم الحرف (\& و\% و\$ و\# و\_ و\{ و\})، بينما تستخدم الشرطة المائلة العكسية والتيلدا والرمز الرفيع صيغاً مسماة بأقواس فارغة حتى لا تُمتص الحروف التالية في كلمة تحكم.
في وضع unescape تطابق أطول تسلسل معروف أولاً، وتعيد الحرف العادي، وترفض الشرطات الختامية وشظايا \textbackslash{ المقطوعة وصيغ \~ أو \^ القصيرة الناقصة وأي تهريب غير معروف، فلا يتلقى المستدعي فساداً صامتاً.
ما ترسلونه وما تستلمونه
أرسلوا حقل سلسلة إلزامياً باسم text وحقل mode اختيارياً. يحوّل وضع escape النص العادي إلى نص آمن لـ LaTeX يُخزَّن في result. يعكس وضع unescape تسلسلات الرموز الخاصة المعروفة في text ويعيد السلسلة العادية المسترجعة في result.
ترد الاستجابة دائماً mode وtext الأصلي، وتضيف result وlength للنتيجة وspecials — عدد الرموز الخاصة المعاد كتابتها في أي اتجاه — حتى تعرض الواجهات مقدار العمل. أخطاء التحقق لا تستهلك الرصيد المدفوع مسبقاً. تشمل الفحوصات الكلاسيكية تهريب سطر سعر فيه دولارات وعطف ونِسب؛ وإلغاء تهريب جزء يستخدم \_ و\textbackslash{}؛ وذهاباً وإياباً للأقواس والمربعات من SKU منتج؛ ورفض سلسلة تنتهي بشرطة مائلة عكسية عارية.
اربطوا نموذج المتصفح المجاني للفحص السريع والعروض الصفية، ثم العقد نفسه من البرامج النصية عند توليد التقارير أو الفواتير أو دفعات المقالات.
أين يبرهن مهرب LaTeX على قيمته
مولّدات المستندات التي تدمج حقول CRM أو إجابات الاستبيانات أو خلايا الجداول في قوالب LaTeX يجب أن تهرّب كل قيمة نص حر قبل الكتابة، وإلا فعلام عطف واحدة في اسم شركة تكسر tabular ونسبة في تسمية خصم تعلّق بقية الصف. خطوط الأنابيب الأكاديمية والنشر التي تبني صفحات العنوان والملخصات وقوائم المؤلفين من نماذج الويب تحتاج مسار تهريب موثوقاً حتى تبقى عينات المستخدم TeX صالحاً. فرق الدعم والتعريب تلصق شظايا سجلات أو مواضيع تذاكر تحتوي أصلاً تهريبات بشرطة مائلة عكسية وتحتاج مسار إلغاء يهتف عند التسلسلات المقطوعة بدلاً من اختراع حروف.
مؤلفو المناهج الذين يعلّمون رموز TeX الخاصة يريدون صفحة مخصصة لتهريب المحارف بدل دفن الموضوع تحت أداة Base64 عامة أو كيانات HTML، لأن نية البحث ومجموعة التهريب المسموحة تختلفان. إن احتجتم كيانات HTML أو ترميز نسب URL أو حرفيات سلاسل JavaScript أو ترجمة مستند كاملة، فاعاملوها كنيات بحث وصفحات هبوط منفصلة بدل تحميل صفحة مهرب LaTeX هذه أكثر مما تحتمل.
حالات الاستخدام
نص حر آمن في ملفات .tex المولَّدة
هرّبوا العناوين والتسميات التوضيحية وخلايا الجداول وحقول المراجع قبل كتابتها في قوالب LaTeX حتى لا تكسر & و% و$ و_ و\ الترجمة.
ذهاب وإياب لرموز المنتجات وSKU
هرّبوا وألغوا تهريب SKU وسلاسل شبيهة بالمسارات تمزج شرطات سفلية ومربعات ودولارات وشرطات مائلة عكسية للفواتير والتقارير التقنية.
الأسئلة الشائعة
أي المحارف تُهرَّب؟
الشرطة المائلة العكسية وعلامة العطف والنسبة المئوية والدولار والشرطة السفلية والمربع والأقواس المعقوفة اليسرى واليمنى والتيلدا والرمز الرفيع. هذه رموز TeX الخاصة القياسية التي تغيّر معنى المستند في وضع النص.
هل يمكن التهريب وإلغاؤه معاً؟
نعم. اضبطوا mode على escape (الافتراضي) لترميز النص العادي، أو mode على unescape لاستعادة النص من تسلسلات رموز LaTeX الخاصة.
لماذا تُكتب الشرطة المائلة العكسية \textbackslash{} وليس \\؟
في LaTeX، \\ أمر لكسر السطر وليس شرطة مائلة عكسية قابلة للطباعة.
لماذا يختفي باقي السطر بعد علامة النسبة المئوية؟
لأن LaTeX يعامل علامة النسبة المئوية على أنها بداية تعليق، فيخفي كل ما بعدها حتى نهاية السطر. وبعد تهريبها إلى \% تظهر علامة نسبة عادية ويبقى باقي السطر ظاهرًا.
هل يمكن كتابة مسار مثل C:\Users كما هو؟
لا. فالشرطة العكسية تُقرأ بداية أمر، لذا لا يجوز وضعها خامًا في النص. وعند التهريب تحل محلها الصيغة \textbackslash{} فيُطبع المسار كما هو دون أن يفسد المستند.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/enc/latex-escape \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Cost is $5 & 10%_off"}'const res = await fetch("https://api.kit.forhosting.com/enc/latex-escape", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Cost is $5 & 10%_off"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/latex-escape",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Cost is $5 & 10%_off"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/latex-escape", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Cost is $5 & 10%_off"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Cost is $5 & 10%_off"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/latex-escape", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "Cost is $5 & 10%_off"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.latex_escape",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
يعيد وضع escape كتابة كل رمز خاص في TeX بتسلسلات محمولة في وضع النص مثل \& و\% و\$ و\_ و\# و\{ و\} و\textbackslash{} و\textasciitilde{} و\textasciicircum{}. يفهم وضع unescape تلك الصيغ مع المتغيرين القصيرين \~{} و\^{}، ويفشل فوراً بـ invalid_input عند الشرطات الختامية أو التسلسلات المسماة الناقصة أو التهريبات غير المعروفة بدلاً من اختراع نفايات نصف مفكوكة. تشترك الأداة المجانية في المتصفح وواجهة API المدفوعة في دالة واحدةومورفية نقية واحدة، فتتوافق العروض التجريبية وتركيبات الاختبار وخطافات الإنتاج دائماً على نفس التحويل.
كيف تعمل تهريبات الرموز الخاصة في LaTeX عملياً
المسار عمل سلاسل نقي بلا شبكة ولا بذور عشوائية ولا ساعة جدارية، لذلك تنتج المدخلات المتطابقة دائماً نفس JSON. تسعير استدعاءات API الناجحة هو الأساس المنشور $0.002 لكل عنصر، وأخطاء التحقق لا تستهلك الرصيد المدفوع مسبقاً.
ما ترسلونه وما تستلمونه
عند إغفال mode يكون escape هو الافتراضي فيظل الحمولة الواحدة مفيدة. غياب text والكائنات غير السلسلية غير القابلة للإكراه وقيم mode غير المدعومة والسلاسل الأطول من الحد الموثق والشرطات الختامية والصيغ المسماة الناقصة مثل \textbackslash{ مقطوع وصيغ التيلدا أو الرمز الرفيع القصيرة الناقصة وتسلسلات التهريب غير المعروفة تفشل بـ invalid_input ورسالة إنجليزية واضحة تذكر الموضع عند الإمكان. تسعير API عند النجاح هو الأساس المنشور $0.002 لكل عنصر.
أين يبرهن مهرب LaTeX على قيمته
لأن هذه القدرة محرك parse نقي، فتسعير API هو الأساس المنشور $0.002 لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد.
حالات التكامل
استعادة النص العادي من أجزاء مُهرَّبة
ألغوا تهريب تسلسلات رموز LaTeX الخاصة من القوالب والسجلات وتركيبات golden إلى نص مقروء، مع فشل صارم عند التهريب الناقص.
أسئلة تقنية
ماذا يحدث إذا كان تسلسل التهريب تالفاً؟
يفشل unescape بـ invalid_input مع ذكر الموضع والمشكلة (مثلاً شرطة ختامية أو \textbackslash{ ناقص). لا يُحاسب شيء على أخطاء التحقق.
كم التكلفة؟
أداة المتصفح مجانية وتعمل محلياً. طلبات API تستخدم رصيد KIT المدفوع مسبقاً بمبلغ $0.002 لكل عنصر ناجح؛ والمدخل غير الصالح لا يُحاسب.