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

مؤشر SMOG لسهولة القراءة

يقدّر مؤشر SMOG لسهولة القراءة عدد سنوات التعليم التي قد يحتاج إليها القارئ لفهم مقطع نصي.

● Betaمجاني · داخل متصفحك

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

تحدد هذه الحاسبة الجمل المكتملة، وتقدّر مقاطع الكلمات الإنجليزية، وتحصي الكلمات ذات المقاطع الثلاثة أو أكثر، ثم تطبق معادلة SMOG القياسية. وتعرض المؤشر مع أعداد الجمل والكلمات والكلمات متعددة المقاطع، بحيث يمكنكم فحص أساس النتيجة. استخدموها لمقارنة المسودات، أو تحديد المستوى المناسب للجمهور، أو اكتشاف المعلومات التي صارت صعبة بلا داعٍ.

ما الذي تعنيه نتيجة SMOG

SMOG اختصار لعبارة Simple Measure of Gobbledygook، وهي معادلة لسهولة القراءة صممت لتقدير المستوى التعليمي اللازم لفهم النثر الإنجليزي. وتعتمد أساسا على عدد الكلمات متعددة المقاطع، أي الكلمات التي يقدّر أنها تتكون من ثلاثة مقاطع صوتية أو أكثر. تعدّل المعادلة هذا العدد وفقا لعدد الجمل، ثم تعبّر عن النتيجة في صورة مستوى دراسي تقريبي. فالنتيجة القريبة من ثمانية، مثلا، تشير إلى أن النص قد يناسب قارئا تلقى نحو ثماني سنوات من التعليم النظامي، بينما تدل النتيجة الأعلى بكثير على مفردات أكثر كثافة. تعاملوا مع الرقم بوصفه تقديرا لا ضمانا للفهم. فالمؤشر لا يعرف إن كان المصطلح التقني مألوفا لدى جمهوركم، ولا إن كانت التعليمات مرتبة منطقيا، ولا إن كانت الجملة تشرح فكرتها بوضوح. إنه يقيس سمات لغوية ظاهرة بطريقة ثابتة. لذلك يفيد خصوصا في مقارنة مراجعات الوثيقة نفسها، ومتابعة معيار تحريري، وتحديد المقاطع التي تستحق مراجعة بشرية. كما توضح الأعداد المساندة سبب تغير النتيجة بدلا من تقديم مستوى منفرد بلا تفسير.

كيف تحصي الحاسبة النص

تتعرف الحاسبة أولا على الجمل المنتهية بنقطة أو علامة استفهام أو علامة تعجب. ثم تستخرج الكلمات الإنجليزية وتقدّر مقاطع كل كلمة بقاعدة إملائية حتمية تعتمد على مجموعات حروف العلة والنهايات الصامتة الشائعة. وكل كلمة يقدّر أنها تحتوي على ثلاثة مقاطع أو أكثر تزيد عدد الكلمات متعددة المقاطع بواحد. تضرب معادلة SMOG العدد 1.043 في الجذر التربيعي لعدد الكلمات متعددة المقاطع مضروبا في 30 ومقسوما على عدد الجمل، ثم تضيف 3.1291. تقرّب النتيجة إلى منزلتين عشريتين، ويعرض أقرب عدد صحيح بوصفه سنوات التعليم المقدرة. لا يمكن توقع النطق دائما من الإملاء، ولذلك قد تختلف الأسماء والاختصارات والكلمات الدخيلة وغير المنتظمة عن عدّ القاموس. وتعالج الكلمات ذات الشرطة أو الفاصلة العليا وفقا لأجزائها المكتوبة. ولأن القواعد نفسها تعمل كل مرة من دون نموذج أو اتصال بالشبكة، تبقى المقارنات قابلة للتكرار. أرسلوا نثرا نظيفا لا شيفرة أو قوائم أو علامات تنسيق أو عناوين تنقل، لأن النص الدخيل يغيّر عدد الجمل والمفردات معا.

اختيار عينة مفيدة وتفسيرها بحذر

تكون طريقة SMOG الأصلية أكثر موثوقية مع عينة من ثلاثين جملة على الأقل، تؤخذ عادة من أجزاء مختلفة من الوثيقة. تستطيع الحاسبة تقدير مقطع أقصر، لكنها تعيد sample_recommended بالقيمة false حتى يبقى هذا القيد ظاهرا. تتأثر العينة القصيرة بشدة بكلمة طويلة واحدة أو بجملة إضافية، فلا تقارنوها كما لو كانت مستقرة بقدر العينة الكاملة. حافظوا على علامات نهاية الجمل المعتادة، لأن المعادلة تحتاج إلى عدد الجمل؛ ويرفض النص الذي لا يحتوي على جملة مكتملة بدلا من اختراع مقام للحساب. في سير عمل تحريري عملي، قيسوا المسودة، وراجعوا العبارات الطويلة أو المتخصصة غير الضرورية، ثم أعيدوا الحساب. احتفظوا بالمصطلحات اللازمة للدقة واشرحوها بالقرب منها بلغة واضحة. سهولة القراءة جزء واحد فقط من الإتاحة؛ فالبنية والطباعة والسياق والمعرفة السابقة وجودة الترجمة وصحة المعلومات عوامل مهمة أيضا. استخدموا المؤشر إشارة قابلة للتكرار، واجمعوا بينه وبين الاختبار البشري عندما تكون العواقب مهمة، وسجلوا العينة نفسها عند تتبع التغييرات بمرور الزمن.

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

مراجعة معلومات الصحة العامة

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

مقارنة المسودات المحررة

حللوا القسم نفسه قبل التحرير وبعده لمعرفة إن كان تقليل الكلمات متعددة المقاطع قد خفّض المستوى المقدر.

متابعة معيار للمحتوى

أضيفوا فحص SMOG حتميا إلى سير التحرير، وحددوا الوثائق التي تتجاوز عتبة المراجعة التي تعتمدها مؤسستكم.

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

ما معادلة SMOG لسهولة القراءة؟

هي 1.043 في الجذر التربيعي لعدد الكلمات متعددة المقاطع مضروبا في 30 ومقسوما على عدد الجمل، ثم يضاف 3.1291.

ما الكلمة التي تعد متعددة المقاطع؟

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

لماذا يوصى بثلاثين جملة؟

صمم SMOG لعينة من ثلاثين جملة. يمكن حساب مقطع أقصر، لكن كلمة معقدة واحدة تؤثر في تقديره بدرجة أكبر.

هل تثبت النتيجة أن كل قارئ في ذلك المستوى سيفهم النص؟

لا. فهي تقدّر الصعوبة اللغوية، ولا تقيس المعرفة السابقة أو وضوح الأفكار أو الدقة أو تصميم الوثيقة.

هل يمكن استخدامها مع لغات غير الإنجليزية؟

قاعدة تقدير المقاطع وتفسير النتيجة مخصصان للإنجليزية. ولا يمكن الاعتماد على نتائج اللغات الأخرى.

ما تكلفة واجهة API؟

تكلف كل مطالبة لواجهة API مقدار $0.002. ويمكن إجراء الحساب الحتمي نفسه مجانا في المتصفح.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/smog-index

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

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

curl -X POST https://api.kit.forhosting.com/str/smog-index \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Clear instructions help readers act. Complicated terminology can increase cognitive difficulty. Editors revise important documents carefully."}'

const res = await fetch("https://api.kit.forhosting.com/str/smog-index", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Clear instructions help readers act. Complicated terminology can increase cognitive difficulty. Editors revise important documents carefully."
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/smog-index",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Clear instructions help readers act. Complicated terminology can increase cognitive difficulty. Editors revise important documents carefully."
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/smog-index", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Clear instructions help readers act. Complicated terminology can increase cognitive difficulty. Editors revise important documents carefully."}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Clear instructions help readers act. Complicated terminology can increase cognitive difficulty. Editors revise important documents carefully."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/smog-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "Clear instructions help readers act. Complicated terminology can increase cognitive difficulty. Editors revise important documents carefully."
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

max_chars 100000

الأخطاء

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

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