فعلهای مستندات ۲
این فعلها میگویند یک ابزار چه کاری را ممکن میکند، جلوی چه چیزی را میگیرد، سازندهها چه توصیهای دارند و چه چیزی را از قبل درست فرض کردهاند.
بعد از این فعلها: to یا ing؟
هر فعل الگوی خودش را دارد. allow با to میآید: «allows you to save». avoid و recommend با ing: «avoid using»، «we recommend installing». prevent با from و ing: «prevents the app from crashing». ensure و assume با that و یک جملهی کامل: «ensure that the file exists». اینها را با همان الگویشان یاد بگیر، نه تنها.
هشت کلمهی این درس
allow (اَلاو): اجازه دادن؛ ممکن کردن
allow یعنی اجازه دادن. در مستندات بیشتر به معنی «ممکن کردن» است. الگوی اصلی: «X allows you to do Y» یعنی «X این امکان را میدهد که Y را انجام دهی». شکل مجهولش در قانونها و خطاها میآید: «Spaces are not allowed» یعنی فاصله مجاز نیست.
This option allows you to change the default port.
این گزینه به تو امکان میدهد درگاه پیشفرض را عوض کنی.
prevent (پریوِنت): جلوگیری کردن
prevent یعنی «نگذاشتن که چیزی اتفاق بیفتد». الگوی جمله: «X prevents Y from doing Z» یعنی «X نمیگذارد Y کار Z را بکند». در مستندات وقتی میآید که یک تنظیم یا یک بررسی جلوی خطا، از دست رفتن داده یا کار ناخواسته را میگیرد. برعکسِ allow است.
This check prevents users from submitting the form twice.
این بررسی نمیگذارد کاربرها فرم را دو بار بفرستند.
ensure (اینشور): مطمئن شدن؛ تضمین کردن
sure یعنی «مطمئن» و ensure یعنی «کاری کردن که حتماً بشود». در مستندات دو جور میآید. دستور به تو: «Ensure that the file exists» یعنی «مطمئن شو که فایل وجود دارد». توضیح یک ابزار: «This ensures that the data is saved» یعنی «این کار تضمین میکند که داده ذخیره شود». سادهترش make sure است.
Ensure that Python is installed before you run the script.
قبل از اجرای اسکریپت، مطمئن شو که پایتون نصب است.
avoid (اَوُید): دوری کردن از؛ انجام ندادن
avoid یعنی «از چیزی دوری کردن». در مستندات یک توصیهی منفی و مؤدبانه است: «Avoid using global variables» یعنی «تا میتوانی از متغیر سراسری استفاده نکن». ممنوع نیست، ولی راه بهتری هست. جملهی دیگرش «to avoid errors» است، یعنی «برای اینکه به خطا نخوری».
Avoid using spaces in file names.
در اسم فایلها از فاصله استفاده نکن.
support (ساپورت): پشتیبانی کردن؛ از پسِ چیزی برآمدن
support یعنی پشتیبانی کردن. وقتی مستندات میگوید «X supports Y» یعنی «X میتواند با Y کار کند»: «This browser supports dark mode»، «The library supports Python 3.9 and later». اگر چیزی support نشود، یا کار نمیکند یا کسی قول نداده که کار کند. اسمش هم همین شکل است: «customer support» یعنی پشتیبانی مشتری.
This library supports Python 3.9 and later.
این کتابخانه از پایتون ۳٫۹ و نسخههای بعد از آن پشتیبانی میکند.
recommend (رِکِمِند): توصیه کردن؛ پیشنهاد کردن
recommend یعنی «به کسی گفتن که این راه بهتر است». سازندهها با این فعل میگویند خودشان کدام راه را بهتر میدانند: «We recommend using a virtual environment». اجباری نیست، ولی معمولاً دلیلی پشتش هست. شکلهای دیگرش: «the recommended way» (راه توصیهشده) و «It is recommended to…».
We recommend using the latest stable version.
توصیه میکنیم از آخرین نسخهی پایدار استفاده کنی.
expect (ایکسپِکت): انتظار داشتن
expect یعنی «منتظر چیزی بودن». در مستندات یعنی تابع فقط با ورودی مشخصی درست کار میکند: «This function expects a list» یعنی باید به آن فهرست بدهی. در خطاها شکل expected را میبینی: «expected a string, got an integer» یعنی رشته میخواستم، عدد دادی. در تستنویسی هم expect اسم یک تابع معروف است.
The function expects a date in the format YYYY-MM-DD.
این تابع یک تاریخ با قالب YYYY-MM-DD انتظار دارد.
assume (اَسوم): فرض کردن
assume یعنی «چیزی را بدون بررسی، درست گرفتن». مستندات اینطور میگویند که چه چیزهایی را از قبل درست فرض کردهاند: «This guide assumes that you know basic Python» یعنی اگر پایتون مقدماتی بلد نیستی، این راهنما برایت سخت است. دربارهی کد هم میآید: «The function assumes the list is sorted» یعنی خودش بررسی نمیکند؛ اگر مرتب نباشد جواب غلط میگیری.
This tutorial assumes that you have Node.js installed.
این آموزش فرض میکند که Node.js را نصب کردهای.
ذخیرهی خودکار
Auto-save
The editor supports auto-save. This feature allows you to work without pressing Ctrl+S, and it prevents you from losing your work when the power goes out.
Auto-save assumes that the file already has a name. To ensure that nothing is lost, save a new file once by hand.
We recommend an interval of 30 seconds. Avoid very short intervals, such as one second, because they make the editor slow.
The interval setting expects a number in seconds.
ذخیرهی خودکار
این ادیتور از ذخیرهی خودکار پشتیبانی میکند. این قابلیت به تو امکان میدهد بدون زدن Ctrl+S کار کنی و نمیگذارد با رفتن برق کارت از دست برود.
ذخیرهی خودکار فرض میکند که فایل از قبل اسم دارد. برای اینکه مطمئن شوی چیزی از دست نمیرود، فایل تازه را یک بار دستی ذخیره کن.
فاصلهی ۳۰ ثانیه را توصیه میکنیم. از فاصلههای خیلی کوتاه، مانند یک ثانیه، دوری کن، چون ادیتور را کند میکنند.
تنظیم interval یک عدد بر حسب ثانیه انتظار دارد.