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

فعل‌های مستندات ۱

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

جمله‌ی موصولی: the value that…

مستندات برای دقیق کردن یک اسم، بعدش یک تکه جمله با that یا which می‌آورند: «the file that you specify» یعنی «فایلی که مشخص می‌کنی» و «a number that represents the age» یعنی «عددی که نشان‌دهنده‌ی سن است». گاهی that و فعل را به یک ing کوتاه می‌کنند: «a list containing the names» همان «a list that contains the names» است.

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

specify (اِسپِسیفای): مشخص کردن؛ دقیق گفتن

specify یعنی چیزی را دقیق و روشن گفتن. در مستندات یعنی «مقدارش را خودت بده». الگوهای پرتکرار: «If you do not specify X, …» یعنی «اگر X را مشخص نکنی، …» و «the specified file» یعنی «همان فایلی که مشخص کرده‌ای». هر وقت این فعل را دیدی، بدان درباره‌ی چیزی حرف می‌زنند که انتخابش با توست.

You can specify the encoding when you open the file.

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

provide (پرُوایْد): فراهم کردن؛ دادن

provide یعنی «فراهم کردن و در اختیار گذاشتن». در مستندات دو جور می‌آید. یکی از طرف ابزار: «This module provides functions for…» یعنی این ماژول تابع‌هایی برای فلان کار به تو می‌دهد. یکی از طرف تو: «You must provide an API key» یعنی باید کلید را بدهی. شکل مجهولش هم زیاد است: «if no value is provided».

The math module provides functions for common calculations.

ماژول math تابع‌هایی برای محاسبه‌های رایج فراهم می‌کند.

contain (کِنتِین): در خود داشتن؛ شامل بودن

contain یعنی «چیزی را درون خود داشتن»، مثل جعبه‌ای که داخلش کتاب است. در مستندات می‌گویند «The list contains three items» یا «a string containing the file name». در خطاها هم هست: «must not contain spaces» یعنی نباید فاصله داشته باشد. container (ظرف) هم از همین فعل ساخته شده است.

The response contains a list of all users.

پاسخ، فهرستی از همه‌ی کاربرها را در خود دارد.

represent (رِپریزِنت): نشان‌دهنده‌ی چیزی بودن؛ نماینده بودن

represent یعنی «نماینده‌ی چیزی بودن». در برنامه‌نویسی هیچ چیز واقعی درون کامپیوتر نیست: یک عدد نماینده‌ی سن است، یک شیء نماینده‌ی کاربر. مستندات این را با represent می‌گویند: «This class represents a user» یعنی هر شیء از این کلاس، یک کاربر است. «a string representing the date» یعنی رشته‌ای که تاریخ را نشان می‌دهد.

Each row represents one student in the class.

هر ردیف نشان‌دهنده‌ی یک دانش‌آموز کلاس است.

describe (دیسکرایب): توصیف کردن؛ شرح دادن

describe یعنی «گفتنِ این‌که چیزی چه شکلی است یا چطور کار می‌کند». مستندات درباره‌ی خودشان این فعل را زیاد به کار می‌برند: «This section describes how to…» یعنی «این بخش شرح می‌دهد چطور…». شکل مجهولش هم برای ارجاع می‌آید: «as described above» یعنی «همان‌طور که بالاتر گفته شد».

This page describes how to install the library.

این صفحه شرح می‌دهد چطور کتابخانه را نصب کنی.

indicate (ایندیکِیت): نشان دادن؛ خبر دادن از چیزی

indicate یعنی «نشانه‌ی چیزی بودن». چراغ راهنمای ماشین را indicator می‌گویند، چون نشان می‌دهد می‌خواهی کدام طرف بپیچی. در مستندات یعنی یک مقدار دارد خبری به تو می‌دهد: «A status code of 404 indicates that the page was not found». الگو: «X indicates that…» یا «X indicates whether…».

A return value of -1 indicates that the item was not found.

مقدار برگشتی ‎-1 نشان می‌دهد که آیتم پیدا نشده است.

refer to (ریفِر تو): اشاره کردن به؛ رجوع کردن به

refer to دو کاربرد دارد. اول «اشاره داشتن به»: «The name x refers to a list» یعنی اسم x به یک فهرست اشاره می‌کند. دوم «رجوع کردن به»: «Refer to the installation guide» یعنی برو راهنمای نصب را ببین. کلمه‌ی reference (مرجع) هم از همین فعل ساخته شده است.

For more details, refer to the API reference.

برای جزئیات بیشتر، به مرجع API رجوع کن.

depend on (دیپِند آن): وابسته بودن به؛ بستگی داشتن به

depend on یعنی «وابسته بودن به چیزی». در مستندات دو جا می‌آید. یکی برای بسته‌ها: «This package depends on NumPy» یعنی بدون NumPy کار نمی‌کند. دیگری برای نتیجه‌ها: «The result depends on the operating system» یعنی جواب روی هر سیستم‌عامل فرق می‌کند. جمله‌ی معروف «It depends» یعنی «بستگی دارد».

The output depends on the version of Python you use.

خروجی به نسخه‌ای از پایتون که استفاده می‌کنی بستگی دارد.

ماژول calendar

The calendar module provides functions for working with dates.

A Date object represents a single day. It contains three values: the year, the month and the day. You must specify all three when you create a date.

The weekday() method returns a number that indicates the day of the week: 0 is Monday.

The output of format() depends on the language of your system.

This page describes the basic functions only. For time zones, refer to the Time Zones guide.

ماژول calendar تابع‌هایی برای کار با تاریخ‌ها فراهم می‌کند.

یک شیء Date نشان‌دهنده‌ی یک روز است. سه مقدار در خود دارد: سال، ماه و روز. موقع ساختن یک تاریخ باید هر سه را مشخص کنی.

متد weekday()‎ عددی برمی‌گرداند که روز هفته را نشان می‌دهد: 0 یعنی دوشنبه.

خروجی format()‎ به زبان سیستم تو بستگی دارد.

این صفحه فقط تابع‌های پایه را شرح می‌دهد. برای منطقه‌های زمانی، به راهنمای Time Zones رجوع کن.