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

اصطلاح‌های تصویری

انگلیسی پر از عبارت‌هایی است که یک تصویر در دلشان دارند: کاپوت ماشین، جعبه، پوست گردو. مستندات و READMEها این‌ها را خیلی دوست دارند.

عبارت‌های ثابت را دست نزن

این عبارت‌ها مثل یک تکه‌ی یک‌پارچه‌اند: حرف اضافه و حرف تعریفشان عوض نمی‌شود. می‌گوییم under the hood، نه under a hood؛ in a nutshell، نه in the nutshell. پس آن‌ها را کلمه‌به‌کلمه یاد نگیر، کامل حفظ کن. بیشترشان اول جمله می‌آیند و بعدشان ویرگول است: Under the hood, it uses SQLite.

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

under the hood (آندِر دِ هود): زیر کاپوت؛ سازوکار درونی

hood در انگلیسی آمریکایی کاپوت ماشین است. راننده فقط فرمان و پدال را می‌بیند؛ موتور زیر کاپوت کار خودش را می‌کند. under the hood یعنی آن‌چه درون یک ابزار می‌گذرد و کاربرش لازم نیست ببیند. وقتی مستندات می‌گویند «زیر کاپوت از SQLite استفاده می‌کند»، دارند سازوکار داخلی را نشانت می‌دهند.

Under the hood, the library sends a normal HTTP request.

در پشت پرده، این کتابخانه یک درخواست HTTP معمولی می‌فرستد.

out of the box (اَوت آو دِ باکس): آماده‌ی کار، بدون تنظیم اضافه

box یعنی جعبه. تصورش کن: وسیله را از جعبه درمی‌آوری، روشن می‌کنی و کار می‌کند، بدون نصب و تنظیم. در نرم‌افزار یعنی قابلیتی که از همان اول و با تنظیمات پیش‌فرض آماده است. «این فریم‌ورک out of the box ورود کاربر دارد» یعنی لازم نیست خودت چیزی اضافه کنی.

The editor supports Python out of the box, with no plugins.

این ادیتور از همان اول و بدون هیچ افزونه‌ای از پایتون پشتیبانی می‌کند.

from scratch (فِرام اِسکِرَچ): از صفر؛ از هیچ

scratch یعنی خراش. در مسابقه‌های دوِ قدیم، خط شروع را با خراشیدن زمین می‌کشیدند و کسی که from scratch شروع می‌کرد هیچ امتیاز و جلوافتادنی نداشت. امروز یعنی ساختن چیزی از صفر، بدون قالب و کد آماده. «این بازی را from scratch نوشتم» یعنی خط اولش هم مال خودم است.

We rewrote the whole app from scratch in three months.

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

on the fly (آن دِ فلای): در لحظه؛ همان موقعِ کار

fly یعنی پرواز و on the fly یعنی «در حال پرواز»: کاری که بدون ایستادن و آماده‌سازی قبلی، همان لحظه انجام می‌شود. در برنامه‌نویسی یعنی چیزی که همان موقع اجرا ساخته یا عوض می‌شود، نه از پیش. مثلاً سروری که عکس را همان لحظه‌ی درخواست کوچک می‌کند، به جای این‌که نسخه‌ی کوچکش را از قبل نگه دارد.

The server resizes each image on the fly when it is requested.

سرور هر عکس را همان لحظه‌ای که درخواست می‌شود کوچک می‌کند.

in a nutshell (این اِ نات‌شِل): خلاصه‌اش این‌که؛ در یک کلام

nut یعنی آجیل و گردو و shell یعنی پوسته. nutshell پوست گردوست، جایی آن‌قدر کوچک که فقط چند کلمه در آن جا می‌شود. in a nutshell یعنی «اگر بخواهم همه را در پوست گردو جا بدهم»، همان «خلاصه‌اش این‌که». در مقدمه‌ی مستندات و آخر توضیح‌های بلند می‌آید.

In a nutshell, Git saves a snapshot of your project on every commit.

خلاصه‌اش این‌که گیت با هر commit یک عکس از پروژه‌ات نگه می‌دارد.

at a glance (اَت اِ گِلَنس): در یک نگاه

glance یعنی نگاه کوتاه و گذرا. at a glance یعنی چیزی که با همان یک نگاه دستت می‌آید و لازم نیست بخوانی و بگردی. داشبوردها برای همین ساخته می‌شوند: سبز یعنی همه‌چیز خوب است، قرمز یعنی یک جای کار می‌لنگد. در مستندات هم عنوان‌هایی مثل Features at a glance می‌بینی.

The dashboard shows the status of every server at a glance.

داشبورد وضعیت همه‌ی سرورها را در یک نگاه نشان می‌دهد.

behind the scenes (بیهایند دِ سینز): پشت صحنه

scene یعنی صحنه‌ی تئاتر. تماشاگر فقط بازیگرها را می‌بیند، ولی پشت پرده آدم‌هایی نور و دکور را جابه‌جا می‌کنند. behind the scenes یعنی کارهایی که برنامه بی‌سروصدا انجام می‌دهد و کاربر نمی‌بیند. معنایش به under the hood خیلی نزدیک است: آن یکی بیشتر درباره‌ی «چطور ساخته شده» است، این یکی درباره‌ی «چه کارهایی در جریان است».

Behind the scenes, the app saves your work every few seconds.

در پشت صحنه، برنامه هر چند ثانیه کار تو را ذخیره می‌کند.

up and running (آپ اَند رانینگ): راه افتاده و در حال کار

up یعنی بالا و روشن، running یعنی در حال اجرا. up and running یعنی چیزی نصب شده، روشن است و دارد درست کار می‌کند. راهنماها قول می‌دهند «در پنج دقیقه up and running می‌شوی»، و بعد از یک خرابی، بهترین خبر چت تیم این است: سرور دوباره up and running است.

The server is up and running again after the restart.

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

README یک ابزار کوچک

Tiny Server in a nutshell: one file, no setup, and your site is online.

It works out of the box. Run one command and you are up and running in a minute. The dashboard shows all requests at a glance.

Under the hood, Tiny Server uses Python's built-in HTTP module. Behind the scenes, it also compresses images on the fly, so pages load faster.

We wrote it from scratch for students, so the code is short and easy to read.

Tiny Server در یک کلام: یک فایل، بدون نصب و تنظیم، و سایتت روی خط است.

از همان اول آماده‌ی کار است. یک دستور را اجرا کن و در یک دقیقه همه‌چیز راه افتاده است. داشبورد همه‌ی درخواست‌ها را در یک نگاه نشان می‌دهد.

زیر کاپوت، Tiny Server از ماژول HTTP خودِ پایتون استفاده می‌کند. در پشت صحنه عکس‌ها را هم همان لحظه فشرده می‌کند تا صفحه‌ها زودتر باز شوند.

آن را از صفر برای دانش‌آموزها نوشته‌ایم، برای همین کدش کوتاه و خواندنش آسان است.