يستبدل الشرطات السفلية في أسماء snake_case بشرطات: output_dir → output-dir. الأسماء الصغيرة الموصولة بشرطات هي القاعدة في خيارات سطر الأوامر الطويلة ومسارات الروابط وأسماء موارد Kubernetes وأسماء حزم npm وأصناف CSS، ولا يستخدم أيٌّ منها الشرطات السفلية عرفًا.
من الحالات الشائعة سكربت Python كُتبت خيارات argparse أو مفاتيح إعداداته بشرطات سفلية ويحتاج الآن إلى الصيغة المعتادة --flag-name، أو معرّفات قاعدة بيانات يجب أن تظهر في الروابط.
نص السلسلة، واحدًا في كل سطر أو ضمن السطر.النتيجة.--dry_run
--output_dir dist
--max_workers 4--dry-run
--output-dir dist
--max-workers 4يحصل كل اسم خيار على شرطات، ويُحتفظ بـ -- في البداية وبالقيمتين dist و4. في argparse يُقرأ --dry-run على أنه args.dry_run، فلا يتغير شيء على جانب Python.
max_workers → max-workers، address_line_2 → address-line-2.-- أو / أو ?page=._internal_id → internal-id.يقبل argparse وclick الخيار --output_dir، لكن المستخدمين يتوقعون --output-dir. تحويل قائمة الخيارات وتحديث استدعاءات add_argument يُبقي أسماء السمات (output_dir) كما هي.
رموز التصنيفات مثل gift_cards أو order_history المخزنة في جدول يمكن تحويلها إلى المسارين /gift-cards و/order-history، وهو الأسلوب الأكثر شيوعًا للروابط العامة.
__version__، لا تُطابَق وتحتفظ بشرطاتها السفلية.add_argument والكلمات المفتاحية مثل store_true، ما يُفسد الكود. الصق الأسماء فقط.لا. kebab-case مخصص للسلاسل النصية مثل الخيارات والروابط وأسماء الملفات وأسماء الموارد؛ أبقِ متغيرات Python بصيغة snake_case.
تسمح أسماء Kubernetes بالأحرف الصغيرة والأرقام والشرطات، وهذا بالضبط ما تنتجه الأداة من مدخلات snake_case العادية، بما فيها المقاطع الرقمية.