ForHosting KIT · النصوص والذكاء الاصطناعي

إضافة أرقام الأسطر

ضع رقمًا أمام كل سطر من الشيفرة أو السجلات أو الأغاني أو الملاحظات: تصبح alpha وbeta وgamma هي 1. alpha و2. beta و3. gamma. واختر فاصلك أو رقم البداية لمتابعة قائمة سابقة. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

النص: alpha beta gamma

تحصل على

المُدخل: alpha beta gamma
الفاصل: .
البداية: 1
عدد الأسطر: 3

تحوّل أداة إضافة أرقام الأسطر لصقًا خامًا من الشيفرة أو السجلات أو الكلمات أو الملاحظات إلى قائمة مرقّمة مستقرة يمكن مشاركتها في التذاكر والواجبات والمراجعات. أدخل أي سلسلة غير فارغة بسطر واحد أو عدة أسطر؛ توحّد الأداة نهايات أسطر Windows وMac الكلاسيكي، وتقسم عند كل فاصل سطر، وتضيف بادئة لكل مقطع بعدد صحيح متسلسل زائد الفاصل المختار—افتراضيًا نقطة ومسافة ليظهر الأسلوب المألوف 1. دون إعداد إضافي. يتيح start الاختياري متابعة قائمة من صفر أو واحد أو أي عدد صحيح ضمن النطاق المنشور. يحتاج المطوّرون والمعلمون ووكلاء الدعم ومسارات المحتوى نفس الترقيم الحتمي دون فتح IDE كامل.

كيف يعمل الترقيم المتسلسل للأسطر

ترقيم الأسطر من أقدم مساعدات القراءة في البرمجة والكتابة التقنية: يحصل كل سطر مرئي على تسمية عدد صحيح حتى يشير الناس إلى «السطر 17» دون اقتباس نصف المستند. تنفّذ هذه القدرة تلك القاعدة اليومية على نص عادي لا صفحات PDF أو فقرات معالج كلمات. أولًا يُفحص الإدخال: غياب text أو قيمة غير سلسلة أو سلسلة فارغة بعد قص المسافات تُرفض حتى لا تبدو اللصقات الفارغة نجاحًا.

تُوحَّد النهايات بحيث يصبح Windows CRLF وMac القديم CR وUnix LF شكل LF واحدًا قبل التقسيم. يقسم المقسم السلسلة عند كل LF؛ كل مقطع ناتج—بما فيه المقاطع الفارغة بين نهايات متتالية—سطر واحد ويحصل على رقمه. الرقم الأول هو قيمة start الصحيحة (الافتراض واحد)، وكل سطر تالٍ يزيد بواحد.

بين الرقم ومحتوى السطر الأصلي تُدرج الأداة سلسلة separator التي تكون افتراضيًا نقطة متبوعة بمسافة لتُقرأ المخرجات كقائمة مرقّمة كلاسيكية. يمكن تمرير فاصل مختلف مثل نقطتين ومسافة أو قوس إغلاق أو أنبوب أو علامة شبيهة بالتبويب ما دام الفاصل ضمن حد الأحرف المنشور. عندما تحتاج إجماليات فقرات بدل تسميات لكل سطر استخدم عدّاد فقرات بالأسطر الفارغة؛ وعندما تحتاج أختام صفحات PDF استخدم قدرة ترقيم صفحات PDF.

هذه الصفحة فقط عن بادئة أرقام متسلسلة على أسطر نص عادي.

نصائح عملية وحدود ومتى تستخدم هذه الأداة

استخدم هذه القدرة عندما تكون نية البحث إضافة أرقام أسطر أو ترقيم أسطر عبر الإنترنت أو ترقيم متسلسل لأسطر نص عادي. الصق مقتطف شيفرة أو مستخرج سجل أو قصيدة أو قائمة تحقق، حوّل مرة واحدة، وضع الكتلة المرقّمة في تذكرة أو بريد أو نموذج ملاحظات طالب. ضع في الحسبان نهايات الأسطر الأخيرة المقصودة: LF نهائي ينشئ مقطعًا أخيرًا فارغًا يحصل مع ذلك على رقم، بما يطابق تعامل محررات كثيرة مع نهايات الملف.

الأسطر المفردة الطويلة جدًا ما زالت تُحسب سطرًا واحدًا لكل منها؛ الأداة لا تلتف حسب عرض الأحرف. تُرقَّم مصادر HTML وMarkdown كسلاسل خام؛ أزل الترميز أولًا إن أردت أسطر نثر مرئية فقط. هذه الصفحة ليست ختم صفحة PDF ولا عدّاد فقرات ولا عدّاد كلمات أو أحرف ولا أداة diff تخترع hunks.

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

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

مراجعة الشيفرة وتقارير الأخطاء

الصق تتبع مكدس أو مقتطفًا، أضف أرقام أسطر مستقرة، واستشهد بـ «السطر 12» في التذاكر دون مشاركة مستودع كامل.

إعداد الواجبات وأوراق العمل

يُرقّم المعلمون أبيات القصائد أو قوائم التمارين حتى يجيب الطلاب برقم السطر في الاختبارات والأوراق.

مقتطفات سجل لتسليمات الدعم

يُرقّم وكلاء الدعم لصقات سجل متعددة الأسطر قبل التصعيد حتى يشير المهندسون إلى السطر الفاشل بدقة.

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

كيف تُعرَّف الأسطر؟

بعد توحيد CRLF وCR إلى LF يُقسَّم النص عند كل LF. كل مقطع—بما فيه الفارغ بين نهايات متتالية—يحصل على رقم متسلسل.

هل يمكنني تغيير الفاصل أو رقم البداية؟

نعم. مرّر separator (الافتراض ". ") وstart (الافتراض 1). يجب أن يكون start عددًا صحيحًا من 0 إلى 1,000,000؛ الفاصل محدود بـ 32 حرفًا.

هل يرقّم صفحات PDF؟

لا. يرقّم فقط أسطر نص عادي. استخدم أداة ترقيم صفحات PDF عندما تحتاج أختامًا على صفحات PDF.

هل تحصل الأسطر الفارغة على رقم أيضًا؟

نعم. يُرقَّم كل سطر فارغ بين فاصلي أسطر، فتتطابق الأرقام مع ما تراه في المحرر. كما يضيف فاصل الأسطر في آخر النص سطرًا أخيرًا فارغًا مرقّمًا.

هل تُعامَل فواصل الأسطر في ويندوز وماك بالطريقة نفسها؟

نعم. تُوحَّد فواصل ويندوز وماك القديم ويونكس قبل الترقيم، فيعطي الملف نفسه الترقيم نفسه أيًّا كان النظام الذي أُنشئ عليه.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/number-lines

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

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

curl -X POST https://api.kit.forhosting.com/str/number-lines \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"alpha\nbeta\ngamma"}'

const res = await fetch("https://api.kit.forhosting.com/str/number-lines", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "alpha\nbeta\ngamma"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/number-lines",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "alpha\nbeta\ngamma"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/number-lines", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"alpha\\nbeta\\ngamma"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"alpha\nbeta\ngamma"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/number-lines", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "text": "alpha\nbeta\ngamma"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_chars`	100000
`max_separator_chars`	32

الأخطاء

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

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

تُرفض المدخلات الفارغة أو المسافات فقط بخطأ واضح invalid_input حتى لا تعامل الأتمتة نموذجًا فارغًا كملف ناجح بصفّر أسطر. المسار منطق سلسلة خالص—بلا شبكة ولا بذور عشوائية ولا اعتماد على الساعة—لذلك يعيد المشغّل المجاني في المتصفح وواجهة API المدفوعة مسبقًا نفس JSON في كل استدعاء.

كيف تستدعي API وما تحتويه الاستجابة

يُفضَّل إرسال جسم المستند الخام بنهايات أسطره الحقيقية بدل دمج كل شيء سلفًا في سطر واحد عندما تريد تسميات متعددة الأسطر حقيقية. أرسل جسم JSON بحقل سلسلة مطلوب text (أسماء بديلة input وvalue وstring وs وcontent وbody). اختياريًا ضمّن separator (أسماء sep وdelimiter) كسلسلة بحد أقصى اثنين وثلاثين حرفًا، وstart (أسماء from وoffset وbegin) كعدد صحيح بين صفر ومليون شاملًا. يجب أن تكون قيمة text غير فارغة بعد قص المسافات وألا تتجاوز مئة ألف حرف حتى لا يستنزف طلب واحد ذاكرة Worker أو المتصفح بلصقات ضخمة. عند النجاح تعيد الاستجابة input كالسلسلة الأصلية وtext كسلسلة العمل المقصوصة وseparator وstart كخيارات الترقيم الفعلية وline_count كعدد المقاطع المرقّمة وlines كمصفوفة مرتبة من سلاسل الأسطر ذات البادئة الكاملة وnumbered كتلك الأسطر مربوطة بـ LF وmessage كملخص قصير يبلغ بعدد الأسطر المرقّمة ومع أي start وseparator. فشل التحقق—غياب text أو قيمة غير سلسلة أو حمولة زائدة أو محتوى فارغ بعد القص أو separator غير سلسلة أو طويل جدًا أو start غير عدد صحيح أو خارج النطاق—يعيد invalid_input ولا يُحاسب أبدًا. التسعير مبلغ ثابت $0.002 لكل طلب ناجح بوحدة item وسعر هامشي صفري. عند الدمج أكّد على numbered أو lines للقائمة الكاملة وعلى line_count للإجمالي، وعامل invalid_input كخطأ عميل لإرسالات النماذج الفارغة لا كحدث فوترة.

نصائح عملية وحدود ومتى تستخدم هذه الأداة

فحوصات الذهاب والإياب للاختبارات سهلة: غذِّ ثلاثة أسطر قصيرة مفصولة بـ LF وتوقّع line_count ثلاثة مع بادئات من واحد والفاصل الافتراضي؛ غيّر start إلى عشرة وتوقّع عشرة وأحد عشر واثني عشر؛ أرسل عمدًا سلسلة فارغة أو مسافات لتأكيد invalid_input والرسالة التي تطلب سلسلة غير فارغة. المهام الفاشلة التي تعيد invalid_input لا تستهلك الرصيد المدفوع مسبقًا، مما يبقي تحقق النماذج واختبارات CI السلبية رخيصة.

أسئلة تقنية

ماذا يحدث عند إدخال فارغ؟

غياب text أو قيم غير سلسلة أو سلاسل فارغة بعد القص تعيد invalid_input ولا تُحاسب أبدًا.

هل أداة أرقام الأسطر مجانية؟

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

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

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

مثال محلول

كيف يعمل الترقيم المتسلسل للأسطر

نصائح عملية وحدود ومتى تستخدم هذه الأداة

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

مراجعة الشيفرة وتقارير الأخطاء

إعداد الواجبات وأوراق العمل

مقتطفات سجل لتسليمات الدعم

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

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

كيف تستدعي API وما تحتويه الاستجابة

نصائح عملية وحدود ومتى تستخدم هذه الأداة

أسئلة تقنية

شكرًا