ForHosting KIT · أدوات المطورين

كيانات HTML مسماة → رقمية

بدّل كيانات HTML بين الأسماء والأرقام: يصبح © هو © ويصبح — هو —، فيمر الترميز عبر محللات XML وبوابات البريد التي لا تعرف كل الأسماء، ويعود مقروءًا متى أردت. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

النص: Copyright © 2024 — all rights reserved
وضع الحساب: To numeric

تحصل على

النتيجة: Copyright © 2024 — all rights reserved
المحوَّل: 2
الترميز: entity_named_to_numeric
طول المُدخَل: 49

يحتاج مؤلفو HTML ومهندسو خطوط الأنابيب كثيرًا إلى كتابة الحرف نفسه بطريقتين: كيان مسمّى مثل © أو —، أو مرجع رقمي للحرف مثل © أو —. الصيغ المسماة أوضح في المصدر؛ والصيغ الرقمية تمرّ عبر محلّلات XML وعملاء البريد والمعالجات الصارمة التي لا تحمل جدول أسماء HTML كاملًا. تعيد هذه القدرة كتابة كيانات HTML المسماة إلى مكافئها من المراجع الرقمية العشرية، وتعيد المراجع الرقمية إلى الصيغ المسماة المفضّلة عندما تكون نقطة الترميز معروفة. المسار حتمي بالكامل: النص والوضع نفسهما يعطيان دائمًا النتيجة نفسها، بلا شبكة ولا عشوائية ولا اختصارات تعتمد على التاريخ.

الكيانات المسماة مقابل المراجع الرقمية للحرف

كيان HTML المسمّى هو تهريب تذكّري مثل © لعلامة حقوق النشر أو — لشرطة الطول الكامل. يرمّز المرجع الرقمي للحرف نفس عددي يونيكود بالصيغة العشرية © أو السداسية عشرية ©. كلاهما صالح في HTML؛ وتُطلب الصيغ الرقمية في بعض لهجات XML وتُفضَّل عندما قد لا يعرف المستهلك كل أسماء HTML5.

لا ترمّز هذه الأداة النص الخام إلى كيانات ولا تفكّ الكيانات إلى رموز مرئية للعرض—ذلك عمل مرمّز كيانات HTML العام. العقد هنا تحويل تنسيق صارم بين المراجع المسماة والرقمية الموجودة أصلًا في السلسلة. تُقبل الإدخال السداسي؛ ومخرجات رقمية ناجحة تستخدم دائمًا الشكل العشري لتبقى الاختبارات والفروق مستقرة بايتًا بايت.

تُترك علامات & العارية التي لا تكوّن كيانًا كاملًا ينتهي بفاصلة منقوطة دون مساس، فيُحمى المسودات الناقصة مع التقاط الأسماء الكاملة المجهولة مثل &notanentity;.

أين تُثبت قيمة التحويل من المسمّى إلى الرقمي

غالبًا تبدأ خطوط HTML للبريد من محتوى CMS مليء بالكيانات   و’ و— ويجب أن تمرّ عبر بوابات تضمن المراجع الرقمية فقط. تفضّل مسلسلات XML وتضمينات SVG أيضًا &#N; على أسماء ليست من XML 1.0. يثبّت مهندسو الجودة الاتجاهين في اختبارات العقد حتى لا يغيّر وسيط بصمت كيفية إخراج & أو € بين الإصدارات.

تستخدم فرق التعريب وإمكانية الوصول التحويل نفسه عند تدقيق اتساق كيانات حقوق النشر والعلامة والترقيم عبر القوالب. يبيّن المعلّمون الفرق بين الكيانات المسماة والمراجع العشرية والسداسية بأوراكل حتمي واحد. اقرن هذه الصفحة بمرمّز كيانات HTML العام عندما تحتاج تهريب & والأقواس الزاوية من النص الخام، وبأدوات نقاط ترميز يونيكود عندما تحتاج رموز U+XXXX بدل مراجع HTML.

نية بحث مختلفة وموثوقية parse نقية كما في بقية كتالوج الترميز من المستوى A.

حالات الاستخدام

توحيد كيانات البريد وXML

أعد كتابة كيانات CMS المسماة مثل © و— إلى مراجع رقمية عشرية قبل إرسال HTML عبر معالجات بريد أو XML صارمة.

تنظيف رقمي مقروء للمحررين

حوّل مقالب © و— القديمة إلى كيانات مسماة مقروءة للمحررين البشريين ومراجعات القوالب.

تركيبات CI لشكل الكيان

ولّد أزواجًا حتمية من المسمّى إلى الرقمي ومن الرقمي إلى المسمّى حتى لا يغيّر الوسيط أسلوب الكيان بين الإصدارات.

الأسئلة الشائعة

ما الفرق بين هذه الأداة ومرمّز كيانات HTML العام؟

يحوّل المرمّز العام الأحرف الخاصة إلى كيانات ويفكّ الكيانات إلى رموز. هذه الأداة تعيد فقط كتابة المراجع المسماة إلى رقمية (والعكس) دون تهريب النص غير الكياني.

لماذا أحوّل الكيانات المسماة إلى مراجع رقمية؟

لأن المراجع الرقمية تصل بأمان أكبر. فمحللات XML وبعض برامج البريد والمعالجات الصارمة لا تحمل جدول أسماء HTML كاملًا، وبعض لهجات XML تشترط الأرقام، بينما يُفهم © في كل مكان على أنه علامة حقوق النشر.

ماذا يحدث إذا كان اسم الكيان غير معروف؟

يتوقف التحويل ويذكر الكيان المجهول، مثل &notanentity;، حتى لا يبقى خطأ مطبعي مخفيًا في الترميز النهائي. صحح ذلك الكيان أو احذفه ثم أعد التحويل.

هل تُقبل المراجع الست عشرية مثل ©؟

نعم، كمدخلات. عند التحويل من الأرقام إلى الأسماء يصبح © هو © تمامًا كما يحدث مع ©. وحين تكون النتيجة رقمية تُكتب دائمًا بالنظام العشري لتبقى متطابقة في كل مرة.

ماذا يحدث لعلامة & التي ليست جزءًا من كيان؟

تبقى كما هي تمامًا. لا يُحوَّل إلا الكيان الكامل المنتهي بفاصلة منقوطة، لذا لا تفسد علامة & منفردة في مسودة بقية النص.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/enc/entity-named-to-numeric

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/enc/entity-named-to-numeric \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Copyright &copy; 2024 &mdash; all rights reserved"}'

const res = await fetch("https://api.kit.forhosting.com/enc/entity-named-to-numeric", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Copyright &copy; 2024 &mdash; all rights reserved"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/entity-named-to-numeric",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Copyright &copy; 2024 &mdash; all rights reserved"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/entity-named-to-numeric", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Copyright &copy; 2024 &mdash; all rights reserved"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Copyright &copy; 2024 &mdash; all rights reserved"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/entity-named-to-numeric", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "text": "Copyright &copy; 2024 &mdash; all rights reserved"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.entity_named_to_numeric",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

تُبلَّغ الأسماء المجهولة بخطأ invalid_input حتى لا تبقى الأخطاء الإملائية صامتة في ترميز الإنتاج. استخدم الأداة المجانية في المتصفح للتنظيفات الفردية، أو استدعِ API بسعر $0.002 لكل طلب ناجح عندما تحتاج صادرات CMS وقوالب البريد وتركيبات CI إلى تحويل قابل للتكرار من الكيانات المسماة إلى الرقمية.

الكيانات المسماة مقابل المراجع الرقمية للحرف

في الوضع to_numeric يُبحث كل &name; سليم في خريطة ثابتة لأسماء XML وHTML4 وHTML5 الشائعة ويُعاد كتابته كرمز عشري مستقر &#N;. في الوضع to_named يُعاد تعيين كل &#N; أو &#xH; سليم إلى الاسم المفضّل عندما تكون نقطة الترميز مسجّلة، فيصبح — هو — و© هو ©.

عقد الإدخال والأوضاع والإبلاغ عن الأسماء المجهولة

أرسل جسم JSON عبر POST يحوي الحقل النصي الإلزامي text وفيه المقطع المراد تحويله. تُقبل الأسماء البديلة input وvalue وs وhtml حتى تعيد النماذج وعملاء SDK استخدام أسماء الحقول القائمة. الوضع الافتراضي to_numeric ويمكن ضبطه إلى to_named؛ والأسماء op وdirection وaction تشير إلى نفس المفتاح. في to_numeric يمسح المعالج الكيانات المسماة فقط، ويعيد كتابة كل اسم معروف إلى &#codepoint;، وإذا ظهر اسم كامل مجهول يفشل بـ invalid_input ويسرد الرسالة كل اسم مجهول مميز حتى تصلح المصدر في تمريرة واحدة. في to_named يمسح المراجع الرقمية العشرية والسداسية، ويعيد كتابة نقاط الترميز المعروفة إلى أسمائها المفضّلة، ويترك غير المعيَّنة مراجع عشرية موحّدة مع عدّها في unmapped_numeric عندما يزيد العدّ عن صفر. نقاط الترميز البديلة والقيم خارج نطاق عددي يونيكود ترفع invalid_input بدل إخراج UTF-16 تالف. حمولة النجاح تتضمن دائمًا result وmode وencoding الثابت entity_named_to_numeric وconverted كعدد المراجع المعاد كتابتها وinput_length وoutput_length وunknown_names كمصفوفة فارغة عند النجاح. لا شبكة ولا Date ولا عشوائية؛ لذا يعيد مسار المتصفح المجاني وAPI المدفوع نفس JSON لنفس الإدخال. التحقق الفاشل لا يُحاسب؛ والنداءات الناجحة تكلّف السعر الأساسي المنشور $0.002 لكل عنصر.

أين تُثبت قيمة التحويل من المسمّى إلى الرقمي

هجرات المحتوى التي تعكس المشكلة—مقالب عشرية قديمة يريد المحررون قراءتها ككيانات مسماة—تستخدم الوضع to_named ليحرّر البشر © بدل ©. في هذه الصفحة يعمل كل شيء داخل متصفحك؛ وعبر API تكلّف كل تحويل ناجح $0.002، والإدخال غير الصالح لا يُحاسب، ولا يُخزَّن شيء بعد الاستجابة.

أسئلة تقنية

ماذا يحدث إذا كان الكيان المسمّى مجهولًا؟

تفشل المهمة بـ invalid_input وتسرد الرسالة الاسم أو الأسماء المجهولة. لا يُعاد كتابة شيء ولا تُحاسب المكالمة.

هل يمكنني إعادة الكيانات الرقمية إلى أسماء؟

نعم. اضبط mode على to_named. تصبح نقاط الترميز المعروفة أسماء مفضّلة مثل ©؛ وتبقى غير المعيَّنة مراجع رقمية عشرية وتُعدّ في unmapped_numeric عند وجودها.

كم تكلفة تحويل كيانات HTML المسماة إلى رقمية؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ والإدخال غير الصالح لا يُحاسب.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

الكيانات المسماة مقابل المراجع الرقمية للحرف

أين تُثبت قيمة التحويل من المسمّى إلى الرقمي

حالات الاستخدام

توحيد كيانات البريد وXML

تنظيف رقمي مقروء للمحررين

تركيبات CI لشكل الكيان

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

الكيانات المسماة مقابل المراجع الرقمية للحرف

عقد الإدخال والأوضاع والإبلاغ عن الأسماء المجهولة

أين تُثبت قيمة التحويل من المسمّى إلى الرقمي

أسئلة تقنية

شكرًا