محتوا و لحن

اصل کلی

پرتو یک ابزار حرفه‌ای است. لحن آن باید رسمی، واضح، و محترمانه باشد — نه رسمی و خشک، نه غیررسمی و صمیمی.

رسمی در برابر غیررسمی

اعداد و تاریخ

اعداد

ارقام فارسی از ویژگی ss01 فونت می‌آیند، نه از کد. شما رقم لاتین می‌نویسید و کاربر فارسی می‌بیند.

✓  ۱,۲۳۴,۵۶۷ دنبال‌کننده        ← این را می‌نویسید: formatNumber(1234567)
✓  نرخ تعامل: ۳.۲٪
✗  ۱٬۲۳۴٬۵۶۷ دنبال‌کننده        ← جداکنندهٔ فارسی «٬» خودبه‌خود نمی‌آید

تاریخ

از تاریخ شمسی استفاده کنید:

✓  ۱۵ اسفند ۱۴۰۲
✓  ۱۵/۱۲/۱۴۰۲
✗  March 5, 2024

بازه زمانی

✓  ۳۰ روز گذشته
✓  از ۱ فروردین تا ۳۱ فروردین
✗  Last 30 days

نوشتار فارسی — قواعدی که این صفحه خودش رعایت می‌کند

این بخش تا امروز نانوشته بود، درحالی‌که همین فایل هجده نیم‌فاصله دارد: قاعده اجرا می‌شد و هرگز گفته نمی‌شد.

نیم‌فاصله

نیم‌فاصله (U+200C) بین جزءهای یک واژه می‌آید، نه فاصلهٔ کامل و نه چسبیده:

✓  دنبال‌کننده · می‌شود · نمی‌توان · بسته‌بندی
✗  دنبال کننده · میشود · نمی توان

در ویرایشگر با Ctrl+Shift+2 یا Shift+Space تایپ می‌شود. بدون آن، هم شکسته‌نویسی خراب می‌شود و هم جستجوی درون‌متنی نتیجهٔ متفاوتی می‌دهد.

رقم فارسی، نه رقم عربی

دو خانوادهٔ رقم در یونی‌کد هست و شبیه هم دیده می‌شوند:

فارسی را به کار ببرید. این نکته اینجا اهمیت دارد چون دیزاین‌سیستم یک locale عربی هم دارد و مخلوط‌شدنشان در یک متن، هم زشت است و هم جستجو را می‌شکند.

واحدها و علامت‌ها

✓  ۳.۲٪ · ۱۲ گیگابایت · ۴۵ ثانیه
✗  3.2% · ۱۲GB · ۴۵s

علامت درصد فارسی ٪ است، نه %. پسوند لاتین را روی رقم فارسی نگذارید — نه M، نه GB، نه s. واحد را فارسی بنویسید.

حروف بزرگ در اصطلاح لاتین

اصطلاح لاتینِ داخل متن فارسی را همان‌طور بنویسید که خودش نوشته می‌شود:

✓  React · TypeScript · CSS Variables · API
✗  react · Typescript · css variables

نام محصول و نام استاندارد، حرف بزرگشان را نگه می‌دارند؛ واژهٔ عمومی نه.

علائم سجاوندی در متن راست‌به‌چپ

✓  ویرگول فارسی «،» و پرسش «؟» — و نقل‌قول با «گیومه»
✗  ویرگول لاتین "," و نقل‌قول با "دابل کوت"

نیم‌ویرگول فارسی ؛ و ویرگول فارسی ، جهت‌دارند و در متن RTL درست می‌نشینند؛ معادل لاتینشان یک قطعهٔ LTR می‌سازد که مکان‌نما و انتخاب متن را بهم می‌ریزد.

برچسب‌های رابط کاربری

دکمه‌ها

دکمه‌ها باید فعل باشند، نه اسم:

استثنا: دکمه‌های کوتاه و مشخص مثل «ذخیره»، «انصراف»، «ارسال» بدون فعل هم قابل قبول هستند اگر از context واضح باشد.

برچسب‌های فیلد (Label)

برچسب فیلد باید اسم باشد:

✓  نام کاربری
✓  آدرس ایمیل
✓  شماره تلفن
✗  نام کاربری خود را وارد کنید

Placeholder

✓  مثال: ali.ahmadi@gmail.com
✓  جستجو در اینفلوئنسرها...
✗  لطفاً ایمیل خود را وارد کنید (این کار label است، نه placeholder)

پیام‌های وضعیت

موفقیت

✓  تغییرات ذخیره شد
✓  کمپین با موفقیت ایجاد شد
✓  اینفلوئنسر به لیست اضافه شد

خطا

✓  این فیلد اجباری است
✓  آدرس ایمیل نامعتبر است
✓  اتصال به سرور برقرار نشد. لطفاً دوباره تلاش کنید.
✗  مقدار null است
✗  خطای ۴۰۴

تأیید (دیالوگ حذف)

✓  آیا از حذف این کمپین اطمینان دارید؟ این عملیات قابل بازگشت نیست.
✗  آیا مطمئنی؟

Microcopy

tooltip

✓  نرخ تعامل = (لایک + کامنت + ذخیره) ÷ دنبال‌کننده
✗  engagement rate

placeholder جستجو

✓  جستجو در اینفلوئنسرها...
✓  نام کاربری، نام، یا هشتگ

متن تأیید (confirm)

✓  بله، حذف کنید
✓  انصراف
✗  OK
✗  Cancel

اصطلاحات دامنه

این‌ها یک‌دست نیستند و فرقشان مهم است: آنچه حکم شده و ماشین اجرایش می‌کند، در برابر آنچه قرارداد رایج است و هنوز حکمی ندارد.

حکم‌شده — گیت اجبار می‌کند

این‌ها در terminology.json ثبت شده‌اند و check-terminology در CI مترادفشان را رد می‌کند. اسلش اینجا مجاز نیست: هر مدخل دقیقاً یک صورت درست دارد.

صورت‌هایی که گیت رد می‌کند: «ذکر» و «اشاره» به‌جای منشن، و «فالوور» به‌جای دنبال‌کننده.

قرارداد رایج — هنوز حکم ندارد

این‌ها را یکنواخت نگه دارید، ولی گیتی پشتشان نیست و اگر جایی صورت دیگری دیدید، خطا نیست:

خلاصه

• لحن رسمی (شما، نه تو)
• دکمه‌ها فعل، label ها اسم
• خطاها قابل اقدام و بدون اصطلاح فنی
• ارقام از فونت می‌آیند نه از کد؛ تاریخ شمسی
• «منشن» و «دنبال‌کننده» حکم‌شدهاند و گیت دارند؛ بقیهٔ جدول قرارداد است

صفحات مرتبط

• الگوهای فرم — پیاده‌سازی label، placeholder، و خطا
• الگوهای خطا — نوشتن پیام خطا در context های مختلف
• مفاهیم دامنه — اصطلاحات تخصصی سوشال لیسنینگ