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

تنظیمات

برنامه‌ی خوب تنظیماتش را از کدش جدا نگه می‌دارد. این کلمه‌ها می‌گویند آن تنظیمات کجا نوشته می‌شوند و یک پروژه‌ی تازه چطور بدون شروع از صفر راه می‌افتد.

setup یا set up؟

بعضی جفت‌ها سرِ هم اسم‌اند و جدا فعل. «Set up the project» فعل است (راه‌اندازی کن) و «The setup is easy» اسم (راه‌اندازی). همین قاعده برای log in و login، back up و backup، check out و checkout هم هست. اگر می‌توانی قبلش the بگذاری، سرِ هم بنویس.

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

config (کانفیگ): پیکربندی؛ تنظیمات یک برنامه یا پروژه

config کوتاه‌شده‌ی configuration است، یعنی «پیکربندی»: این‌که اجزای یک چیز چطور چیده و تنظیم شده‌اند. در برنامه‌نویسی config یعنی تنظیماتی که بیرون از کد اصلی، معمولا در یک فایل جدا، نوشته می‌شود: برنامه روی کدام پورت باشد، به کدام پایگاه داده وصل شود. این‌طوری برای عوض کردن رفتار برنامه لازم نیست به کد دست بزنی.

Change the port number in the config file and restart the server.

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

settings (سِتینگز): تنظیمات

set یعنی «گذاشتن روی یک مقدار» و setting یعنی جایی که چیزی رویش گذاشته شده؛ مثل درجه‌ی کولر. settings (با s جمع) همان «تنظیمات» است: صفحه‌ای با آیکون چرخ‌دنده که در آن زبان، رنگ، اندازه‌ی قلم و چیزهای دیگر را انتخاب می‌کنی. settings و config یک چیز را می‌گویند؛ settings بیشتر برای صفحه‌ای است که کاربر می‌بیند و config برای فایلی که برنامه‌نویس می‌نویسد.

Open the editor settings and change the font size.

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

environment (اِنوایرِنمِنت): محیط؛ جایی که برنامه با همه‌ی ابزارهایش در آن اجرا می‌شود

environment یعنی «محیط»؛ محیط زیست هم همین کلمه است. در برنامه‌نویسی محیط یعنی همه‌ی چیزهایی که دور برنامه‌ی تو هستند و رویش اثر می‌گذارند: سیستم‌عامل، نسخه‌ی پایتون، کتابخانه‌های نصب‌شده، تنظیمات. برای همین است که یک برنامه روی لپ‌تاپ تو کار می‌کند و روی سرور نه. هر پروژه معمولا چند محیط دارد: development (روی کامپیوتر تو)، staging (آزمایشی) و production (واقعی).

Create a virtual environment before you install the packages.

قبل از نصب بسته‌ها یک محیط مجازی بساز.

environment variable (اِنوایرِنمِنت وَریِبِل): متغیر محیطی؛ مقداری که سیستم به برنامه می‌دهد

متغیری است که داخل کد تو تعریف نشده، بلکه در محیط (سیستم‌عامل یا سرور) گذاشته شده و برنامه موقع اجرا آن را می‌خواند. بهترین جا برای چیزهایی است که نباید در کد باشند، مثل کلید API و رمز پایگاه داده، یا چیزهایی که روی هر کامپیوتر فرق می‌کنند. اسمشان را طبق رسم با حروف بزرگ می‌نویسند.

Store your API key in an environment variable, not in the code.

کلید API را در یک متغیر محیطی نگه دار، نه در کد.

setup (سِت‌آپ): راه‌اندازی؛ آماده کردن همه‌چیز برای شروع کار

set up یعنی «برپا کردن»، مثل برپا کردن چادر. setup یعنی همه‌ی کارهایی که باید یک بار انجام بدهی تا چیزی آماده‌ی کار شود: نصب ابزارها، ساختن فایل تنظیمات، گرفتن کتابخانه‌ها. به چیدمان آماده‌شده هم setup می‌گویند: «my setup» یعنی میز کار و ابزارهای من.

The setup takes about five minutes on a new computer.

راه‌اندازی روی یک کامپیوتر تازه حدود پنج دقیقه طول می‌کشد.

template (تِمپلِت): قالب؛ الگوی آماده‌ای که جاهای خالی‌اش را پر می‌کنی

template در انگلیسی یعنی «الگو» یا «شابلون»: شکلی آماده که از رویش چیزهای مشابه می‌سازند. در کامپیوتر template چیزی است که اسکلتش آماده است و تو فقط جاهای خالی را پر می‌کنی: یک پروژه‌ی خالی آماده، یک فرم گزارش باگ، یا یک صفحه‌ی HTML که اسم کاربر بعدا در آن گذاشته می‌شود.

Start your project from a template to save time.

برای صرفه‌جویی در وقت، پروژه‌ات را از یک قالب شروع کن.

boilerplate (بویلِرپلِیت): کد تکراری و آماده که هر بار باید نوشته شود

boilerplate یک اصطلاح قدیمی روزنامه‌هاست: صفحه‌های فلزی آماده‌ای که متن‌های تکراری رویشان حک شده بود و بدون تغییر در همه‌ی روزنامه‌ها چاپ می‌شد. در برنامه‌نویسی یعنی کدی که تقریبا در هر پروژه یا هر فایل یک‌جور است و فکر نمی‌خواهد، ولی بدون آن چیزی کار نمی‌کند. مثل چند خط اول هر صفحه‌ی HTML.

This tool writes the boilerplate code for you.

این ابزار کد تکراری را برایت می‌نویسد.

preset (پری‌سِت): تنظیم آماده؛ دسته‌ای از تنظیمات از پیش چیده‌شده

pre- یعنی «از پیش» و set یعنی «تنظیم کردن»: از پیش تنظیم‌شده. preset یک بسته‌ی آماده از تنظیمات است که با یک انتخاب همه را با هم می‌گیری، مثل حالت «شب» یا «ورزشی» در دوربین گوشی. ابزارهای برنامه‌نویسی هم preset دارند تا لازم نباشد ده‌ها تنظیم را یکی‌یکی بنویسی.

Choose the recommended preset if you are not sure.

اگر مطمئن نیستی، تنظیم آماده‌ی پیشنهادشده را انتخاب کن.

بخش Setup یک README

Setup

This project was created from our web app template, so most of the boilerplate is already written for you.

1. Copy the file .env.example to .env.
2. Open .env and set the environment variable API_KEY to your own key. Never commit this file.
3. All other settings are in config.json. The default preset works well for a development environment.
4. Run npm install, then npm start.

The whole setup takes about five minutes.

راه‌اندازی

این پروژه از قالب برنامه‌ی وب ما ساخته شده است، پس بیشتر کدهای تکراری از قبل برایت نوشته شده.

۱. فایل ‎.env.example را به اسم ‎.env کپی کن.
۲. فایل ‎.env را باز کن و متغیر محیطی API_KEY را با کلید خودت پر کن. این فایل را هیچ‌وقت کامیت نکن.
۳. بقیه‌ی تنظیمات در config.json است. تنظیم آماده‌ی پیش‌فرض برای محیط توسعه خوب کار می‌کند.
۴. دستور npm install و بعد npm start را اجرا کن.

کل راه‌اندازی حدود پنج دقیقه طول می‌کشد.