بتل کد Battle Codeدارد باز می‌شود…

اسم نمادها ۲

نشانه‌های کوچکی که در نشانیِ سایت، مسیر فایل، اسم متغیر و دستورهای ترمینال می‌بینی. اسمشان را که بدانی، می‌توانی کد را برای کسی بخوانی یا درباره‌اش جست‌وجو کنی.

اسم + sign

sign یعنی «نشانه» و با چسباندنش به یک کلمه اسمِ نماد ساخته می‌شود: hash sign، at sign، equals sign، plus sign، dollar sign. در حرف زدن اغلب sign را می‌اندازند و فقط می‌گویند hash یا at.

هشت کلمه‌ی این درس

slash (اِسلَش): خط مورب /

slash در انگلیسی یعنی «بُرشِ تیز و اریب»؛ اسمِ این خطِ مورب هم از همان می‌آید: /. در حساب نشانه‌ی تقسیم است، در نشانیِ سایت و مسیر فایل (در لینوکس و مک) پوشه‌ها را از هم جدا می‌کند و در جاوااسکریپت دو تا پشت هم (//) کامنت می‌سازد. به آن forward slash هم می‌گویند.

The path must start with a slash.

مسیر باید با یک اسلش شروع شود.

backslash (بَک‌اِسلَش): خط مورب وارونه \

back یعنی «عقب» و backslash خطِ موربی است که به عقب خم شده: \. در رشته‌ها کلیدِ «نویسه‌های ویژه» است: ‎\n یعنی خط تازه و ‎\t یعنی یک تب. به این کار escape می‌گویند. در ویندوز هم پوشه‌های یک مسیر را از هم جدا می‌کند.

Use a backslash before the quote to escape it.

برای escape کردنِ کوتیشن، پیش از آن یک بک‌اسلش بگذار.

underscore (آندِراِسکُر): خط زیر _

under یعنی «زیر» و score یعنی «خط کشیدن»؛ underscore خطی است که زیرِ خطِ نوشتن می‌نشیند: _. چون در اسم متغیر نمی‌شود فاصله گذاشت، برنامه‌نویس‌ها کلمه‌ها را با آن به هم می‌چسبانند: user_name. به این سبک snake case می‌گویند و در پایتون رایج است.

Variable names can contain letters, digits and the underscore.

اسم متغیر می‌تواند حرف، رقم و خط زیر داشته باشد.

hash sign (هَش ساین): علامت #

hash sign اسمِ علامت # است؛ sign یعنی «نشانه». در پایتون و bash هر چه بعد از آن در خط بیاید کامنت است و اجرا نمی‌شود. در CSS رنگ‌ها (‎#ff0000) و idها با آن شروع می‌شوند و در Markdown تیتر می‌سازد. در آمریکا به آن pound sign یا number sign هم می‌گویند.

In Python, a comment starts with a hash sign.

در پایتون کامنت با علامت # شروع می‌شود.

asterisk (اَستِریسک): ستاره *

asterisk از کلمه‌ای یونانی به معنی «ستاره‌ی کوچک» می‌آید و اسمِ علامت * است. در کد نشانه‌ی ضرب است و دو تا پشت هم در پایتون یعنی توان. در جست‌وجوی فایل‌ها و در SQL هم یعنی «همه‌چیز»: ‎*.txt یعنی همه‌ی فایل‌های متنی. خیلی‌ها ساده‌تر به آن star می‌گویند.

Fields marked with an asterisk are required.

خانه‌هایی که ستاره دارند اجباری‌اند.

dash (دَش): خط تیره -

dash در انگلیسی یعنی «خط تیره». برنامه‌نویس‌ها به همان علامتِ - روی صفحه‌کلید می‌گویند که اسم‌های دیگرش hyphen (وقتی دو کلمه را به هم وصل می‌کند) و minus (وقتی منها می‌کند) است. در ترمینال، گزینه‌های یک دستور با یک یا دو dash شروع می‌شوند و در نشانی‌های وب کلمه‌ها را جدا می‌کند.

Type the command followed by a double dash and the option name.

دستور را بنویس و بعدش دو خط تیره و اسم گزینه را.

at sign (اَت ساین): علامت @

at در انگلیسی یعنی «در» (یک جا) و at sign اسمِ علامت @ است. در ایمیل یعنی «این آدم در این سرویس»: sara@example.com می‌شود sara at example dot com. در پایتون با آن decorator می‌نویسند و در شبکه‌های اجتماعی و گیت‌هاب با آن کسی را صدا می‌زنند (mention).

An email address must contain an at sign.

نشانیِ ایمیل باید علامت @ داشته باشد.

equals sign (ایکوِلز ساین): علامت مساوی =

equal یعنی «برابر» و equals sign اسمِ علامت = است. در ریاضی یعنی دو طرف برابرند، ولی در کد یک علامتِ = یعنی «مقدارِ سمت راست را در متغیرِ سمت چپ بگذار». برای پرسیدنِ «این دو برابرند؟» باید دو تا بنویسی: ==. جاوااسکریپت سه‌تایی هم دارد (===) که نوع را هم مقایسه می‌کند.

Use a double equals sign to compare two values.

برای مقایسه‌ی دو مقدار از دو علامت مساوی استفاده کن.

قرارهای اسم‌گذاریِ یک تیم

Naming rules for this project

- In Python files, use an underscore between words: high_score. Never use a dash there, because Python reads it as minus.
- In URLs, use a dash: example.com/high-scores. Always use a slash in URLs, not a backslash.
- Start every comment with a hash sign and one space.
- Do not write "from game import" with an asterisk. Import only the names you need.
- Put one space before and after an equals sign.

قرارهای اسم‌گذاریِ این پروژه

- در فایل‌های پایتون بینِ کلمه‌ها خط زیر بگذار: high_score. هیچ‌وقت آن‌جا خط تیره نگذار، چون پایتون آن را منها می‌خواند.
- در نشانی‌های وب خط تیره بگذار: example.com/high-scores. در نشانی‌ها همیشه اسلش بگذار، نه بک‌اسلش.
- هر کامنت را با علامت # و یک فاصله شروع کن.
- from game import را با ستاره ننویس. فقط اسم‌هایی را بیاور که لازم داری.
- پیش و پس از علامت مساوی یک فاصله بگذار.