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

ربط‌های پیشرفته

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

بعد از هر ربط چه می‌آید؟

بعضی ربط‌ها اسم می‌خواهند: according to the docs، due to an error. بعضی جمله‌ی کامل: as long as it works، even though it fails، in case it breaks، so that we can test. in order to هم فعل ساده: in order to run. اگر بعد از due to جمله آوردی، جایش because بگذار.

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

in order to (این اُردِر تو): برای این‌که، به‌منظورِ

in order to + فعل ساده یعنی «برای این‌که این کار انجام شود»؛ هدف یک کار را می‌گوید: In order to run the app, you need Node.js. همان to تنهاست ولی رسمی‌تر و روشن‌تر، و در مستندات زیاد است. order این‌جا یعنی ترتیب و نظم، نه سفارش؛ معنی کلمه‌به‌کلمه گمراهت نکند.

In order to use the API, you need a free key.

برای استفاده از این API یک کلید رایگان لازم داری.

as long as (اَز لانگ اَز): به شرطِ این‌که، تا وقتی که

معنی کلمه‌به‌کلمه‌اش «به درازیِ» است، ولی as long as + جمله یعنی «به شرطی که» یا «تا وقتی که»: The app works as long as you are online. مثل if یک شرط می‌گوید، با این حس که «اگر فقط همین برقرار باشد، مشکلی نیست». مثل حلقه‌ی while در کد: تا وقتی شرط درست است، ادامه بده.

You can use any name as long as it starts with a letter.

هر اسمی می‌توانی بگذاری، به شرطی که با یک حرف شروع شود.

even though (ایوِن ذُو): با این‌که، هرچند

even یعنی «حتی» و though یعنی «اگرچه». even though + جمله یعنی «با این‌که این درست است، باز…» و تضاد را قوی‌تر از although نشان می‌دهد: Even though the code looks right, it fails. در گزارش باگ خیلی به کار می‌آید، چون می‌گوید چیزی برخلاف انتظار رخ داده است.

The test fails even though I didn't change anything.

تست شکست می‌خورد، با این‌که من چیزی را عوض نکرده‌ام.

rather than (رَذِر ذَن): به‌جای، به‌جای این‌که

rather یعنی «ترجیحاً» و rather than یعنی «به‌جایِ»؛ دو انتخاب را کنار هم می‌گذارد: یکی را می‌خواهی، نه دیگری را. بعدش یا اسم می‌آید (use a dict rather than a list) یا فعل با ‎-ing یا ساده (rather than copying the code, write a function). در توصیه‌های مستندات و بازبینی کد زیاد است.

Use a function rather than copying the same code three times.

به‌جای این‌که یک کد را سه بار کپی کنی، یک تابع بنویس.

according to (اَکوردینگ تو): طبقِ، به گفته‌ی

according to + اسم یعنی «بر اساس چیزی که این منبع می‌گوید»: according to the docs، according to the error message. با آن نشان می‌دهی حرفت از کجا آمده است. در گزارش‌ها و جواب‌های انجمن خیلی می‌بینی. بعدش اسم یا ضمیر می‌آید، نه جمله.

According to the docs, this method is deprecated.

طبق مستندات، این متد منسوخ شده است.

due to (دو تو): به‌خاطرِ، به دلیلِ

due to + اسم یعنی «به علتِ»؛ دلیل یک اتفاق را می‌گوید و در پیام‌ها و اطلاعیه‌های رسمی خیلی رایج است: The site is down due to maintenance. بعدش اسم می‌آید، نه جمله؛ برای جمله because به کار می‌رود. due به‌تنهایی یعنی «موعد»: the homework is due Friday.

The build failed due to a missing dependency.

ساخت به‌خاطر یک وابستگی جاافتاده شکست خورد.

in case (این کِیس): محض احتیاط، اگر احیاناً

case یعنی مورد یا موقعیت. in case + جمله یعنی «برای این‌که اگر این اتفاق افتاد، آماده باشی»: Make a backup in case something goes wrong. فرقش با if: با if فقط وقتی اتفاق افتاد کاری می‌کنی؛ با in case از قبل آماده می‌شوی. in case of + اسم رسمی‌تر است: in case of error.

Save a copy of the file in case the update breaks something.

محض احتیاط یک نسخه از فایل نگه دار، اگر به‌روزرسانی چیزی را خراب کرد.

so that (سُو ذَت): تا این‌که، برای این‌که (هدف)

so that + جمله یعنی «برای این‌که این نتیجه به دست بیاید». مثل in order to هدف را می‌گوید، ولی بعدش یک جمله‌ی کامل با فاعل می‌آید: Add comments so that others can understand your code. معمولاً can، will یا could در جمله‌ی بعدش هست. در گفت‌وگو گاهی that می‌افتد: so others can read it.

Write clear names so that your teammates understand the code.

اسم‌های روشن بنویس تا هم‌تیمی‌هایت کد را بفهمند.

بخش نصب یک README

Setup
In order to run this project, you need Python 3.10 or newer. According to our tests, older versions fail due to missing features.
Create a virtual environment so that the packages don't mix with your other projects. You can use any folder name as long as it has no spaces.
Keep a copy of your settings file in case the installer changes it. We use JSON rather than YAML for settings, even though YAML is shorter.

راه‌اندازی
برای اجرای این پروژه به پایتون ۳.۱۰ یا جدیدتر نیاز داری. طبق تست‌های ما، نسخه‌های قدیمی‌تر به‌خاطر نبودِ چند امکان شکست می‌خورند.
یک محیط مجازی بساز تا بسته‌ها با پروژه‌های دیگرت قاطی نشوند. هر اسمی برای پوشه می‌توانی بگذاری، به شرطی که فاصله نداشته باشد.
محض احتیاط یک نسخه از فایل تنظیماتت نگه دار، اگر نصب‌کننده آن را عوض کرد. ما برای تنظیمات به‌جای YAML از JSON استفاده می‌کنیم، با این‌که YAML کوتاه‌تر است.