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

ترقيم السطور ببداية وخطوة مخصصتين

يفيد الترقيم المخصص للأسطر عندما لا تكفي الزيادة المعتادة بمقدار واحد. ألصقوا فقرة أو قائمة أو مثالًا برمجيًا أو نص مقابلة أو مجموعة اقتباسات، ثم اختاروا رقم السطر الأول ومقدار تغير كل رقم بعده.

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

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

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

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

اختاروا قيمة بداية تناسب المستند المحيط

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

استخدموا الخطوة لإنشاء تسلسل غير متتابع

تُضاف الخطوة بعد كل سطر، فتمنحكم تحكمًا مباشرًا في تسلسل الترقيم. تنشئ الخطوة 1 أرقامًا متتابعة مألوفة، بينما تنتج الخطوة 5 الأرقام 10 و15 و20 وهكذا عندما تكون البداية 10. وتترك الفواصل الأكبر مساحة منطقية لمادة قد تضاف لاحقًا، وهو أمر مفيد في المواصفات والنصوص وملاحظات المراجعة. أما الخطوات السالبة فتنشئ مراجع تنازلية للعد العكسي أو للمقتطفات المرتبة عكسيًا. وتكرر الخطوة صفر الرقم نفسه عمدًا في كل سطر عندما تكون علامة القسم المشتركة أنسب من التسلسل. يجب أن تكون البداية والخطوة عددين صحيحين ضمن الحدود المنشورة؛ فقصرهما على الأعداد الصحيحة يمنع العلامات الكسرية غير المتوقعة ويسهّل الاستشهاد بالنتيجة. ويتحقق الخوارزم أيضًا قبل إخراج النتيجة من بقاء آخر قيمة مولدة ضمن مجال الأعداد الصحيحة الآمنة. تحافظ هذه القواعد على حتمية المدخلات الطويلة وتمنع التقريب العددي الصامت، سواء عملت القدرة في المتصفح أم ضمن سير API آلي.

انسخوا نتيجة ثابتة إلى الاقتباسات والقوائم والمراجعات

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

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

متابعة قائمة شفرة برمجية

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

إعداد بنود مواصفات متباعدة

رقّموا المتطلبات بخطوات مثل عشرة حتى يمكن إدراج بنود لاحقة بين المراجع القائمة.

إنشاء نصوص جاهزة للاقتباس

طبقوا علامات متسقة على كل سطر، بما في ذلك الأسطر الفارغة المقصودة، قبل مشاركة المقتطف.

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

ما تكلفة الطلب الواحد؟

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

هل يمكن أن يكون الترقيم تنازليًا؟

نعم. استخدموا عددًا صحيحًا سالبًا للخطوة، مثل -1 أو -10.

هل يمكن أن يحمل كل سطر الرقم نفسه؟

نعم. تكرر الخطوة صفر قيمة البداية في كل سطر.

هل تُحذف الأسطر الفارغة؟

لا. تُحفظ وتُرقّم، بما فيها السطر الفارغ الأخير الناتج عن نهاية سطر ختامية.

هل تغير الأداة نهايات الأسطر؟

تُوحّد نهايات CRLF وCR إلى LF لكي تكون النتيجة متسقة بين المنصات.

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/str/enumerate-lines-custom

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

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

curl -X POST https://api.kit.forhosting.com/str/enumerate-lines-custom \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"First reference\nSecond reference\nThird reference"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/enumerate-lines-custom",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "First reference\nSecond reference\nThird reference"
},
)
task_id = res.json()["task_id"]

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

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

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

{
  "text": "First reference\nSecond reference\nThird reference"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`max_chars`	100000
`max_lines`	10000
`max_separator_chars`	32

الأخطاء

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

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